# Afi Planner

> Afi Planner is an MCP server for freight and logistics. Read-only MCP server giving AI chat apps access to Afi Planner delivery routes, orders. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** Web, API
- **Website:** https://planner.afi.io/en/connect-ai
- **MCP Registry name:** io.afi/planner
- **Categories:** freight and logistics
- **Listing updated:** 2026-11-18

## About

The Afi Planner MCP server lets Claude, ChatGPT, Gemini and other MCP-compatible apps look up delivery data from a company's Afi Planner account. Once connected, you can ask about late or failed stops, where a driver is right now, why an order did not fit on a route, or how on-time rates compared by driver last week, and the assistant answers from your company's own records.

The connection is strictly read-only. The AI app can read routes, orders, drivers and reports, but it cannot edit, plan, dispatch or message anyone. Access follows the signed-in user's role in Afi Planner, and each person connects with their own sign-in through OAuth, which can be revoked from Settings.

The server is aimed at dispatchers, operations managers and fleet owners of local delivery teams who already use Afi Planner. The AI assistant has to be switched on by the company owner or an admin before any app can read its data.

## Features

- **Read-only access:** The AI app can look up routes, orders, drivers and reports but cannot change or send anything.
- **Role-scoped data:** It only returns the information the signed-in user's role may see in Afi Planner.
- **Own sign-in via OAuth:** Each user signs in on an Afi Planner page and approves access, so passwords are not shared with the AI app.
- **Live driver status:** Shows a driver's last GPS signal, current stop, next stop and whether they are ahead or behind plan.
- **Order history lookup:** Finds an order by name, phone, address or order ID and summarises attempts, failure reasons and proof.
- **Planning explanations:** Lists orders that could not be placed and the planning rules, such as driver hours and capacity, behind the plan.

## Good for

- Check which late or failed deliveries need attention at the start of the day
- Track whether a specific driver is on schedule during a route
- Investigate what happened to a customer's order before replying to them
- Compare on-time and success rates by driver or by day for a past week
- Understand why some orders were left off tomorrow's routes

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http planner https://app.afi.io/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.afi.io/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "planner": {
      "url": "https://app.afi.io/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "planner": {
      "type": "http",
      "url": "https://app.afi.io/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "planner": {
      "serverUrl": "https://app.afi.io/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "planner": {
      "type": "http",
      "url": "https://app.afi.io/api/mcp"
    }
  }
}
```

## Tools

- `get_needs_attention`: Lists the day's late or failed stops, drivers behind plan, unanswered help requests and low ratings.
- `get_driver_now`: Shows a driver's current position, current and next stop, and progress against plan.
- `get_routes`: Returns route information for a planning day.
- `explain_plan`: Explains orders that could not be placed and the planning rules applied.
- `search_orders`: Searches orders by name, phone, address or order ID.
- `get_order`: Returns the history of a single order, including attempts, driver, times and proof.
- `get_analytics`: Returns deliveries, on-time and success rates and failure reasons for a period.
- `show_do_i`: Points to where a task is in Afi Planner and the guide for it, without making changes.

## FAQ

### Can my AI app change my routes?

No. The connection is read-only and cannot edit, plan, dispatch or message anyone.

### What does it see?

Only what your role in Afi Planner may see. Driver pay stays hidden from roles that cannot open it.

### Which apps work?

Claude, ChatGPT and Gemini have setup steps on the vendor's page, and any app that adds a remote MCP server with OAuth sign-in should work.

### How do I disconnect it?

In Afi Planner, open Settings › Connected AI apps and click Disconnect. Changing your password also ends every connected app.

### How do I add Afi Planner to Claude Code?

Run this command in your terminal: claude mcp add --transport http planner https://app.afi.io/api/mcp

### What are the best alternatives to Afi Planner?

The closest alternatives to Afi Planner are ImportYeti Scraper (Apify) - US import records and bills of lading, Lane Cost freight rates, Zentria Flow, Gangway AIS and Cofinal.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [ImportYeti Scraper (Apify) - US import records and bills of lading](https://ai-powered.com/mcp/importyeti-scraper-apify-us-import-records-and-bills-of-ladi): ImportYeti Scraper (Apify) - US import records and bills of lading is a paid MCP server for web search and scraping.
- [Lane Cost freight rates](https://ai-powered.com/mcp/lane-cost-freight-rates): Lane Cost freight rates is a free MCP server for freight and logistics.
- [Zentria Flow](https://ai-powered.com/mcp/zentria-flow): Zentria Flow is a freemium MCP server for freight and logistics.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Cofinal](https://ai-powered.com/mcp/cofinal): Cofinal is a paid MCP server for freight and logistics.
- [X3 Compliance](https://ai-powered.com/mcp/x3-compliance): X3 Compliance is a free MCP server for security.
- [RouteMetrics](https://ai-powered.com/mcp/routemetrics): RouteMetrics is a freemium MCP server for maps and travel.
- [Argo Hub Peso Volumétrico](https://ai-powered.com/mcp/argo-hub-peso-volumetrico): Argo Hub Peso Volumétrico is a free MCP server for freight and logistics.

---
Source: https://ai-powered.com/mcp/afi-planner
