MCP server

OptimoRoute MCP by usefulapi

io.usefulapi/optimoroute

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Check OptimoRoute routes, orders and driver events, and create orders or start route planning.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

15

Token cost

About 7,751 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http optimoroute https://optimoroute.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.optimoroute]
url = "https://optimoroute.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"optimoroute":{"httpUrl":"https://optimoroute.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"optimoroute":{"url":"https://optimoroute.usefulapi.io/mcp"}}}

VS Code

{"servers":{"optimoroute":{"type":"http","url":"https://optimoroute.usefulapi.io/mcp"}}}

Antigravity

agy mcp add optimoroute https://optimoroute.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"optimoroute","server_url":"https://optimoroute.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"optimoroute","server_url":"https://optimoroute.usefulapi.io/mcp"}

Tools

• optimoroute_create_or_update_orders ~1628 tokens
  Create, update or replace up to 500 orders in one call. No geocoding here: each location must be an existing locationNo or carry latitude+longitude (+ locationNo, address or locationName). Per order, operation MERGE/SYNC/CREATE/UPDATE works as in optimoroute_create_order; by default an order matched
• optimoroute_create_order Moves money · ~1704 tokens
  Create one order, or update an existing one, with address geocoding. operation: CREATE (new; errors if orderNo exists), UPDATE (existing only), MERGE (create or update only the fields you send — safest for edits), SYNC (create or REPLACE all fields with what you send). CREATE/SYNC/MERGE of a new ord
• optimoroute_get_completion_details ~297 tokens
  Get the completion status of up to 500 orders (unscheduled, scheduled, on_route, servicing, success, failed, rejected, cancelled) with service start/end times and positions, proof-of-delivery form data (notes, signature and photo URLs, barcodes), the tracking URL and optionally customer feedback. Re
• optimoroute_get_dispatch_status ~190 tokens
  Have the routes (and customer notifications) for a date been sent to drivers, when, and are they the live routes? Optionally counts routes added, modified or removed since sending. Omit date for the currently live date. OptimoRoute: GET /get_dispatch_status.
• optimoroute_get_events ~182 tokens
  Read driver-app events for the live routes — on_duty, off_duty, start_route, end_route, start_service, success, failed, rejected, start_time_changed — up to 500 per call. Pass the returned tag as after_tag next time to get only newer events; remainingEvents says whether more are waiting. Events can
• optimoroute_get_orders ~233 tokens
  Fetch full order data (location, time windows, assignment, loads, skills, contact) for up to 500 orders by orderNo or id. Each result has its own success flag; missing orders come back with ERR_ORD_NOT_FOUND rather than failing the call. Read-only despite using POST. OptimoRoute: POST /get_orders.
• optimoroute_get_planning_status ~158 tokens
  Check a planning (route optimization) run started with optimoroute_start_planning: status N new, R running, C cancelled, F finished, E error, plus percentageComplete. OptimoRoute: GET /get_planning_status.
• optimoroute_get_routes ~338 tokens
  Get the planned routes for one date: per driver/vehicle the duration, distance, loads and the ordered list of stops with scheduled times. Optionally filter to one driver or vehicle and include the encoded polyline, start/end locations and dispatch status. OptimoRoute: GET /get_routes.
• optimoroute_get_scheduling_info ~146 tokens
  Is this order scheduled, and if so on which driver/vehicle, at which stop number and time, plus the live ETA from the routes sent to drivers. Give orderNo or id. OptimoRoute: GET /get_scheduling_info.
• optimoroute_search_orders ~498 tokens
  Find orders in a date range (at most 35 days) or by a list of orderNo/id, optionally filtered by status (e.g. failed, rejected, unscheduled), with order data and/or scheduling info. Up to 500 per page; pass the returned after_tag with the SAME other parameters to get the next page. Read-only despite
• optimoroute_send_routes Sends messages · ~252 tokens
  Dispatch the routes for a date to the drivers' mobile app (the web app's Send Routes). This makes that date the live routes and CANNOT be unsent. sendNotifications defaults to FALSE here (OptimoRoute's own default is true); set it true only when you mean to email/SMS customers per the account's Orde
• optimoroute_start_planning ~859 tokens
  Start OptimoRoute's route optimization for a date (or a dateRange for weekly planning, if the plan allows). With the default startWith EMPTY, existing routes for that date are REPLACED; use startWith CURRENT (+ lockType) to keep them. Returns a planningId — poll it with optimoroute_get_planning_stat
• optimoroute_stop_planning ~126 tokens
  Stop a running planning (optimization) process by its planningId. OptimoRoute: POST /stop_planning.
• optimoroute_update_completion_details ~478 tokens
  Set the completion status of up to 500 orders (e.g. mark success, failed or cancelled from an external system), optionally with service start/end times. Each time takes unixTimestamp, utcTime or localTime. Reversible by setting the status again. Returns a per-order success list. OptimoRoute: POST /u
• optimoroute_update_driver_parameters ~662 tokens
  Change one driver's setup for one date: enable/disable, work hours, assigned vehicle, vehicle capacities, start/end location. WARNING: any existing route for that driver on that date is UNSCHEDULED; re-run planning afterwards. Start/end locations also apply to future optimizations. OptimoRoute: POST

Browse

• Email
• SMS and text messages
• Booking and scheduling
• Mobile apps

Related MCP servers

• Track-POD MCP by usefulapi
  Read Track-POD orders, routes, drivers, vehicles and proof of delivery; create orders.
• CXT Software MCP by usefulapi
  Track and search CXT courier orders, check drivers, propose and save order and route plans.
• Spoke Dispatch MCP by usefulapi
  Read Spoke Dispatch plans, stops, routes and drivers; create and optimize plans; send routes.
• Shipday MCP by usefulapi
  Read Shipday orders, carriers and delivery status; create orders and assign drivers.
• Raute Route Planner
  Plans delivery routes for up to 25 US addresses and 5 drivers, with the stop order and a map.
• Lalamove MCP by usefulapi
  Read Lalamove cities, vehicles, quotations and orders; quote, place, tip and cancel deliveries.
• Fold Laundry
  Book, track and manage laundry & dry-cleaning pickup in Los Angeles and San Francisco.
• Airport Pickups London
  Quote, book, track and see live cars near UK airports. Fixed prices; no signup to start.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/optimoroute.svg)](https://aptlynx.net/servers/io.usefulapi/optimoroute)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents