How to integrate Optimoroute MCP with Atomic Agent

Connect Atomic Agent to Optimoroute MCP. List all active drivers on duty today, show planned delivery routes for tomorrow, and more using natural language, with authentication handled for you.

Optimoroute logoOptimoroute
Api Key

OptimoRoute is an online route optimization and planning solution for logistics, delivery, and field service companies. It helps businesses save time and resources by optimizing routes, schedules, and workloads for drivers.

17 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Optimoroute.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Optimoroute account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Optimoroute with

How Atomic Agent connects to Optimoroute

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Optimoroute to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Optimoroute. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Optimoroute account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Optimoroute MCP server, and what's possible with it?

The Optimoroute MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Optimoroute account. It provides structured and secure access to your logistics and planning data, so your agent can perform actions like retrieving driver details, viewing planned delivery routes, checking route assignments, and monitoring driver status on your behalf.

  • Live driver roster and status retrieval: Instantly fetch up-to-date information about all drivers, including their current availability and contact details.
  • Planned route overview for any date: Have your agent pull a detailed list of all planned routes for a specific date, including stop information and route parameters.
  • Monitor unassigned orders and route gaps: Easily identify orders that haven’t been assigned to a route, helping you spot scheduling bottlenecks.
  • Centralized route and driver reporting: Aggregate route and driver data to power dashboards or daily logistics summaries, all via your AI agent.

Use Optimoroute from Atomic Agent

With your account connected, ask Atomic Agent to work with Optimoroute in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Optimoroute action and event your agent gets out of the box.

Create Order

Tool to create a new order or update an existing order in OptimoRoute.

Create or Update Orders

Tool to bulk create, update, or replace multiple orders at once without geocoding.

Delete All Orders

Tool to remove all orders and planned routes for a specified date.

Delete Order

Tool to remove a single order from the OptimoRoute system.

Delete Orders

Tool to delete one or more orders from the system in bulk (max 500 per request).

Get Order Completion Details

Retrieve completion status, service timing and available completion notes for up to 500 orders.

Get Drivers

Tool to retrieve all drivers in the system.

Get Mobile Events

Tool to retrieve mobile events from drivers' field operations.

Get Orders

Retrieve one or more orders by identifier, including available location and driver assignment details.

Get Planning Status

Tool to retrieve the status of an active planning/optimization process.

Get Planned Routes

Retrieve planned routes for a date, optionally filtered by driver or vehicle, with route parameters and stops.

Get Order Scheduling Info

Tool to retrieve scheduling information for a specific order.

Search Orders

Search OptimoRoute orders by order identifiers or a date range, optionally filtering by status.

Start Planning

Tool to start the planning/optimization process for a specified date or date range.

Stop Planning

Tool to stop an active planning/optimization process.

Update Driver Parameters

Update a driver's availability, work times, vehicle assignment, capacities or start/end locations.

Update Drivers Parameters

Update driver parameters for specified dates in bulk, including work hours, vehicle assignments and locations; existing routes for those drivers and dates are unscheduled.

FAQ

Frequently asked questions

Start with Optimoroute.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Optimoroute tool your agent needs.Free to start.

Start building