Route4Me integration
Route4Me plans and runs delivery and field service routes. Create and re-run route optimizations from a list of stops, list, read, update, dispatch and rate routes, manage the address book (contacts, groups, locations, territories), orders and their custom fields, customers, facilities, vehicles, vehicle profiles, optimization profiles and team members, geocode addresses, and record inventory deliveries at stops. Left out: sign-in and registration, member configuration settings (they need a session token and an organization key together), telematics vendor connections (they carry the vendor's credentials), account termination, deleting routes by filter (needs a request signature), and a few routes the vendor documents too thinly to call safely. Authentication is the Route4Me API key sent as the api_key query parameter.
Say what should happen.
The workflow builds itself.
What you can do with Route4Me
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Type, 6 operations
create_location_typeCreate location typePOSTCreates a location type in the account.delete_location_typeDelete location typeDELETEPermanently deletes a location type. Irreversible.get_facility_typeGet facility typeGETReturns one facility type by id.get_location_typeGet location typeGETReturns one location type by id.list_facility_typesList facility typesGETLists the facility types available in the account.list_location_typesList location typesGETLists the location types defined in the account (for example parent and child location types).
Clustering, 5 operations
filter_and_clusterFilter and clusterPOSTFilters the address book contacts by group rules sent in the body and returns them grouped into map clusters, with options for which addresses to show and the cluster precision.filter_by_group_id_and_clusterFilter by group id and clusterPOSTFilter ad Cluster the Address Book Contacts by sending the corresponding body payload and by specifying the 'display', 'group_id' and 'precision' query parameters.get_address_clustersGet address clustersGETGet the Address clusters filtered by the corresponding query text, and with the option to filter the result by the 'routed' and 'unrouted' state.get_address_clusters_by_bodyGet address clusters by bodyPOSTGet the Address clusters by sending the corresponding body payload.get_clustered_locationsGet clustered locationsPOSTReturns the address book locations grouped into map clusters, with the filters sent.
List, 5 operations
list_customersList customersPOSTLists customers, with filtering, sorting and pagination sent in the body.list_locationsList locationsPOSTLists address book locations, with filtering and pagination sent in the body.list_ordersList ordersPOSTLists orders, with filtering, sorting, search and pagination sent in the body.list_routesList routesPOSTLists routes with filtering (in filters: route ids, vehicles, members, dates, status and more), sorting and pagination sent in the body. Route costs are returned, but the members' pay rates they may be computed from are not.search_optimization_profilesSearch optimization profilesPOSTSearches optimization profiles, with the criteria sent in the body.
All, 4 operations
filter_and_listFilter and listPOSTFilter the Address Book Contacts by the Address Book Group rules by sending the corresponding body payload with the option to filter the Contacts by 'Routed' or 'Unrouted'.filter_by_group_id_and_listFilter by group id and listPOSTFilter the Address Book Contacts by sending the corresponding body payload and by specifying the 'display' and 'group_id' query parameters.list_addressesList addressesGETGet all Addresses filtered by specifying the corresponding query parameters.search_addressesSearch addressesPOSTGet all Addresses filtered and sorted by sending the corresponding body payload, with the option to search by the specified areas.
Bulk, 4 operations
bulk_geocodeBulk geocodePOSTGeocodes several addresses (free-text strings) in one call and returns their coordinates.bulk_update_facility_custom_dataBulk update facility custom dataPUTUpdates the custom data of several facilities at once.get_facilities_custom_dataGet facilities custom dataPOSTReturns the custom data of the listed facilities.list_users_by_idsList users by idsPOSTReturns the sub-users with the listed member ids. Pay rates (DriverHourlyRate, driving_rate, working_rate, mile_rate, idling_rate) are not returned; set them with create_user or update_user.
Custom field, 4 operations
create_custom_fieldCreate custom fieldPOSTCreates an order custom field definition.delete_custom_fieldDelete custom fieldDELETEPermanently deletes an order custom field definition. Irreversible.get_address_custom_fieldsGet address custom fieldsGETGet all Address custom fields.get_custom_fieldsGet custom fieldsGETGet all Order Custom Fields.
Facility, 4 operations
create_facilityCreate facilityPOSTCreates a facility (a depot, warehouse or similar site) with its address, coordinates and facility types.delete_facilityDelete facilityDELETEPermanently deletes a facility. Irreversible.get_facilityGet facilityGETReturns one facility by id.list_facilitiesList facilitiesGETLists the facilities (depots, warehouses and similar sites) of the account, with pagination.
Group, 4 operations
create_groupCreate groupPOSTCreates an address book group, a saved set of filter rules that selects contacts.delete_groupDelete groupDELETEPermanently deletes an address book group (the contacts themselves are kept). Irreversible.get_groupGet groupGETFind the Address Book Group by specifying the 'group' path parameter.list_groupsList groupsGETGet all Address Book Groups.
Optimization problem, 4 operations
create_optimizationCreate optimizationPOSTCreates and solves an optimization problem: send stops (addresses) and route parameters, and Route4Me plans and stores one or more routes. Route costs are returned, members' pay rates are not.delete_optimizationDelete optimizationDELETEPermanently deletes the listed optimization problems from the account. Irreversible.list_optimizationsList optimizationsGETLists optimization problems (by state, dates, limit, offset), or returns one by optimization_problem_id, with its addresses, parameters and routes. Route costs are returned, members' pay rates are not.rerun_optimizationRerun optimizationPUTRe-optimizes an existing optimization problem with changed route parameters and/or addresses, replacing its planned routes. Route costs are returned, but the members' pay rates they may be computed from are not.
Optimization profile, 4 operations
create_optimization_profileCreate optimization profilePOSTCreates an optimization profile, a saved set of route planning settings.delete_optimization_profileDelete optimization profileDELETEPermanently deletes an optimization profile. Irreversible.get_optimization_profileGet optimization profileGETGet Optimization Profile by id.list_optimization_profilesList optimization profilesGETGet Optimization Profiles.
User, 4 operations
create_userCreate userPOSTCreates a sub-user (team member) in the account. Pay rates (DriverHourlyRate, driving_rate, working_rate, mile_rate, idling_rate) are not returned; they can still be set with this tool.delete_userDelete userDELETEPermanently deletes a sub-user (team member) from the account. Irreversible. Pay rates (DriverHourlyRate, driving_rate, working_rate, mile_rate, idling_rate) are not returned.get_userGet userGETReturns one sub-user (team member) by id. Pay rates (DriverHourlyRate, driving_rate, working_rate, mile_rate, idling_rate) are not returned; set them with create_user or update_user.list_usersList usersGETLists the sub-users (team members) of the account. Pay rates (DriverHourlyRate, driving_rate, working_rate, mile_rate, idling_rate) are not returned; set them with create_user or update_user.
Vehicle, 4 operations
create_vehicleCreate vehiclePOSTCreates a vehicle in the account.delete_vehicleDelete vehicleDELETEDeletes a vehicle from the account.get_vehicleGet vehicleGETGet the Vehicle by specifying the path parameter ID.list_vehiclesList vehiclesGETGet the paginated list of Vehicles.
Vehicle profile, 4 operations
create_vehicle_profileCreate vehicle profilePOSTCreates a vehicle profile (dimensions, weights, fuel and routing restrictions shared by vehicles).delete_vehicle_profileDelete vehicle profileDELETEPermanently deletes a vehicle profile identified by id. Irreversible.get_vehicle_profileGet vehicle profileGETGet the Vehicle Profile by specifying the path parameter ID.list_vehicle_profilesList vehicle profilesGETGet the list of Vehicle Profiles.
Customer, 3 operations
create_customerCreate customerPOSTCreates a customer record in the account.delete_customerDelete customerDELETEPermanently deletes a customer record. Irreversible.get_customerGet customerGETReturns one customer by id, with its contacts, facilities and custom data.
Address, 2 operations
create_addressCreate addressPOSTAdds a contact (address) to the Route4Me address book.update_addressUpdate addressPUTUpdates one address book contact with the values sent.
Code, 2 operations
delete_vehicle_profiles_by_codeDelete vehicle profiles by codeDELETEPermanently deletes the vehicle profiles with the given code. Irreversible.get_vehicle_profile_by_codeGet vehicle profile by codeGETGet the Vehicle Profile by specifying vehicle profile code.
Delete, 2 operations
delete_addressesDelete addressesDELETEPermanently deletes the listed address book contacts. Irreversible.delete_vehiclesDelete vehiclesPOSTDeletes the listed vehicles, processed in the background by Route4Me.
Heatmap, 2 operations
get_location_heatmapGet location heatmapPOSTReturns a heat map of the address book locations matching the filters.get_location_service_time_heatmapGet location service time heatmapPOSTReturns a heat map of service times at the address book locations matching the filters.
History, 2 operations
get_order_historyGet order historyGETDisplay the order history.get_user_modification_historyGet user modification historyGETReturns the modification history of team members.
Order, 2 operations
create_orderCreate orderPOSTCreates an order (a stop to be scheduled and routed later).create_orders_from_contactsCreate orders from contactsPOSTCreates orders, scheduled for scheduled_for_date (a Y-m-d date), from the listed address book contacts.
Paginate, 2 operations
list_users_paginatedList users paginatedGETLists the members of the account with pagination. Pay rates (DriverHourlyRate, driving_rate, working_rate, mile_rate, idling_rate) are not returned; set them with create_user or update_user.list_vehicles_paginatedList vehicles paginatedGETGet the paginated list of Vehicles.
Pagination, 2 operations
list_addresses_paginatedList addresses paginatedGETGet a paginated list of all Addresses.search_addresses_paginatedSearch addresses paginatedPOSTGet the paginated list of all Addresses filtered and sorted by sending the corresponding body payload, with the option to search by the specified areas.
Search, 2 operations
search_vehicleSearch vehiclePOSTSearches the listed vehicles around a point (lat, lng) and returns a vehicle with its live position and its distance from that point.search_vehicle_by_locationSearch vehicle by locationGETSearches the listed vehicles around a point (lat, lng, criteria in the query) and returns a vehicle with its live position and its distance from that point.
Show, 2 operations
get_addressGet addressGETFind an Address by sending the 'address_id' query parameter.get_addressesGet addressesPOSTFind multiple Addresses by sending a body payload with the array of the corresponding Address IDs.
Territory, 2 operations
get_territories_with_location_countsGet territories with location countsPOSTReturns territories with the number of address book locations in each.list_member_territoriesList member territoriesGETLists the territories assigned to members.
Vehicle capacity profile, 2 operations
delete_vehicle_capacity_profileDelete vehicle capacity profileDELETEPermanently deletes a vehicle capacity profile. Irreversible.get_vehicle_capacity_profileGet vehicle capacity profileGETReturns one vehicle capacity profile (maximum weight, volume, revenue and items) by id.
Activate, 1 operation
activate_vehiclesActivate vehiclesPOSTActivates the listed vehicles, processed in the background by Route4Me.
Archive, 1 operation
list_archive_ordersList archive ordersPOSTDisplay the Archive Orders.
Assign, 1 operation
create_temporary_vehicleCreate temporary vehiclePOSTAssigns a vehicle to a member (assigned_member_id) until expires_at.
Assign facility, 1 operation
assign_routes_to_facilitiesAssign routes to facilitiesPOSTAssigns the facilities listed in facility_ids to every route matching the filters. Changes many routes at once.
Assign preview, 1 operation
preview_route_assignmentPreview route assignmentPOSTPreviews (without saving) how routes matching the filters would be assigned to the listed members, vehicles or facilities with the chosen strategy. Route costs are returned, but the members' pay rates they may be computed from are not.
Batch create, 1 operation
create_addressesCreate addressesPOSTAdds several contacts to the address book in one call.
Batch update, 1 operation
update_addressesUpdate addressesPUTUpdates several address book contacts at once: the addresses listed by id get the values sent.
Bulk insert, 1 operation
create_usersCreate usersPOSTCreates several sub-users (team members) at once.
Custom data, 1 operation
get_facility_custom_dataGet facility custom dataGETReturns the custom data of one facility.
Deactivate, 1 operation
deactivate_vehiclesDeactivate vehiclesPOSTDeactivates the listed vehicles, processed in the background by Route4Me.
Delete by area, 1 operation
delete_addresses_selected_areasDelete addresses selected areasDELETEPermanently deletes every address book contact located in the selected areas. Irreversible and can remove many contacts.
Delete entity, 1 operation
delete_optimization_profilesDelete optimization profilesPOSTPermanently deletes the listed optimization profile entities. Irreversible.
Deliver, 1 operation
deliver_destination_inventoryDeliver destination inventoryPOSTRecords the delivery of an inventory item at a route stop (planned and delivered quantities, final price).
Deliver barcode, 1 operation
deliver_destination_inventory_barcodeDeliver destination inventory barcodePOSTRecords the delivery of inventory at a route stop, identifying the item by its barcode.
Depot, 1 operation
get_depots_addressesGet depots addressesGETLists the address book contacts marked as depots (route start or end locations).
Direction, 1 operation
list_route_directionsList route directionsGETReturns the turn-by-turn directions of a route, paged with cursor and limit (1 to 300).
Dispatch, 1 operation
dispatch_routesDispatch routesPOSTApproves (approved_for_execution true) or revokes (false) the routes matching the filters for execution by drivers.
Forward, 1 operation
forward_geocodeForward geocodePOSTGeocodes one address into coordinates (the same as basic geocoding).
Get entities template, 1 operation
get_optimization_profiles_templateGet optimization profiles templatePOSTReturns the template (default values) of optimization profile entities.
Get entity, 1 operation
get_optimization_profilesGet optimization profilesPOSTReturns optimization profile entities.
License, 1 operation
get_vehicle_profile_by_license_plateGet vehicle profile by license plateGETReturns the vehicle data stored for a license plate.
Location, 1 operation
get_latest_vehicle_locationsGet latest vehicle locationsGETReturns the latest known live position (lat, lng and time) of each listed vehicle, as reported by its driver's device or telematics: this is where the vehicle, and so its driver, is now.
Lookup for new destination, 1 operation
lookup_for_new_destinationLookup for new destinationPOSTFinds the best positions to insert a new destination into existing routes and returns the candidate insertions. Changes nothing.
Master route, 1 operation
create_master_routeCreate master routePOSTCreates a master route from the addresses and route parameters sent.
Me, 1 operation
get_member_informationGet member informationGETReturns the member (user) the API key belongs to. Pay rates (DriverHourlyRate, driving_rate, working_rate, mile_rate, idling_rate) are not returned; set them with create_user or update_user.
Member route, 1 operation
get_last_scheduled_route_memberGet last scheduled route memberGETReturns the last route scheduled up to today for a member. Route costs are returned, but the members' pay rates they may be computed from are not.
Rating, 1 operation
set_route_ratingSet route ratingPOSTSets the rating of a route.
Restore, 1 operation
restore_vehiclesRestore vehiclesPOSTRestores the listed deleted vehicles, processed in the background by Route4Me.
Reverse, 1 operation
reverse_geocodeReverse geocodePOSTReturns the address found at the given coordinates.
Route, 1 operation
get_routeGet routeGETReturns one route by id with its stops, parameters, path and statistics. Route costs are returned, but the members' pay rates they may be computed from are not.
Settings, 1 operation
get_route_settingsGet route settingsGETReturns the settings of a route (driver, vehicle, travel mode, avoidance and timing options).
Simple history, 1 operation
get_simple_order_historyGet simple order historyGETDisplay the simple order history.
Store async, 1 operation
create_temporal_access_addresses_asyncCreate temporal access addresses asyncPOSTTemporarily gives the addresses that match the filters to another member until the expiry, processed in the background by Route4Me.
Template, 1 operation
get_user_templateGet user templateGETReturns the template (default values) of a new sub-user. Pay rates (DriverHourlyRate, driving_rate, working_rate, mile_rate, idling_rate) are not returned; set them with create_user or update_user.
Temporal access, 1 operation
create_temporal_access_addressCreate temporal access addressPOSTTemporarily gives the listed addresses to another member (new_member_id) until expires_at; mode decides what happens then (return_to_original or assign_to_team_owner).
Track, 1 operation
get_vehicle_trackGet vehicle trackGETReturns the recorded position track of a vehicle (lat, lng, altitude, speed and time of each point, with the route and member it was on), optionally between start and end: the path its driver actually drove.
Vehicle route, 1 operation
get_last_scheduled_route_vehicleGet last scheduled route vehicleGETReturns the last route scheduled up to today for a vehicle. Route costs are returned, but the members' pay rates they may be computed from are not.
Showing the first 120 of 139 endpoints. The rest are in the product, searchable from the workflow builder and from chat.
Use Route4Me from Claude Code, Cursor or Codex
Connect Route4Me in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Route4Me operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Route4Me
- Create your workspace
Sign up free. Nothing to install.
- Connect Route4Me once
Add your Route4Me connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Route4Me integration FAQ
What can you do with the Route4Me integration?
LiveContext exposes 139 operations on Route4Me, covering type, clustering, list and all.
