---
title: "Route4Me MCP server for AI agents - actionlake"
description: "Give Claude 157 Route4Me actions through one MCP server: vehicles, addresses, routes, users. Your agent never holds the credential. 100,000 calls a month free."
canonical: https://actionlake.com/connectors/route4me
updated: 2026-10-23
---

Connectors · Commerce

# Route4Me MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Route4Me and the rest of your systems. It gives your agent 157 Route4Me actions (78 reads, 60 writes and 19 that wait for a confirmation) and holds the Route4Me credential itself, so the agent never does. It paces Route4Me's limits and records every call.

[Connect Route4Me free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing)

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

`claude mcp add --transport http actionlake https://connect.actionlake.com/mcp`

the first call

```
do {
  action: "route4me.users.list",
  intent: "check which Route4Me account is connected"
}
# List team members · read · 1 upstream call
```

- 157 actions in one signed file
- 78 read look, never change
- 60 write create and update
- 19 wait for a yes destructive, confirmed first

Set up

## Connect Route4Me in three steps.

1. 01
   ### Add actionlake to Claude.
   Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
   `https://connect.actionlake.com/mcp`
2. 02
   ### Connect Route4Me.
   API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
   - `api_key` Route4Me API key: in Route4Me open Settings > Organization Settings, then Integrations > API Key, and copy the key
   ```
   account { op: "connections.requirements", service: "route4me" }
   # free: exactly what to paste, and what is found for you
   ```
3. 03
   ### Make the first call. Check before a write.
   Ask in plain words; Claude picks the action. Before anything changes, `check` validates the call and prices it, for free.
   ```
   do    { action: "route4me.users.list" }
   # list team members · read · 1 upstream call
   check { action: "route4me.orders.create", input: { … } }
   # free: inputs, permissions, cost and confirmations, nothing sent
   ```

Route4Me at a glance

**Sign-in**

API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.

**You provide**

`api_key`

**Limits we pace to**

300 calls a minute, per connection

**API covered**

Route4Me API v5.0 (OpenAPI 3.0 fragments from the ReadMe reference)`wh.route4me.com/modules/api/v5.0`

**Built from**

Route4Me's documentation, read 23 October 2026[integrate.route4me.com](https://integrate.route4me.com/llms.txt) [integrate.route4me.com](https://integrate.route4me.com/reference)

**Service file**

Version 1.0.0, signed (Ed25519)

**Cached reads**

78 of 78 reads, for up to 5 minutes; a write clears what it affects

**Shared entities**

6, so ask can line Route4Me up with your other systems

**Data**

Processed and stored in Sydney, Australia. No US region yet

Capabilities

## What an AI agent can do in Route4Me.

157 actions in 22 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

- **78** read look, never change
- **60** write create and update
- **19** destructive wait for a confirmation

1. ### Vehicles
   22
   10 read · 10 write · 2 destructive
   List vehicles · Create a vehicle · Get a vehicle · Update a vehicle
2. ### Addresses
   19
   10 read · 7 write · 2 destructive
   List address book contacts · Create address book contacts in bulk · List address book contacts as clusters · Search address book contacts as clusters
3. ### Routes
   15
   7 read · 7 write · 1 destructive
   Preview a route assignment · Create a master route · Get a route's directions · List routes
4. ### Users
   14
   9 read · 3 write · 2 destructive
   List team members · Create a team member · Get a team member · Update a team member
5. ### Address groups
   10
   6 read · 3 write · 1 destructive
   Create an address book group · Filter addresses by group rules · List the addresses in an address book group · List the addresses in an address book group as clusters
6. ### Optimization profiles
   10
   5 read · 3 write · 2 destructive
   Create an optimization profile · Get optimization profile entities · Get the optimization profile entities template · List optimization profiles
7. ### Vehicle profiles
   8
   3 read · 3 write · 2 destructive
   Create a vehicle profile · List vehicle profiles · Get a vehicle profile · Get a vehicle profile by code
8. ### Member settings
   6
   2 read · 3 write · 1 destructive
   Get member configuration settings in bulk · Create a member configuration setting · List member configuration settings · Set member configuration settings in bulk

**14 more areas · 53 actions**

- Orders **6**
- Customers **5**
- Facilities **5**
- Location types **5**
- Locations **5**
- Telematics connections **5**
- Facility custom data **4**
- Order custom fields **4**
- Geocoding **3**
- Vehicle capacity profiles **3**
- Destinations **2**
- Facility types **2**
- Route settings **2**
- Temporal access **2**

Top actions

## The Route4Me API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 21 of Route4Me's 21 action names are shared with at least one other connector, so an agent learns them once.

| Action | What it does | Effect | Same name in |
| --- | --- | --- | --- |
| `route4me.users.list` List team members | List team members. | read | `identity.user.list` 474 connectors |
| `route4me.orders.list` List orders | List orders. | read | `commerce.order.list` 82 connectors |
| `route4me.customers.list` List customers | List customers. | read | `commerce.customer.list` 45 connectors |
| `route4me.orders.create` Create an order | Create an order. | write | `commerce.order.create` 67 connectors |
| `route4me.users.create` Create a team member | Create a team member. | write | `identity.user.create` 262 connectors |
| `route4me.customers.create` Create a customer | Create a customer. | write | `commerce.customer.create` 43 connectors |
| `route4me.addresses.list` List address book contacts | List address book contacts. | read | `crm.location.list` 48 connectors |
| `route4me.vehicles.list` List vehicles | List vehicles. | read | `asset.asset.list` 42 connectors |
| `route4me.users.delete` Delete a team member | Delete a team member. | destructive | `identity.user.delete` 253 connectors |
| `route4me.users.territories` List the member's territories | List the member's territories. | read | `crm.territory.list` 10 connectors |
| `route4me.users.me` Get the current member | Get the current member. | read | `identity.current_user.get` 307 connectors |
| `route4me.vehicles.create` Create a vehicle | Create a vehicle. | write | `asset.asset.create` 27 connectors |

Try it

## Prompts to paste into Claude.

Each one names the Route4Me actions it will call, so you know what it reads and what it changes before you send it.

1. Read read
   Which Route4Me orders from the last seven days are still unfulfilled?
   calls `route4me.orders.list`
2. Write write
   Create an order in Route4Me. Show me exactly what you will send before you save it.
   calls `route4me.orders.create`

Governance for Route4Me

## Destructive actions wait for a yes.

19 Route4Me actions are destructive. These are all of them:

- Delete a team member `route4me.users.delete`
- Delete a customer `route4me.customers.delete`
- Delete a vehicle `route4me.vehicles.delete`
- Delete a facility `route4me.facilities.delete`
- Delete routes by filters `route4me.routes.delete_many`
- Delete the current user `route4me.users.terminate_self`
- Delete vehicles in bulk `route4me.vehicles.bulk_delete`
- Delete an address book group `route4me.address_groups.delete`
- Delete address book contacts by ID `route4me.addresses.delete_many`
- Delete a location type `route4me.location_types.delete`
- Delete a member configuration setting `route4me.member_settings.delete`
- Delete a vehicle profile `route4me.vehicle_profiles.delete`
- Delete address book contacts in selected areas `route4me.addresses.delete_by_areas`
- Delete an order custom field `route4me.order_custom_fields.delete`
- Delete an optimization profile `route4me.optimization_profiles.delete`
- Delete a telematics connection `route4me.telematics_connections.delete`
- Delete vehicle profiles by code `route4me.vehicle_profiles.delete_by_code`
- Delete a vehicle capacity profile `route4me.vehicle_capacity_profiles.delete`
- Delete optimization profile entities `route4me.optimization_profiles.delete_entities`

A destructive action runs only with `confirm: true`. Under the `human` policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

do route4me.users.delete confirm_policy: **human**

Delete a team member?

**intent:** the user asked me to delete a team member

run suspended · waiting for a named person · key _route4me-agent_ cannot confirm itself

In the console, or from an emailed signed link.

a key for this connector

```
account {
  op: "keys.create", name: "route4me-agent",
  allowed_actions: ["route4me.*"], cap_calls: 2000,
  confirm_policy: "human_for_writes",
  approval_rules: [
    { match: "route4me.users.delete", approver: "lead@example.com" },
    { match: "route4me.customers.delete", approver: "lead@example.com" },
    { match: "route4me.vehicles.delete", approver: "lead@example.com" }
  ]
}
```

Illustrative. Scoped to Route4Me only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

## What Route4Me costs on actionlake.

Every Route4Me action is one upstream call, the only thing actionlake bills. Searching, `check`, `cost`, `account` and any call Route4Me refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

- 1 upstream call per action all 157 Route4Me actions
- 157 actions page each page of a long list is one call
- 78 reads can be cached a cache hit costs nothing
- 100,000 calls a month, free paid plans from US$49 a month for 250,000

[See pricing](https://actionlake.com/pricing)

Action index

## Every Route4Me action.

157 actions by area: the id your agent calls, what it does, and its effect.

**Vehicles 22**

- `route4me.vehicles.bulk_activate` Activate vehicles in bulk write
- `route4me.vehicles.bulk_deactivate` Deactivate vehicles in bulk write
- `route4me.vehicles.bulk_delete` Delete vehicles in bulk destructive
- `route4me.vehicles.bulk_restore` Restore vehicles in bulk write
- `route4me.vehicles.bulk_update` Update vehicles in bulk write
- `route4me.vehicles.confirm_route` Track a vehicle route confirmation write
- `route4me.vehicles.create` Create a vehicle write
- `route4me.vehicles.create_temporary` Create a temporary vehicle write
- `route4me.vehicles.delete` Delete a vehicle destructive
- `route4me.vehicles.execute_order` Execute an order with a vehicle write
- `route4me.vehicles.execute_order_by_location` Execute an order by vehicle location read
- `route4me.vehicles.get` Get a vehicle read
- `route4me.vehicles.get_by_license_plate` Get a vehicle by license plate read
- `route4me.vehicles.list` List vehicles read
- `route4me.vehicles.list_paginated` List vehicles (paginated) read
- `route4me.vehicles.locations` Get vehicles' latest locations read
- `route4me.vehicles.route_confirmation` Get a vehicle route confirmation read
- `route4me.vehicles.search` Search vehicles read
- `route4me.vehicles.search_by_location` Search vehicles near a location read
- `route4me.vehicles.sync_pending` Sync a pending vehicle from telematics write
- `route4me.vehicles.track` Get a vehicle's track read
- `route4me.vehicles.update` Update a vehicle write

**Addresses 19**

- `route4me.addresses.batch_create` Create address book contacts in bulk write
- `route4me.addresses.batch_update` Update address book contacts in bulk write
- `route4me.addresses.batch_update_async` Update address book contacts in bulk (asynchronous) write
- `route4me.addresses.clusters` List address book contacts as clusters read
- `route4me.addresses.clusters_search` Search address book contacts as clusters read
- `route4me.addresses.create` Create an address book contact write
- `route4me.addresses.create_orders` Create orders from address book contacts write
- `route4me.addresses.custom_fields` List address book custom fields read
- `route4me.addresses.delete_by_areas` Delete address book contacts in selected areas destructive
- `route4me.addresses.delete_many` Delete address book contacts by ID destructive
- `route4me.addresses.depots` List depot addresses read
- `route4me.addresses.get` Get an address book contact read
- `route4me.addresses.get_many` Get address book contacts by ID read
- `route4me.addresses.list` List address book contacts read
- `route4me.addresses.list_paginated` List address book contacts (paginated) read
- `route4me.addresses.search` Search address book contacts read
- `route4me.addresses.search_paginated` Search address book contacts (one page) read
- `route4me.addresses.update` Update an address book contact write
- `route4me.addresses.update_by_areas` Update address book contacts in selected areas write

**Routes 15**

- `route4me.routes.assign_facility` Assign routes to facilities write
- `route4me.routes.assign_preview` Preview a route assignment read
- `route4me.routes.bulk_update` Assign drivers, vehicles or settings to routes write
- `route4me.routes.bulk_update_collection` Update a collection of routes write
- `route4me.routes.create_master` Create a master route write
- `route4me.routes.delete_many` Delete routes by filters destructive
- `route4me.routes.directions` Get a route's directions read
- `route4me.routes.dispatch` Dispatch routes write
- `route4me.routes.get` Get a route read
- `route4me.routes.last_for_member` Get a member's latest scheduled route read
- `route4me.routes.last_for_vehicle` Get a vehicle's latest scheduled route read
- `route4me.routes.list` List routes read
- `route4me.routes.lookup_for_new_destination` Find the best routes to insert a new destination read
- `route4me.routes.lookup_for_new_destination_async` Start an asynchronous lookup for a new destination write
- `route4me.routes.rate` Set a route's rating write

**Users 14**

- `route4me.users.bulk_create` Create team members in bulk write
- `route4me.users.create` Create a team member write
- `route4me.users.delete` Delete a team member destructive
- `route4me.users.get` Get a team member read
- `route4me.users.get_many` Get team members by ID read
- `route4me.users.history` Get a team member's modification history read
- `route4me.users.list` List team members read
- `route4me.users.list_paginated` List team members (paginated) read
- `route4me.users.me` Get the current member read
- `route4me.users.support_root_members` List root members (customer support users) read
- `route4me.users.template` Get the team member template read
- `route4me.users.terminate_self` Delete the current user destructive
- `route4me.users.territories` List the member's territories read
- `route4me.users.update` Update a team member write

**Address groups 10**

- `route4me.address_groups.create` Create an address book group write
- `route4me.address_groups.delete` Delete an address book group destructive
- `route4me.address_groups.filter` Filter addresses by group rules read
- `route4me.address_groups.filter_by_group` List the addresses in an address book group read
- `route4me.address_groups.filter_by_group_clusters` List the addresses in an address book group as clusters read
- `route4me.address_groups.filter_clusters` Filter addresses by group rules as clusters read
- `route4me.address_groups.get` Get an address book group read
- `route4me.address_groups.list` List address book groups read
- `route4me.address_groups.set_positions` Set address book group sort order write
- `route4me.address_groups.update` Update an address book group write

**Optimization profiles 10**

- `route4me.optimization_profiles.create` Create an optimization profile write
- `route4me.optimization_profiles.delete` Delete an optimization profile destructive
- `route4me.optimization_profiles.delete_entities` Delete optimization profile entities destructive
- `route4me.optimization_profiles.get` Get an optimization profile read
- `route4me.optimization_profiles.get_entities` Get optimization profile entities read
- `route4me.optimization_profiles.get_entities_template` Get the optimization profile entities template read
- `route4me.optimization_profiles.list` List optimization profiles read
- `route4me.optimization_profiles.save_entities` Save optimization profile entities write
- `route4me.optimization_profiles.search` Search optimization profiles read
- `route4me.optimization_profiles.update` Update an optimization profile write

**Vehicle profiles 8**

- `route4me.vehicle_profiles.create` Create a vehicle profile write
- `route4me.vehicle_profiles.delete` Delete a vehicle profile destructive
- `route4me.vehicle_profiles.delete_by_code` Delete vehicle profiles by code destructive
- `route4me.vehicle_profiles.get` Get a vehicle profile read
- `route4me.vehicle_profiles.get_by_code` Get a vehicle profile by code read
- `route4me.vehicle_profiles.list` List vehicle profiles read
- `route4me.vehicle_profiles.update` Update a vehicle profile write
- `route4me.vehicle_profiles.update_by_code` Update a vehicle profile by code write

**Member settings 6**

- `route4me.member_settings.bulk_get` Get member configuration settings in bulk read
- `route4me.member_settings.bulk_set` Set member configuration settings in bulk write
- `route4me.member_settings.create` Create a member configuration setting write
- `route4me.member_settings.delete` Delete a member configuration setting destructive
- `route4me.member_settings.list` List member configuration settings read
- `route4me.member_settings.update` Update a member configuration setting write

**Orders 6**

- `route4me.orders.create` Create an order write
- `route4me.orders.history` Get an order's history read
- `route4me.orders.list` List orders read
- `route4me.orders.list_archived` List archived orders read
- `route4me.orders.simple_history` Get an order's simple history read
- `route4me.orders.update` Update an order write

**Customers 5**

- `route4me.customers.create` Create a customer write
- `route4me.customers.delete` Delete a customer destructive
- `route4me.customers.get` Get a customer read
- `route4me.customers.list` List customers read
- `route4me.customers.update` Update a customer write

**Facilities 5**

- `route4me.facilities.create` Create a facility write
- `route4me.facilities.delete` Delete a facility destructive
- `route4me.facilities.get` Get a facility read
- `route4me.facilities.list` List facilities read
- `route4me.facilities.update` Update a facility write

**Location types 5**

- `route4me.location_types.create` Create a location type write
- `route4me.location_types.delete` Delete a location type destructive
- `route4me.location_types.get` Get a location type read
- `route4me.location_types.list` List location types read
- `route4me.location_types.update` Update a location type write

**Locations 5**

- `route4me.locations.clusters` Get clustered locations read
- `route4me.locations.heatmap` Get a location heat map read
- `route4me.locations.list` List locations read
- `route4me.locations.service_time_heatmap` Get a location service-time heat map read
- `route4me.locations.territories` List territories with location counts read

**Telematics connections 5**

- `route4me.telematics_connections.create` Create a telematics connection write
- `route4me.telematics_connections.delete` Delete a telematics connection destructive
- `route4me.telematics_connections.list` List telematics connections read
- `route4me.telematics_connections.patch` Partially update a telematics connection write
- `route4me.telematics_connections.update` Update a telematics connection write

**Facility custom data 4**

- `route4me.facility_custom_data.bulk_get` Get custom data for several facilities read
- `route4me.facility_custom_data.bulk_update` Update facility custom data in bulk write
- `route4me.facility_custom_data.get` Get a facility's custom data read
- `route4me.facility_custom_data.update` Update a facility's custom data write

**Order custom fields 4**

- `route4me.order_custom_fields.create` Create an order custom field write
- `route4me.order_custom_fields.delete` Delete an order custom field destructive
- `route4me.order_custom_fields.list` List order custom fields read
- `route4me.order_custom_fields.update` Update an order custom field write

**Geocoding 3**

- `route4me.geocoding.bulk` Geocode addresses in bulk read
- `route4me.geocoding.forward` Geocode an address read
- `route4me.geocoding.reverse` Reverse geocode coordinates read

**Vehicle capacity profiles 3**

- `route4me.vehicle_capacity_profiles.delete` Delete a vehicle capacity profile destructive
- `route4me.vehicle_capacity_profiles.get` Get a vehicle capacity profile read
- `route4me.vehicle_capacity_profiles.update` Update a vehicle capacity profile write

**Destinations 2**

- `route4me.destinations.deliver` Record destination inventory delivery write
- `route4me.destinations.deliver_by_barcode` Record destination inventory delivery by barcode write

**Facility types 2**

- `route4me.facility_types.get` Get a facility type read
- `route4me.facility_types.list` List facility types read

**Route settings 2**

- `route4me.route_settings.get` Get a route's settings read
- `route4me.route_settings.update` Update a route's settings write

**Temporal access 2**

- `route4me.temporal_access.create` Create a temporal access address write
- `route4me.temporal_access.create_async` Create temporal access addresses (asynchronous) write

Questions

## The Route4Me MCP server, answered.

**Is there a Route4Me MCP server for Claude?**

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 157 Route4Me actions across vehicles, addresses, routes and users, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Route4Me.

**What do I need to connect Route4Me?**

Route4Me API key: in Route4Me open Settings > Organization Settings, then Integrations > API Key, and copy the key. The free call account { op: "connections.requirements", service: "route4me" } lists exactly what to paste.

**Can an AI agent delete or change things in Route4Me?**

Only if its key allows it, and only with an explicit confirmation. 19 Route4Me actions are destructive, including delete a team member, delete a customer and delete a vehicle. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

**Will an AI agent use up my Route4Me API limit?**

actionlake paces every call to the limits in the Route4Me service file: 300 calls a minute per connection. Repeated reads are answered from cache (78 Route4Me actions can be), which never reaches Route4Me.

**What does a Route4Me action cost?**

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (157 Route4Me actions page). Cache hits, searches, dry runs and calls Route4Me refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

**Which Route4Me API does it cover?**

The Route4Me API v5.0 (OpenAPI 3.0 fragments from the ReadMe reference) at wh.route4me.com/modules/api/v5.0. It is built from Route4Me's documentation as read on 23 October 2026. 157 actions in 22 areas, each one in the signed service file (version 1.0.0).

**Does actionlake keep my Route4Me data, and where?**

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Route4Me credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

**Which AI clients can use it?**

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

## More connectors like Route4Me

Shares the most action names with

- [EasyPost 7](https://actionlake.com/connectors/easypost)
- [Sellercloud 7](https://actionlake.com/connectors/sellercloud)
- [ShipHero 7](https://actionlake.com/connectors/shiphero)
- [Duffel Flights & Stays 6](https://actionlake.com/connectors/duffel-flights-and-stays)
- [Thinkific 6](https://actionlake.com/connectors/thinkific)
- [Maropost Commerce Cloud (Neto) 6](https://actionlake.com/connectors/maropost-commerce-cloud-neto)

Joins with, on shared entities

- [HaloPSA 4](https://actionlake.com/connectors/halopsa)
- [ERPNext (Frappe) 4](https://actionlake.com/connectors/erpnext-frappe)
- [ScalePad 4](https://actionlake.com/connectors/scalepad)
- [ServiceNow 3](https://actionlake.com/connectors/servicenow)
- [NetBox 3](https://actionlake.com/connectors/netbox)
- [Juniper Mist Cloud API 3](https://actionlake.com/connectors/juniper-mist-cloud-api)

Browse

- [All Commerce connectors](https://actionlake.com/connectors/category/commerce)
- [All connectors](https://actionlake.com/connectors)
- [How actionlake compares](https://actionlake.com/compare)

actionlake is independent. It is not made or endorsed by Route4Me; the name is the vendor's own. Counts are from the Route4Me service file, version 1.0.0.

## Give your agent Route4Me today.

[Connect Route4Me free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing)

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.

---

Source: https://actionlake.com/connectors/route4me
More: https://actionlake.com/llms.txt
