# Route4me — how to use (mcp.ai)

Connect your Route4me account and use 97 tools for project management straight from your AI agent. Connect with your own API key. Route4Me provides a Last Mile Routing API offering automated solutions for route planning and optimization, tailored for logistics-intensive businesses.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_route4me?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `route4me_add_order_custom_field`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/route4me`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/route4me/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/route4me/add/order/custom/field` — Tool to add a new custom field definition for orders. Use when you need to create additional data fields to capture order-specific information beyond the standard order properties.
  - body: { order_custom_field_name: string, order_custom_field_type: string, order_custom_field_label: string, order_custom_field_type_info: object }
- `POST https://api.mcp.ai/api/route4me/add/route/note` — Tool to add a note to a route or address destination. Use when recording delivery status, customer feedback, or activity logs at specific stops.
  - body: { dev_lat?: number, dev_lng?: number, route_id: string, address_id: integer, strUpdateType: string, strNoteContents: string }
- `POST https://api.mcp.ai/api/route4me/create/address` — Tool to add a new address to the address book. Use when you need to create a new contact location for route planning or delivery management.
  - body: { address_1: string, address_2?: string, last_name?: string, cached_lat: number, cached_lng: number, first_name?: string, address_zip?: string, address_city?: string, address_email?: string, address_state_id?: string, address_phone_number?: string }
- `POST https://api.mcp.ai/api/route4me/create/avoidance/zone` — Tool to create an avoidance zone with circular, rectangular, or polygon shape. Use when you need to define geographic regions that routes should avoid, such as construction areas, restricted zones, or
  - body: { territory: object, territory_name: string, territory_color?: string }
- `POST https://api.mcp.ai/api/route4me/create/location/type` — Tool to create a new location type in the address book. Use when you need to categorize locations with custom types before adding them to routes.
  - body: { name: string, is_child_type: boolean, is_parent_type: boolean }
- `POST https://api.mcp.ai/api/route4me/create/master/route` — Tool to create a new master route in Route4Me. Use when you need to create a route with waypoints, optimization settings, and delivery details.
  - body: { addresses: object[], parameters: object }
- `POST https://api.mcp.ai/api/route4me/create/note` — Tool to create a new custom note type in Route4me. Use when you need to define a new category of notes with predefined selectable values for route destinations or activities.
  - body: { type: string, values: string[] }
- `POST https://api.mcp.ai/api/route4me/create/optimization` — Tool to create a new route optimization in Route4Me. Use when you need to optimize delivery routes, plan multi-stop trips, or generate efficient vehicle routing solutions.
  - body: { addresses: object[], parameters: object }
- `POST https://api.mcp.ai/api/route4me/create/optimization/profile` — Tool to create a new optimization profile in Route4Me. Use when you need to store reusable optimization settings for route planning with specific configurations like driver assignment, vehicle setting
  - body: { driver_id?: integer, speed_cap?: number, is_default?: boolean, max_volume?: number, max_weight?: number, route_name?: string, vehicle_id?: string, avoid_tolls?: boolean, breaks_mode?: integer, max_distance?: integer, profile_name: string, avoid_highways?: boolean, breaks_enabled?: boolean, route_duration?: integer, speed_cap_unit?: string, breaks_duration?: integer, max_stops_count?: integer, optimization_type?: string, avoidance_zones_ids?: string[], ignore_time_windows?: boolean, avoidance_zones_enabled?: boolean, append_date_to_route_name?: boolean, bundling_settings_is_enabled?: boolean }
- `POST https://api.mcp.ai/api/route4me/create/order/custom/field` — Tool to create a new custom field definition for orders. Use when you need to define new custom data fields that can be attached to orders for tracking additional information beyond standard order fie
  - body: { order_custom_field_name: string, order_custom_field_type: string, order_custom_field_label: string, order_custom_field_type_info: object }
- `POST https://api.mcp.ai/api/route4me/create/orders/from/contacts` — Tool to create orders from address book contacts. Use when you need to generate new orders from existing contacts for a specific delivery date.
  - body: { address_ids: integer[], scheduled_for_date: string }
- `POST https://api.mcp.ai/api/route4me/create/territory` — Tool to create a new territory with circular, rectangular, or polygon shape. Use when you need to define geographic regions for route planning, service areas, or operational zones.
  - body: { territory: object, territory_name: string, territory_color?: string }
- `POST https://api.mcp.ai/api/route4me/create/vehicle/capacity/profile` — Tool to create a vehicle capacity profile with weight, volume, item count, and revenue limits. Use when you need to define operational constraints for vehicles in route planning and fleet management.
  - body: { name: string, max_volume?: number, max_weight?: number, max_revenue?: number, max_items_number?: integer, max_volume_units?: string, max_weight_units?: string }
- `POST https://api.mcp.ai/api/route4me/delete/address` — Tool to delete an address from a route. Use when you need to remove a specific destination from an optimization problem or route.
  - body: { route_destination_id: string, optimization_problem_id: string }
- `POST https://api.mcp.ai/api/route4me/delete/addresses` — Tool to delete addresses from the Route4Me address book. Use when you need to remove one or more addresses permanently from the address book.
  - body: { address_ids: string[] }
- `POST https://api.mcp.ai/api/route4me/delete/avoidance` — Tool to delete an avoidance zone by territory_id. Use when you need to remove a specific avoidance zone from the routing system.
  - body: { territory_id: string }
- `POST https://api.mcp.ai/api/route4me/delete/configuration/setting` — Tool to delete a member configuration setting by config_key. Use when you need to remove a specific configuration setting from the account.
  - body: { config_key: string }
- `POST https://api.mcp.ai/api/route4me/delete/current/user` — Tool to delete the current authenticated user account. Use when you need to permanently remove the current user's account including contact information, preferences, and account status. This action is
- `POST https://api.mcp.ai/api/route4me/delete/location/type` — Tool to delete a location type from the address book. Use when you need to remove a location type record with its associated details such as coordinates, address, and metadata.
  - body: { location_type_id: string }
- `POST https://api.mcp.ai/api/route4me/delete/optimization` — Tool to remove optimization problems from the Route4Me database. Use when you need to clean up or delete optimization records that are no longer needed.
  - body: { optimization_problem_ids: string[] }
- `POST https://api.mcp.ai/api/route4me/delete/optimization/profile` — Tool to delete an optimization profile by ID. Use when you need to remove a specific optimization profile record from the system.
  - body: { optimization_profile_id: string }
- `POST https://api.mcp.ai/api/route4me/delete/order/custom/field` — Tool to delete an order custom field by ID. Use when you need to remove a custom field definition from order records.
  - body: { order_custom_field_id: integer }
- `POST https://api.mcp.ai/api/route4me/delete/route/v4` — Tool to delete one or more routes by route_id. Use when you need to permanently remove routes from the system. Supports single or multiple route deletion via comma-separated route_ids.
  - body: { route_id: string }
- `POST https://api.mcp.ai/api/route4me/delete/territory` — Tool to delete a territory by territory_id. Use when you need to remove a specific territory from the system.
  - body: { territory_id: string }
- `POST https://api.mcp.ai/api/route4me/delete/vehicle/capacity/profile/by/id` — Tool to delete a vehicle capacity profile by ID. Use when you need to remove a specific vehicle capacity profile from the system.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/route4me/dispatch/routes` — Tool to approve or revoke routes for execution in Route4Me. Use when you need to set approval status for routes based on filters like route ID, vehicle ID, member ID, route status, or schedule date.
  - body: { route_id?: string|string[], member_id?: integer, vehicle_id?: string|string[], route_status?: string[], schedule_date?: string[], approved_for_execution: boolean }
- `POST https://api.mcp.ai/api/route4me/display/datatable/config` — Tool to retrieve datatable configuration for vehicle capacity profiles. Use when you need to display vehicle capacity profiles in a datatable UI component with column definitions, filters, and action 
- `POST https://api.mcp.ai/api/route4me/duplicate/routes` — Tool to duplicate one or more existing routes. Use when you need to create copies of routes for similar deliveries or to use an existing route as a template.
  - body: { duplicate_routes_id: string[] }
- `POST https://api.mcp.ai/api/route4me/find/address` — Tool to retrieve detailed information about a specific address from the Route4Me address book. Use when you need to look up address details, contact information, or service requirements by address ID.
  - body: { address_id: integer }
- `POST https://api.mcp.ai/api/route4me/geocode/address` — Tool to geocode an address and obtain its coordinates. Use when you need latitude/longitude for an address string before creating routes or destinations.
  - body: { format?: string, address: string, nocache?: boolean, quality?: integer, curbside?: boolean, detailed?: boolean }
- `POST https://api.mcp.ai/api/route4me/geocode/address/body` — Tool to geocode an address by sending a body payload with the address and options. Use when you need to convert an address string into geographic coordinates (latitude/longitude).
  - body: { lat?: number, lng?: number, format?: string, address: string, nocache?: boolean, quality?: integer, curbside?: boolean, detailed?: boolean }
- `POST https://api.mcp.ai/api/route4me/geocode/address/forward` — Tool to convert an address to geographic coordinates using forward geocoding. Use when you need latitude/longitude from an address string for route planning or location-based services.
  - body: { lat?: number, lng?: number, format?: string, address: string, dev_lat?: number, dev_lng?: number, nocache?: boolean, quality?: integer, curbside?: boolean, detailed?: boolean, user_lat?: number, user_lng?: number, device_id?: string, no_filters?: boolean, device_type?: string }
- `POST https://api.mcp.ai/api/route4me/geocode/addresses` — Tool to geocode multiple addresses in a single request. Use when you need latitude/longitude coordinates for multiple addresses at once before creating routes or destinations.
  - body: { lat?: number, lng?: number, format?: string, dev_lat?: number, dev_lng?: number, nocache?: boolean, quality?: integer, curbside?: boolean, detailed?: boolean, user_lat?: number, user_lng?: number, addresses: string[], device_id?: string, no_filters?: boolean, device_type?: string }
- `POST https://api.mcp.ai/api/route4me/get/activity` — Tool to retrieve activities from the Route4Me activity feed with optional filtering and pagination. Use when you need to track changes, monitor team actions, or audit route modifications.
  - body: { limit?: integer, offset?: integer, route_id?: string, activity_type?: string }
- `POST https://api.mcp.ai/api/route4me/get/address` — Tool to get address/destination information from a route. Use when you need details about a specific stop including coordinates, status, contact information, and delivery data.
  - body: { notes?: integer, route_id: string, route_destination_id: integer }
- `POST https://api.mcp.ai/api/route4me/get/address/book/groups` — Tool to retrieve address book groups from Route4Me. Use when you need to list all address book groups for filtering or organizing contacts.
- `POST https://api.mcp.ai/api/route4me/get/addresses/from/addressbook` — Tool to retrieve addresses from the Route4Me address book. Use when you need to list contacts, search for specific addresses, or paginate through the address book. Supports filtering by address IDs an
  - body: { limit?: integer, offset?: integer, address_id?: string }
- `POST https://api.mcp.ai/api/route4me/get/async/export` — Tool to save tracking history file via async export. Use when you need to export device tracking data in CSV, JSON, or XML format. The operation is asynchronous and returns a job ID for tracking the e
  - body: { tz?: string, format?: string, show_cd?: boolean, end_date?: integer, route_id?: string, show_mmd?: boolean, device_id?: string, member_id?: integer, start_date?: integer, time_period?: string, last_position?: boolean }
- `POST https://api.mcp.ai/api/route4me/get/avoidance/by/id` — Tool to retrieve a specific avoidance zone by its territory ID. Use when you need detailed information about a particular avoidance zone for route planning or validation.
  - body: { territory_id: string }
- `POST https://api.mcp.ai/api/route4me/get/avoidance2` — Tool to retrieve all avoidance zones (territories) using API v5.0. Use when you need to view existing territories for route planning, optionally filtered by geographic location and distance.
  - body: { distance?: number, position_lat?: number, position_lng?: number }
- `POST https://api.mcp.ai/api/route4me/get/clustered/locations` — Tool to retrieve locations grouped by geographic proximity using geohash clustering. Use when you need to view locations organized by area or analyze spatial distribution of address book entries.
  - body: { filter?: object, clustering?: object }
- `POST https://api.mcp.ai/api/route4me/get/current/member/information` — Tool to retrieve the current authenticated member's information. Use when you need to get details about the logged-in user including contact information, preferences, permissions, and account status.
- `POST https://api.mcp.ai/api/route4me/get/feed` — Tool to retrieve all activities from the Route4Me activity feed. Use when you need to view activity history, track changes to routes, or monitor team member actions.
  - body: { end?: integer, team?: boolean, limit?: integer, query?: string, start?: integer, offset?: integer, route_id?: string, member_id?: integer, activity_type?: string }
- `POST https://api.mcp.ai/api/route4me/get/last/scheduled/route/member` — Tool to retrieve the most recently scheduled route for a specific member as of today. Use when you need route details including waypoints, optimization settings, and delivery metrics for a team member
  - body: { member_id: string }
- `POST https://api.mcp.ai/api/route4me/get/location/heatmap` — Tool to retrieve a heat map of location clusters from the address book. Use when visualizing location density or analyzing geographic distribution of stops.
  - body: { query?: string, filter?: object, precision?: integer }
- `POST https://api.mcp.ai/api/route4me/get/location/servicetime/heatmap` — Tool to retrieve location service-time heatmap data for address book locations. Use when analyzing historical service times and performance metrics for specific locations over a trailing 30-day period
  - body: { contact_id?: integer, location_id?: integer, trailing_days: integer, metric_type_id: integer }
- `POST https://api.mcp.ai/api/route4me/get/location/type` — Tool to get location type details by ID. Use when you need to retrieve specific information about a location type in the address book.
  - body: { location_type_id: string }
- `POST https://api.mcp.ai/api/route4me/get/member/configuration/settings` — Tool to get member configuration settings with optional filtering. Use when you need to retrieve specific configuration settings by mcs or config_key parameters.
  - body: { mcs?: string, config_key?: string }
- `POST https://api.mcp.ai/api/route4me/get/note/custom/types` — Tool to retrieve all custom note types configured for the account. Use when you need to view available note classification options before adding notes to routes or addresses.
- `POST https://api.mcp.ai/api/route4me/get/optimization/profile` — Tool to retrieve detailed information about an optimization profile by its unique identifier. Use when you need to view the configuration settings, constraints, and optimization parameters of a specif
  - body: { optimization_profile_id: string }
- `POST https://api.mcp.ai/api/route4me/get/route/destination/by/id` — Tool to get a route address/destination by its ID. Use when you need detailed information about a specific route stop including location, status, customer details, and delivery data.
  - body: { Id: integer }
- `POST https://api.mcp.ai/api/route4me/get/route/info` — Tool to get detailed route information by route ID. Use when you need comprehensive details about a specific route including waypoints, optimization settings, delivery details, and turn-by-turn direct
  - body: { notes?: boolean, original?: boolean, route_id: string, member_id?: integer, directions?: integer, device_tracking_history?: boolean }
- `POST https://api.mcp.ai/api/route4me/get/route/list` — Tool to retrieve a list of routes with filtering and pagination. Returns detailed route information including status, assignments, destinations, distances, and delivery metrics. Use when you need to q
  - body: { page?: integer, filters?: object, group_by?: string, order_by?: string[][], per_page?: integer, timezone?: string }
- `POST https://api.mcp.ai/api/route4me/get/route/settings` — Tool to get route settings with detailed information including waypoints, optimization settings, and delivery details. Use when you need comprehensive configuration data for a specific route including
  - body: { route_id: string }
- `POST https://api.mcp.ai/api/route4me/get/territories/with/location/counts` — Tool to retrieve territories with location counts for geographic analysis. Use when you need to analyze address distribution across territories or understand coverage areas.
  - body: { query?: string, center?: object, display?: string, distance?: number, is_assigned?: boolean, bounding_box?: object, customer_ids?: string[], selected_areas?: object[], assigned_member_id?: integer }
- `POST https://api.mcp.ai/api/route4me/get/territory` — Tool to retrieve territory information by ID or get all territories. Use when you need details about geographic zones and their boundaries.
  - body: { addresses?: integer, territory_id?: string }
- `POST https://api.mcp.ai/api/route4me/get/tracking` — Tool to submit device GPS tracking information to Route4Me. Use when you need to send location updates from a mobile device or tracking unit to the Route4Me platform.
  - body: { lat: number, lng: number, speed?: number, course?: number, altitude?: number, route_id?: string, device_id: string, footsteps?: number, vehicle_id?: string, app_version: string, device_type: string, device_timezone?: string, app_build_number: string, device_timestamp?: string, device_timezone_offset?: string }
- `POST https://api.mcp.ai/api/route4me/get/tracking/history/export` — Tool to export tracking history file from Route4Me. Use when you need to retrieve device location history for analysis, reporting, or compliance purposes. Supports filtering by device, member, route, 
  - body: { tz?: string, format?: string, show_cd?: boolean, download?: boolean, end_date?: integer, route_id?: string, show_mmd?: boolean, device_id?: string, member_id?: integer, start_date?: integer, time_period?: string, last_position?: boolean }
- `POST https://api.mcp.ai/api/route4me/get/user/by/id` — Tool to retrieve a sub-user by their unique ID. Use when you need detailed information about a specific team member including their permissions, settings, and profile data.
  - body: { user_id: integer }
- `POST https://api.mcp.ai/api/route4me/get/user/locations` — Tool to view locations of all users/drivers in real-time. Use when you need to track where drivers are currently located or monitor their movement.
- `POST https://api.mcp.ai/api/route4me/get/user/modification/history` — Tool to get user modification history from Route4Me. Returns detailed audit trail of changes made to a user's account including field modifications, timestamps, and who initiated the changes. Use when
  - body: { member_id: integer }
- `POST https://api.mcp.ai/api/route4me/get/user/template` — Tool to retrieve the template of a sub-user with detailed information including contact information, preferences, and account status. Use when you need to get the user template structure or default us
- `POST https://api.mcp.ai/api/route4me/get/user/v4` — Tool to retrieve authenticated user information in v4 format. Use when you need to get details about the currently authenticated user including member ID, email, name, account type, and preferences.
- `POST https://api.mcp.ai/api/route4me/get/vehicle` — Tool to retrieve details of vehicles in the organization. Use when you need the full list of vehicles before planning routes or auditing vehicle capacities.
- `POST https://api.mcp.ai/api/route4me/get/vehicle/capacity/profile/as/datatable` — Tool to retrieve vehicle capacity profiles in datatable format with pagination. Use when you need to view capacity profiles for vehicles including weight, volume, revenue, and items limits.
  - body: { page?: integer, filters?: string, order_by?: string[][], per_page?: integer, merge_pages?: boolean }
- `POST https://api.mcp.ai/api/route4me/get/vehicle/capacity/profile/by/id` — Tool to retrieve a specific vehicle capacity profile by its ID. Use when you need details of a particular capacity profile for route planning or vehicle configuration.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/route4me/get/vehicle/capacity/profile/page/config` — Tool to retrieve vehicle capacity profile page configuration including unit settings. Use when you need to understand available units for volume, weight, and revenue in vehicle capacity profiles.
- `POST https://api.mcp.ai/api/route4me/get/vehicle/capacity/profiles` — Tool to retrieve vehicle capacity profiles with weight, volume, and item constraints. Use when you need to view available capacity profiles for route planning or vehicle assignment.
  - body: { page?: integer, filters?: string, per_page?: integer, merge_pages?: boolean }
- `POST https://api.mcp.ai/api/route4me/list/location/types` — Tool to retrieve location type definitions used in the address book system. Use when categorizing addresses or locations in Route4Me.
- `POST https://api.mcp.ai/api/route4me/list/optimization/profiles` — Tool to retrieve optimization profiles with settings and configuration details. Use when you need to view available optimization profiles, check profile settings, or select a profile for route optimiz
  - body: { query_search?: string }
- `POST https://api.mcp.ai/api/route4me/list/optimizations` — Tool to get a list of all optimizations or retrieve a single optimization by ID. Use when you need to view optimization details, check optimization status, or filter optimizations by state or date ran
  - body: { limit?: integer, state?: string, offset?: integer, end_date?: string, start_date?: string, optimization_problem_id?: string }
- `POST https://api.mcp.ai/api/route4me/list/order/custom/fields` — Tool to retrieve all order custom field definitions from Route4Me v5.0 API. Use when you need to understand what custom fields are available for orders, including their types, labels, and configuratio
- `POST https://api.mcp.ai/api/route4me/list/route/directions` — Tool to get detailed route directions including turn-by-turn navigation information for each stop. Use when you need comprehensive direction details for a specific route including stop sequences, addr
  - body: { limit?: integer, cursor?: integer, route_id: string }
- `POST https://api.mcp.ai/api/route4me/list/team/users` — Tool to get the list of team members/users in the account. Use when you need to view all members, their roles, permissions, and contact information.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/route4me/list/users/by/ids` — Tool to retrieve detailed information about team members by their member IDs. Use when you need to get specific user details for one or more members by their IDs.
  - body: { member_ids: integer[] }
- `POST https://api.mcp.ai/api/route4me/list/users/paginated` — Tool to get a paginated list of team members/users in the account. Use when you need to retrieve team members with pagination support, search filtering, or when dealing with large teams where retrievi
  - body: { page?: integer, query?: string, order_by?: string[][], per_page?: integer, drivers_only?: boolean, optimization_problem_id?: string }
- `POST https://api.mcp.ai/api/route4me/lookup/for/new/destination` — Tool to lookup optimal routes for inserting a new destination. Use when you need to find the best existing route(s) to add a new stop to, based on distance or time optimization.
  - body: { lat: number, lng: number, insert_mode?: string, recommend_by?: string, scheduled_for: string, lookup_results_limit?: integer, max_increase_percent_allowed?: number }
- `POST https://api.mcp.ai/api/route4me/merge/routes` — Tool to merge multiple routes into a single target route. Use when consolidating routes to optimize delivery operations or reduce the number of active routes.
  - body: { route_ids: string[], target_route_id: string }
- `POST https://api.mcp.ai/api/route4me/move/route` — Tool to move a destination from one route to another. Use when reorganizing routes or reassigning stops between different routes.
  - body: { to_route_id: string, after_destination_id: integer, route_destination_id: integer }
- `POST https://api.mcp.ai/api/route4me/preview/route/assignment` — Tool to generate a preview of route assignments based on filters, grouping, sorting, and assignment strategy without applying changes. Returns grouped results and subtotals for review before actual as
  - body: { page?: integer, filters?: object, group_by?: string, order_by?: string[], per_page?: integer, timezone?: string, exclude_ids?: string[], assignment_strategy?: string }
- `POST https://api.mcp.ai/api/route4me/rerun/optimization` — Tool to re-optimize an existing optimization problem by updating route parameters and/or addresses. Use when you need to modify an existing route optimization with new parameters or address changes.
  - body: { addresses?: object[], parameters?: object, optimization_problem_id: string }
- `POST https://api.mcp.ai/api/route4me/reverse/geocode/address` — Tool to reverse geocode coordinates to obtain an address. Use when you need to convert latitude/longitude coordinates into a human-readable street address.
  - body: { format?: string, nocache?: boolean, quality?: integer, detailed?: boolean, latitude: number, longitude: number }
- `POST https://api.mcp.ai/api/route4me/set/destination/status` — Tool to set or update the status of a route destination. Use after confirming deliveries to mark stops as visited or departed.
  - body: { status: string, route_id: string, route_destination_id: integer }
- `POST https://api.mcp.ai/api/route4me/set/route/rating` — Tool to set a rating for a route. Use when you need to record user feedback or satisfaction level for a completed route.
  - body: { rating: integer, route_id: string }
- `POST https://api.mcp.ai/api/route4me/set/tracking` — Tool to insert tracking data for a route. Use when you need to update the real-time location and status of a vehicle or driver on a route.
  - body: { lat: number, lng: number, speed?: number, tx_id?: string, course?: number, altitude?: number, route_id: string, member_id?: integer, vehicle_id?: string, app_version?: string, device_guid?: string, device_type?: string, device_timestamp?: string }
- `POST https://api.mcp.ai/api/route4me/update/address` — Tool to update an existing address in the Route4Me address book. Use when you need to modify contact details, location information, or time windows for an address.
  - body: { address_1?: string, address_2?: string, last_name?: string, address_id: integer, first_name?: string, address_lat?: number, address_lng?: number, address_zip?: string, address_city?: string, service_time?: integer, address_alias?: string, address_email?: string, address_group?: string, time_window_end?: integer, address_state_id?: string, time_window_start?: integer, address_custom_data?: object, address_phone_number?: string }
- `POST https://api.mcp.ai/api/route4me/update/avoidance` — Tool to update an existing avoidance zone. Use when you need to modify the name, color, or geographic boundaries of an avoidance zone for route planning.
  - body: { territory: object, territory_id: string, territory_name: string, territory_color: string }
- `POST https://api.mcp.ai/api/route4me/update/location/type` — Tool to update an existing location type in the address book. Use when you need to modify location type details such as name, parent/child type status, or description.
  - body: { name: string, description?: string, is_child_type: boolean, is_parent_type: boolean, location_type_id: string }
- `POST https://api.mcp.ai/api/route4me/update/member/configuration/setting` — Tool to update a member configuration setting. Use when you need to modify account-level configuration values such as notification preferences, feature flags, or service provider settings.
  - body: { config_key: string, config_value: string }
- `POST https://api.mcp.ai/api/route4me/update/note/custom/type` — Tool to update an existing custom note type in Route4Me. Use when you need to modify the name or values of a custom note type.
  - body: { id: integer, note_custom_type: string, note_custom_type_values: string[] }
- `POST https://api.mcp.ai/api/route4me/update/optimization/profile` — Tool to update an existing optimization profile. Use when you need to modify routing preferences, constraints, or settings for route optimization.
  - body: { driver_id?: integer, is_default?: boolean, vehicle_id?: string, avoid_tolls?: boolean, max_distance?: integer, profile_name: string, avoid_highways?: boolean, max_stops_count?: integer, optimization_type?: string, optimization_profile_id: string }
- `POST https://api.mcp.ai/api/route4me/update/order/custom/field` — Tool to update an existing order custom field in Route4Me. Use when you need to modify the label, type, or configuration of a custom field for orders.
  - body: { order_custom_field_id: integer, order_custom_field_type: string, order_custom_field_label: string, order_custom_field_type_info: object }
- `POST https://api.mcp.ai/api/route4me/update/route/settings` — Tool to update route settings including optimization parameters, distance units, and device types. Use when you need to modify route configuration such as optimization criteria, distance measurement u
  - body: { optimize?: string, route_id: string, device_type?: string, travel_mode?: string, distance_unit?: string, vehicle_capacity?: integer, route_max_duration?: integer, vehicle_max_distance_mi?: number }
- `POST https://api.mcp.ai/api/route4me/update/route/v4` — Tool to update route parameters and addresses in Route4Me. Use when you need to modify route name, optimization settings, duration constraints, or reassign routes to team members.
  - body: { route_id: string, parameters: object }
- `POST https://api.mcp.ai/api/route4me/update/routes` — Tool to bulk update multiple routes in a single operation. Use when you need to update route names, optimization settings, duration constraints, or reassign multiple routes to team members efficiently
  - body: { routes: object[] }
- `POST https://api.mcp.ai/api/route4me/update/territory` — Tool to update an existing territory. Use when you need to modify the name, color, or geographic boundaries of a territory for route planning and organization.
  - body: { territory?: object, territory_id: string, territory_name?: string, territory_color?: string }
- `POST https://api.mcp.ai/api/route4me/update/vehicle/capacity/profile/by/id` — Tool to update an existing vehicle capacity profile by ID. Use when you need to modify capacity constraints such as weight, volume, item count, or revenue limits for a specific vehicle profile.
  - body: { id: integer, name?: string, max_volume?: number, max_weight?: number, max_revenue?: number, max_items_number?: integer, max_volume_units?: string, max_weight_units?: string }

## Example prompts
- "What can I do in Route4me?"
- "Show me a summary of my Route4me account"

## More
- Page: https://mcp.ai/route4me
- Agent spec (llms.txt): https://mcp.ai/route4me/llms.txt
- Postman collection: https://mcp.ai/route4me/postman.json
