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. Just add the URL and connect.

Open Claude.ai → Settings → Integrations
Click Add integration
Enter the server URL:

https://atoship.com/api/mcp

Claude.ai will redirect you to atoship.com to authorize with your account. 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