MCP Server for AI Shipping Agents

Let AI assistants ship with atoship through the Model Context Protocol. Get rates, create labels, track packages, and manage orders using natural language.

@atoship/mcp

v1.0.0

12 tools

Remote MCP — zero install

Claude.ai

Use atoship directly in the Claude.ai web app — no npm, no config files. Two fields and you are connected.

Open Claude.ai → Settings → Connectors → Add custom connector
Enter the server URL:

https://atoship.com/api/mcp

Open Advanced settings and paste this OAuth Client ID:

atoship-claude

Leave OAuth Client Secret empty. This is a public OAuth client — the connection is protected by PKCE (S256), not by a shared secret. If you see “Automatic client registration isn’t supported”, this Client ID is what it is asking for.

Click Add and atoship will ask you to approve the connection. Read that screen — it lists what Claude will be allowed to do, including buying and voiding labels, which spends your wallet balance. Claude can only spend funds already in your wallet; it cannot charge a card or take the balance negative.

Once connected, all 12 tools and slash commands (/ship, /track, /rates) are available.

Local Clients (stdio)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "atoship": {
      "command": "npx",
      "args": ["-y", "@atoship/mcp"],
      "env": {
        "ATOSHIP_API_KEY": "ak_live_your_key_here"
      }
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

Get your API key

You need an atoship API key to use the MCP server. Keys start with ak_live_ for production or ak_test_ for sandbox.

Available Tools

12 tools covering the full shipping workflow. The AI assistant picks the right tool based on your request.

get_shipping_rates

Compare rates from USPS, FedEx, UPS and more

"Get the cheapest rate for a 2lb package from SF to NYC"

purchase_label

Buy a shipping label with any carrier and service

"Create a USPS Priority Mail label for this order"

track_package

Track a package with full event history

"Track 9400111899223456789012"

validate_address

Validate addresses with auto-correction

"Validate 123 Main St, San Francisco, CA 94105"

create_order

Create orders with recipient and item details

"Create an order for John Doe at 456 Oak Ave"

list_orders

Search and filter orders by status or date

"Show me all shipped orders from this week"

get_label

Get label details, tracking number, and download URL

"Get the label for order #12345"

void_label

Cancel unused labels and get refunds

"Void the label I just created"

list_labels

Browse all shipping labels with filters

"List labels purchased today"

get_account

View account info, plan, and usage stats

"What plan am I on?"

list_carrier_accounts

See all configured carrier accounts

"Which carriers do I have connected?"

Example Conversations

Ship a Package

I need to ship a 12oz package from 123 Main St, San Francisco CA 94105 to 456 Oak Ave, New York NY 10001. What's the cheapest option?

I found 5 shipping options for your package:

1. USPS Ground Advantage — $4.75 (5-7 days)

2. USPS Priority Mail — $8.20 (2-3 days)

3. UPS Ground — $9.45 (5 days)

4. FedEx Ground — $10.12 (5 days)

5. USPS Priority Express — $26.35 (1-2 days)

The cheapest is USPS Ground Advantage at $4.75. Want me to purchase this label?

Track a Shipment

Where is my package? Tracking number 9400111899223456789012

Your USPS package is In Transit — estimated delivery Feb 14.

Feb 12 10:23 AM — Arrived at facility, Queens NY

Feb 11 8:45 PM — Departed facility, Newark NJ

Feb 10 2:30 PM — Accepted at USPS, San Francisco CA

Configuration

Variable	Required	Default	Description
`ATOSHIP_API_KEY`	Required	—	Your atoship API key
`ATOSHIP_BASE_URL`	Optional	`https://atoship.com`	API base URL