@atoship/mcp

Turn your AI assistant into a fully autonomous shipping manager. The @atoship/mcp server connects Claude, Cursor, and any MCP-compatible AI to the atoship shipping platform — enabling real-time rate comparison across USPS, FedEx, and UPS, instant label purchase, shipment tracking, and order management, all through natural conversation.

Before: Open carrier website → enter addresses → compare rates across tabs → copy-paste tracking numbers → manually update order status.

After: "Ship this to John in Austin, cheapest option under 3 days." Done.

Installation

Claude Code

claude mcp add atoship -- npx -y @atoship/mcp

Claude Desktop

Add to your claude_desktop_config.json:

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

Cursor / Windsurf / Any MCP client

ATOSHIP_API_KEY=ak_live_xxx npx @atoship/mcp

Get Your API Key

1. Sign up free at atoship.com — no credit card required
2. Go to Dashboard → Settings → API Keys
3. Create a new key (ak_live_... for production, ak_test_... for development)
4. Set it as ATOSHIP_API_KEY in your environment

Test keys are free: Labels created with ak_test_... are never actually shipped and cost nothing. Use them while evaluating.

What your AI can do

Once installed, just describe what you need in plain language:

• "How much to ship a 2lb box from LA to New York?" → Rate comparison table across all carriers
• "Buy the USPS Priority option" → Label purchased, tracking number returned
• "Track 9400111899223456789012" → Full event history with estimated delivery
• "Show me all FedEx labels from this week" → Filtered label list
• "What's my account balance?" → Current wallet balance and usage stats
• "Void that last label" → Refund issued within carrier void window

Available Tools

| Tool | Description | |------|-------------| | get_shipping_rates | Compare live postage rates from USPS, FedEx, and UPS | | purchase_label | Buy a shipping label — returns tracking number and download URL | | get_label | Get label details by ID (status, tracking, label URL) | | list_labels | List shipping labels with carrier/status/order filters | | void_label | Cancel an unused label and issue a refund | | track_package | Real-time package tracking with full event history | | validate_address | Verify and standardize a delivery address | | create_order | Create an order with recipient and item details | | get_order | Get order details by ID | | list_orders | List orders with status/date/search filters | | get_account | Check wallet balance, plan, and usage | | list_carrier_accounts | List configured carrier accounts |

Built-in Prompts (Slash Commands)

After installing, these slash commands are available in your AI client:

| Command | Description | |---------|-------------| | /ship | Full shipping workflow — rates → carrier selection → label purchase | | /rates | Quick rate comparison across USPS, FedEx, and UPS | | /track | Track a package by tracking number |

Why atoship?

Shipping is one of the most time-consuming parts of running an online business. Every order means logging into carrier portals, comparing rates, copy-pasting addresses, downloading labels, and tracking updates one by one. For teams processing dozens or hundreds of shipments a day, this is a massive operational burden.

atoship eliminates that entirely:

• Thinks in seconds, not minutes — Rate comparisons across all carriers happen instantly
• Never makes address typos — Structured data flow from conversation to label, zero manual re-entry
• Scales with your business — Whether you ship 1 or 1,000 packages a day, the workflow is identical
• Saves real money — Discounted carrier rates with no volume minimums, no monthly fees
• Works with any AI — Claude, Cursor, Windsurf, or any MCP-compatible assistant

Common Use Cases

E-commerce order fulfillment — Ship Shopify, eBay, Etsy, or Amazon orders without switching tabs. Automatically find the cheapest carrier for each order.

Small business shipping — Compare USPS First Class vs Priority Mail vs FedEx Ground vs UPS Ground for any package size. Save money on every shipment.

Dropshipping & 3PL logistics — Generate labels programmatically and track shipments in bulk through natural language commands.

International shipping — Cross-border shipping to Canada, UK, Australia, and 200+ countries via USPS International, FedEx International, and UPS Worldwide.

Returns management — Generate prepaid return labels for customer returns with a single command.

Security

This MCP server only uses the ATOSHIP_API_KEY you provide. It calls the atoship REST API (https://atoship.com/api/v1) and does not access your file system or other environment variables.

Actions that affect your wallet: purchase_label, void_label

Read-only actions: get_shipping_rates, track_package, list_labels, get_label, get_account, list_carrier_accounts, validate_address, list_orders, get_order

Recommendations: start with a small wallet balance, use ak_test_... keys for development, and set spending alerts in Dashboard → Billing → Notifications.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | ATOSHIP_API_KEY | Yes | — | Your atoship API key (ak_live_... or ak_test_...) | | ATOSHIP_BASE_URL | No | https://atoship.com | Custom API base URL |

Support & Contact

• Email: [email protected]
• Docs: atoship.com/docs/mcp
• API Reference: atoship.com/docs/api
• Dashboard: atoship.com/dashboard

For API key issues, billing questions, or integration support, email [email protected] — we respond within one business day.

License

MIT