Connect Optimoroute to AI agents

Connect Optimoroute to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

optimize_routes

Optimize Routes

Start the route optimization engine for a given date or date range. Configurable options include route balancing, start mode, depot trips, clustering, and selective planning with specific orders/drivers. Planning runs asynchronously; the returned **planningId** can be used to check status or stop planning.

update_driver_parameters

Update Driver Parameters

Update driver parameters for a specific date, including enabling/disabling drivers, adjusting working hours, assigning vehicles, setting load capacities, and changing start/end locations. Supports both single and bulk updates. **Warning:** Updating driver parameters for a date unschedules any existing routes for that driver on that date.

search_orders

Search Orders

Search for orders across a date range with optional filtering by status. Supports cursor-based pagination for large result sets. Can also look up specific orders by number/ID and include scheduling information.

get_routes

Get Routes

Retrieve planned routes for a specific date. Returns an ordered list of stops per driver route with scheduled times, travel details, and distances. Optionally filter by driver or vehicle, and include route polylines for map rendering.

create_order

Create Order

Create a single order (delivery, pickup, or task) in OptimoRoute. Supports address geocoding for resolving addresses to coordinates. Use this for creating individual orders with full location validation. For bulk operations, use the **Bulk Create/Update Orders** tool instead.

get_planning_status

Get Planning Status

Check the status and progress of an asynchronous route optimization run. Also supports stopping a running optimization. Use the **planningId** returned from the Optimize Routes tool.

update_driver_positions

Update Driver Positions

Push driver GPS positions into OptimoRoute from an external source. Accepts timestamped latitude/longitude coordinates with optional speed, heading, and accuracy for one or more drivers.

get_scheduling_info

Get Scheduling Info

Look up the scheduling status and details of an individual order, including assigned driver, stop number, scheduled service time, and travel distance/time from the previous stop. For bulk lookups, use the **Search Orders** tool with includeScheduleInformation.

delete_orders

Delete Orders

Delete one or more orders from OptimoRoute. Can delete specific orders by number/ID, or delete all orders for a given date. Use **forceDelete** to remove orders that are part of linked pickup-delivery pairs.

update_completion_details

Update Completion Details

Update the completion status and details of an order. Use this to programmatically mark orders as completed, failed, cancelled, or update timestamps and notes.

get_completion_details

Get Completion Details

Retrieve completion status and proof of delivery data for one or more orders. Includes order status, service timestamps, driver info, GPS positions, tracking URL, and proof of delivery (signatures, photos, barcodes, notes, custom forms).

get_orders

Get Orders

Retrieve one or more orders by their order number or system ID. Returns the full order data including location, scheduling parameters, custom fields, and notification settings.

bulk_create_update_orders

Bulk Create/Update Orders

Create or update multiple orders in a single request. Each order can specify its own operation type (CREATE, UPDATE, SYNC, MERGE). Address geocoding is **not** available in bulk; use coordinates or existing location identifiers instead.

More integrations teams use with Optimoroute

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. Subscribe to real-time webhooks for changes to issues, projects, cycles, comments, documents, and more.

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.

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.

Bitbucket

Manage Git repositories, pull requests, and CI/CD pipelines on Bitbucket Cloud. Create, fork, and configure repositories within workspaces and projects. Create, review, approve, merge, and decline pull requests with inline code comments. Browse source code, list commits, and manage branches and tags. Track issues with the built-in issue tracker. Trigger, monitor, and manage Bitbucket Pipelines. List workspace members, configure repository default reviewers and branch restrictions, create and manage repository webhooks, and search code across repositories.

GitLab

Manage GitLab projects, repositories, issues, merge requests, releases, and CI/CD workflows from one provider. Includes pipeline, job, variable, environment, schedule, trigger, runner, deployment, CI lint, and test report tools.

Technical notes for Optimoroute

Create, update, search, and delete delivery and field service orders. Optimize multi-stop routes for drivers across configurable date ranges with options for route balancing, clustering, and depot trips. Retrieve planned routes with stop sequences, scheduled times, travel distances, and polylines. Manage driver parameters including working hours, vehicles, load capacities, and start/end locations. Track driver GPS positions and monitor order completion status. Access proof of delivery data including signatures, photos, barcode scans, and notes. Poll real-time mobile events such as route starts, order completions, and driver duty changes. Send customer notifications via email or SMS with order tracking URLs.

Connect Optimoroute to production AI agents

See how Metorial gives Optimoroute access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Optimoroute to AI agents with Metorial.

  1. Can Metorial connect Optimoroute to AI agents?
    Yes. Metorial connects AI agents to Optimoroute through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.