# smartroutes

Connect Claude Code to SmartRoutes data to inspect orders and routes or start route optimisation. Access requires a SmartRoutes API key.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: SmartRoutes-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SmartRoutes-io/smartroutes-mcp
- Updated: 2026-08-26
- HTML: https://affpapa.org/en/nevibecode/mcp/smartroutes

## What it does

The server gives an AI client tools to look up orders, customers, vehicles and route details. It can also create orders and start optimisation for a chosen date. Ask about unscheduled orders or inspect the stops on a route.

Connect over HTTP at `https://mcp.smartroutes.io/mcp` and authenticate with your SmartRoutes API key in the `x-access-key` header. To block changes, set `x-access-scope: read-only`; write tools are then removed from the available list. Take care with optimisation: auto-dispatch can publish a plan to drivers and notify customers. The API key grants access to account data, so keep it secret.

## Requirements
- Remote server: `https://mcp.smartroutes.io/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http smartroutes https://mcp.smartroutes.io/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add smartroutes --url https://mcp.smartroutes.io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "smartroutes": {
            "url": "https://mcp.smartroutes.io/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "smartroutes": {
            "type": "http",
            "url": "https://mcp.smartroutes.io/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http smartroutes https://mcp.smartroutes.io/mcp
```

## When to use it
- find orders by status or order number
- check whether an address can be served in a time window
- inspect stops on a route
- create an order in SmartRoutes
- start route optimisation for a date

## Example prompts
- Find orders that have not been scheduled yet.
- Check whether this address can be served during the selected time window.
- Start route optimisation for the requested date.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md