Skip to content
MCP server

Apc MCP

Book, label, track and cancel APC Overnight UK parcels from an MCP client

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.2.1
Listing updated
today

Similar MCP servers

About Apc MCP

Apc MCP is an open-source MCP server for freight and logistics. It runs locally on your machine and is started by your AI client.

Aimed at shippers with an APC Overnight account, this local server wraps the APC New Horizon API v3. It exposes six tools covering booking, batch booking with one merged label PDF, label download as PDF, ZPL or PNG, tracking history, cancellation before manifesting, and the service list.

The README says more than 60 ProductCodes are available, with next-day by 09:00, 10:00, 12:00 or 16:00, Saturday, economy and specialist services such as liquid and non-conveyable, but which codes work depends on your APC contract. The README warns that every booking costs money, that batches hold up to 50 shipments, and that a training endpoint is available for testing without charges.

It runs over stdio with APC portal credentials in environment variables, so remote-only clients like ChatGPT are not supported yet.

Install

Run in a terminal

claude mcp add apc-mcp --env APC_USERNAME='<APC_USERNAME>' --env APC_PASSWORD='<APC_PASSWORD>' -- npx -y apc-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apc-mcp"
      ],
      "env": {
        "APC_USERNAME": "<APC_USERNAME>",
        "APC_PASSWORD": "<APC_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apc-mcp"
      ],
      "env": {
        "APC_USERNAME": "<APC_USERNAME>",
        "APC_PASSWORD": "<APC_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "apc-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "apc-mcp"
      ],
      "env": {
        "APC_USERNAME": "<APC_USERNAME>",
        "APC_PASSWORD": "<APC_PASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "apc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apc-mcp"
      ],
      "env": {
        "APC_USERNAME": "<APC_USERNAME>",
        "APC_PASSWORD": "<APC_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "apc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apc-mcp"
      ],
      "env": {
        "APC_USERNAME": "<APC_USERNAME>",
        "APC_PASSWORD": "<APC_PASSWORD>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • APC_USERNAMEThe email you use to log in to the APC portal. Your account needs API access.Required
  • APC_PASSWORDThe password you use to log in to the APC portal.Required

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

book_shipment
Creates a consignment and returns the 22-digit WayBill.
book_batch_and_label
Books many shipments and returns one merged label PDF.
get_label
Saves a shipping label as PDF, ZPL or PNG.
track_shipment
Returns current status and tracking history.
cancel_shipment
Cancels a consignment before it is manifested.
list_services
Lists the supported APC services with ProductCodes.

What it does

Single and batch booking
Book one parcel or up to 50 and get one merged label PDF.
Label formats
Save labels as PDF, ZPL for thermal printers, or PNG.
Tracking history
Current status and full scan history for a waybill.
Cancel before manifest
Cancel a consignment until it is manifested.
Service catalogue
list_services returns the APC ProductCodes this server supports.
Training endpoint
Test against APC's training API that does not charge or ship.

Good for

  • Book next-day collections from a prompt
  • Print Zebra labels for a day's orders
  • Check which consignments are undelivered
  • Cancel a waybill after an order is withdrawn
  • Draft customer tracking replies

Pricing

Open source

Free to run; each APC booking is charged by APC under your contract

Apc MCP FAQ

What credentials are needed?

The email and password for the APC portal, on an account with API access.

Can I test without shipping?

Yes, use APC's training endpoint, which won't charge or send real parcels.

Does it work with ChatGPT?

Not yet; remote-only clients need an HTTP transport the project doesn't include.

Are prices returned?

No, the README says neither this nor the companion Royal Mail server returns prices.

Is Apc MCP free?

Yes. Apc MCP is open source, so you can use and self-host it for free.

How do I add Apc MCP to Claude Code?

Run this command in your terminal: claude mcp add apc-mcp --env APC_USERNAME='<APC_USERNAME>' --env APC_PASSWORD='<APC_PASSWORD>' -- npx -y apc-mcp

What are the best alternatives to Apc MCP?

The closest alternatives to Apc MCP are ChatGPT for Amazon, O'So MCP Server for PrestaShop, Ebid, Zovo Product Recall Check and Trackkr MCP Server — Smart Lockerless Parcel Management.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers