Route 4 Me MCP server

Connect Route 4 Me to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy Route 4 MeBook a demo

What you can do with the Route 4 Me MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the create territory tool in Route 4 Me
  • Use the delete contacts tool in Route 4 Me
  • Use the get team members tool in Route 4 Me
  • Use the geocode address tool in Route 4 Me
  • Use the update contact tool in Route 4 Me
  • Use the delete territory tool in Route 4 Me

Supported Tools

create_territory

Create Territory

Create a new territory for organizing operations geographically. Define the territory as a circle, polygon, or rectangle.

delete_contacts

Delete Contacts

Delete one or more contacts from the address book. This action is permanent.

get_team_members

Get Team Members

Retrieve the list of team members (users) associated with your account. Returns member details including roles and contact info.

geocode_address

Geocode Address

Convert a street address to geographic coordinates (forward geocoding) or convert lat/lng to a street address (reverse geocoding). Provide either an address string for forward geocoding, or lat/lng for reverse geocoding.

update_contact

Update Contact

Update an existing contact in the address book.

delete_territory

Delete Territory

Delete a territory. This action is permanent.

get_avoidance_zones

Get Avoidance Zones

List all avoidance zones or retrieve a specific one. Avoidance zones are geographic areas that routes should avoid during optimization.

update_order

Update Order

Update an existing order's properties such as address, customer info, scheduling, or custom fields.

update_vehicle

Update Vehicle

Update an existing vehicle's properties and constraints.

duplicate_route

Duplicate Route

Create a copy of an existing route. The duplicated route will have a new route ID but contain the same stops and settings.

set_gps_position

Set GPS Position

Report a GPS position for a device. Used to update the current location of a driver/device for real-time tracking.

create_avoidance_zone

Create Avoidance Zone

Create a new avoidance zone. Routes will avoid this geographic area during optimization. Define the zone as a circle, polygon, or rectangle.

delete_orders

Delete Orders

Delete one or more orders by their IDs. This action is permanent.

get_activities

Get Activities

Retrieve activities from the activity feed. The activity feed is an audit log of all routing-related events: route optimization, stop changes, driver arrivals, geofence events, notes, member changes, and more. Filter by route, activity type, or time range.

create_vehicle

Create Vehicle

Add a new vehicle to your fleet with its properties and constraints.

create_optimization

Create Optimization

Create and solve a route optimization problem. Provide a set of addresses/destinations with constraints and Route4Me will calculate optimal routes. Supports multiple algorithm types including TSP, CVRP with time windows, and multi-depot scenarios. Returns the optimized routes with sequenced stops.

create_contact

Create Contact

Add a new contact to the address book. Contacts serve as reusable destinations for route planning.

get_tracking_history

Get Tracking History

Retrieve GPS tracking history for a specific route. Returns the recorded location data points for the device that was tracked on the route.

create_order

Create Order

Create a new order for route planning. Orders represent customer deliveries or pickups that can be optimized into routes.

get_contacts

Get Contacts

Search and retrieve contacts from the address book. Supports filtering by query text and retrieving specific contacts by ID.

get_vehicles

Get Vehicles

List all vehicles in your fleet, or retrieve a specific vehicle by ID. Returns vehicle properties, capacity, and constraints.

get_notes

Get Notes

Retrieve notes for a specific stop/address on a route. Returns all notes including text content and metadata.

delete_team_member

Delete Team Member

Remove a team member from your account. This action is permanent.

update_route

Update Route

Update a route's properties, resequence stops, add addresses, or remove an address. Choose one type of edit per call. Route name, member, and vehicle properties can be updated together.

add_note

Add Note

Add a text note to a stop/address within a route. Notes are commonly used by drivers for proof of delivery, status updates, and other annotations.

update_team_member

Update Team Member

Update an existing team member's profile, role, or permissions.

get_optimization

Get Optimization

Retrieve an optimization problem by ID, or list all optimizations. Returns the optimization state, routes, and addresses. Use this to check optimization status, retrieve computed routes, or browse all optimizations.

get_orders

Get Orders

Retrieve a single order by ID or list orders. Returns order details including address, customer info, and scheduling.

delete_vehicle

Delete Vehicle

Remove a vehicle from your fleet. This action is permanent.

get_territories

Get Territories

List all territories or retrieve a specific one. Territories define service areas for organizing operations geographically.

delete_route

Delete Route

Delete a route by ID. This action is permanent and cannot be undone.

delete_avoidance_zone

Delete Avoidance Zone

Delete an avoidance zone. This action is permanent.

create_team_member

Create Team Member

Add a new team member to your account. Specify their role, contact info, and permissions. Supported member types: "PRIMARY_ACCOUNT" (owner), "SUB_ACCOUNT_ADMIN", "SUB_ACCOUNT_REGIONAL_MANAGER", "SUB_ACCOUNT_DISPATCHER", "SUB_ACCOUNT_PLANNER", "SUB_ACCOUNT_DRIVER", "SUB_ACCOUNT_ANALYST".

get_routes

Get Routes

Retrieve a single route by ID or list all routes. Returns route details including stops, directions, and tracking info.

get_current_user

Get Current User

Retrieve the Route4Me member associated with the connected API key, including their ID, role, and contact information.

Connect Route 4 Me to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Route 4 Me in Metorial. In your Metorial portal, enable the Route 4 Me MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Route 4 Me tools.

Run Route 4 Me through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Route 4 Me and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Route 4 Me tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Route 4 Me

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Technical notes for Route 4 Me

Optimize delivery and pickup routes by solving vehicle routing and traveling salesman problems. Create, manage, and resequence routes with configurable constraints including time windows, vehicle capacity, and travel mode. Import and manage customer orders, geocode addresses, track GPS device locations in real-time, and manage fleet vehicles. Maintain an address book of contacts and destinations, define avoidance zones and service territories, and attach notes and proof-of-delivery media to stops. Monitor routing activity via an auditable activity feed with webhook notifications for route changes, driver arrivals, geofence events, and team member updates.

Frequently asked questions

Common questions about connecting Route 4 Me to AI agents with Metorial.

  1. How many tools does the Route 4 Me MCP server have?
    The Route 4 Me MCP server exposes 35 tools, including Create Territory, Delete Contacts, Get Team Members. Each one is governed and traced through Metorial.
  2. Route 4 Me exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Route 4 Me MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Route 4 Me and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Route 4 Me MCP server yourself or use the hosted gateway.

Connect Route 4 Me to production AI agents

See how Metorial gives your team governed access to Route 4 Me, with tracing and security controls built in.

Book a demoDeploy Route 4 Me