MCP server

Upper Route Planner MCP by usefulapi

io.usefulapi/upper-route-planner

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read Upper drivers and stops; create and optimize routes, assign drivers, share routes to the app.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

12

Token cost

About 4,279 tokens per request

Sets up in

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

Last checked

26 Oct 2026, 08: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 upper-route-planner https://upper-route-planner.usefulapi.io/mcp

Claude Desktop

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

Codex (config.toml)

[mcp_servers.upper-route-planner]
url = "https://upper-route-planner.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"upper-route-planner":{"httpUrl":"https://upper-route-planner.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"upper-route-planner":{"url":"https://upper-route-planner.usefulapi.io/mcp"}}}

VS Code

{"servers":{"upper-route-planner":{"type":"http","url":"https://upper-route-planner.usefulapi.io/mcp"}}}

Antigravity

agy mcp add upper-route-planner https://upper-route-planner.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":"upper-route-planner","server_url":"https://upper-route-planner.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"upper-route-planner","server_url":"https://upper-route-planner.usefulapi.io/mcp"}

Tools

• upper_assign_drivers ~220 tokens
  WRITE: assign one or more drivers (ids from upper_list_drivers) to a route, replacing the route's drivers. Every id must be an active driver on the team. If the route was already optimized it is reset to unoptimized (needs_optimization: true), so run upper_optimize_route again. POST /ext-assign-driv
• upper_create_route ~328 tokens
  WRITE: create a new, empty route (name, date, optimization preference, units, pickup sequencing, service time). Omitted settings fall back to the account's defaults. Returns the new route_id; add stops with upper_create_stop. Calling it twice creates two routes. POST /ext-create-route.
• upper_create_stop ~1032 tokens
  WRITE: create a stop. The address is geocoded by Upper. Pass route_id to put it on a route (the route must not be active/in progress; an optimized route is flagged for re-optimization); omit it for an unscheduled stop. Calling it twice creates two stops. POST /ext-create-stop.
• upper_get_capacity_fields ~86 tokens
  The workspace's five capacity-field slots (capacity1 - capacity5: label, unit, enabled) used for load planning. GET /ext-get-capacity-fields.
• upper_get_custom_fields ~102 tokens
  The workspace's five stop custom-field slots (custom1 - custom5: type, label, enabled, required) and which are enabled. Needs the Custom fields feature in the Upper plan. GET /ext-get-custom-fields.
• upper_get_optimization_status ~142 tokens
  Check whether a route is optimized: status is optimized, pending (still running) or not_optimized, plus the queue_id of the last job. Poll this after upper_optimize_route. GET /ext-optimization-status.
• upper_list_drivers ~97 tokens
  List the active drivers on the Upper team that owns the API token: id, name, email and phone. Use the ids with upper_assign_drivers and upper_share_route_to_drivers. GET /ext-get-drivers.
• upper_list_stops ~368 tokens
  List the team's stops in optimized order: address, coordinates, contact, time window, duration, status, route_id and custom ids. Pass route_id for one route (optionally scheduled=true/false); pass unscheduled=true (without route_id) for stops not on any route; with no filter all active stops are ret
• upper_optimize_route ~223 tokens
  WRITE: start optimizing a route's stop order. The route needs at least one stop and one assigned driver (upper_assign_drivers). It runs asynchronously: this returns status pending and a queue_id, then poll upper_get_optimization_status. If a job is already running, that job is returned. POST /ext-op
• upper_share_route_to_drivers ~275 tokens
  WRITE: push a route to the drivers' mobile app NOW, which sends each driver a notification. Without driver_ids the route's assigned drivers are used; with them, every id must be an active driver on the team. Sending twice notifies twice. Confirm with the user before calling. POST /ext-share-to-drive
• upper_update_route ~319 tokens
  WRITE: change settings of an existing route (name, date, optimize_for, units, pickup_settings, service_time). Only the fields you pass change. POST /ext-update-route.
• upper_update_stop ~1087 tokens
  WRITE: change an existing stop; only the fields you pass change. A new address is re-geocoded (city/state/zipcode you pass with it are ignored); city/state/zipcode apply only without an address. Passing route_id moves the stop to that route. Editing a stop on an optimized route flags the route for r

Browse

• Email
• Mobile apps
• Maps and places

Related MCP servers

• Spoke Dispatch MCP by usefulapi
  Read Spoke Dispatch plans, stops, routes and drivers; create and optimize plans; send routes.
• Raute Route Planner
  Plans delivery routes for up to 25 US addresses and 5 drivers, with the stop order and a map.
• OptimoRoute MCP by usefulapi
  Check OptimoRoute routes, orders and driver events, and create orders or start route planning.
• 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.
• Reclaim.ai MCP by usefulapi
  Read tasks, habits, events and scheduling links; create and update Reclaim tasks and habits.
• Seat Sherpa
  Find carpool rides in California and Nevada: live seats, times and all-in seat prices. Read-only.
• Lalamove MCP by usefulapi
  Read Lalamove cities, vehicles, quotations and orders; quote, place, tip and cancel deliveries.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/upper-route-planner.svg)](https://aptlynx.net/servers/io.usefulapi/upper-route-planner)

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