{"_id":"@atoship/mcp","_rev":"3-f958b8406d3d9dcfb35e498f33e1992f","name":"@atoship/mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@atoship/mcp","version":"1.0.0","keywords":["mcp","shipping","atoship","labels","tracking","rates","claude","ai"],"author":{"name":"atoship","email":"support@atoship.com"},"license":"MIT","_id":"@atoship/mcp@1.0.0","maintainers":[{"name":"atoship","email":"jtinowa@gmail.com"}],"homepage":"https://atoship.com/docs/mcp","bugs":{"url":"https://github.com/atoship-dev/atoship/issues"},"bin":{"atoship-mcp":"dist/index.js"},"dist":{"shasum":"23277d21390826aa1b88388e00435ec82c945b4d","tarball":"https://registry.npmjs.org/@atoship/mcp/-/mcp-1.0.0.tgz","fileCount":14,"integrity":"sha512-MVS4co7azYw0uuCIGOUWv9QSgojXZgErAwHIA2VDIUfV40WO4nsP9gpoCPV1a6VxHtLDvdHs1VmFZkP+wQjXig==","signatures":[{"sig":"MEQCIH43AMSP0IRSTKUt+dUGP5jC5m6SRC/QxB36wt6JJJCEAiA56OUfBoFjRl4toD27pKuotZlGA3f3pdvQTsv65gC8rg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":39115},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"4717f95d4616fb00e9ccf842151f95267178fe9a","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"atoship","email":"jtinowa@gmail.com"},"repository":{"url":"git+https://github.com/atoship-dev/atoship.git","type":"git","directory":"sdk/mcp"},"_npmVersion":"10.9.2","description":"MCP server for atoship shipping platform - get rates, create labels, track packages via AI assistants","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1770944602179_0.5840580465054106","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@atoship/mcp","version":"1.0.1","keywords":["mcp","shipping","atoship","labels","tracking","rates","claude","ai"],"author":{"name":"atoship","email":"support@atoship.com"},"license":"MIT","_id":"@atoship/mcp@1.0.1","maintainers":[{"name":"atoship","email":"jtinowa@gmail.com"}],"homepage":"https://atoship.com/docs/mcp","bugs":{"url":"https://github.com/atoship-dev/atoship/issues"},"bin":{"atoship-mcp":"dist/index.js"},"dist":{"shasum":"02740558e20ff01285a92bed92fe2f9c8e8a5544","tarball":"https://registry.npmjs.org/@atoship/mcp/-/mcp-1.0.1.tgz","fileCount":14,"integrity":"sha512-o2tPDD/jmkPnbDe+mvnATayDHN+vbJvISld1X7Rrf5tFZHMdVTLIRKM87X4LxPeRb7KJ0fHjJhAySwfN0Lu4gQ==","signatures":[{"sig":"MEYCIQCEGYpjSKX1T90hMNkw6J1RBz+X8LNIi7iqJbysuUqqKQIhAMA+olBSvIxmPWrASCwK4kYLlid3vv0zWEeqXueDnQCG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":46449},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"5990e46277d3a52ad543bfd088ca25ef9159fcfd","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"atoship","email":"jtinowa@gmail.com"},"repository":{"url":"git+https://github.com/atoship-dev/atoship.git","type":"git","directory":"sdk/mcp"},"_npmVersion":"10.9.2","description":"MCP server for atoship shipping platform - get rates, create labels, track packages via AI assistants","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.1_1771394435116_0.9122017578358095","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@atoship/mcp","version":"1.0.2","description":"MCP server for atoship shipping platform - get rates, create labels, track packages via AI assistants","keywords":["mcp","shipping","atoship","labels","tracking","rates","claude","ai"],"license":"MIT","author":{"name":"atoship","email":"support@atoship.com"},"homepage":"https://atoship.com/docs/mcp","repository":{"type":"git","url":"git+https://github.com/atoship-dev/atoship.git","directory":"sdk/mcp"},"type":"module","main":"dist/index.js","bin":{"atoship-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.7.0"},"engines":{"node":">=18"},"_id":"@atoship/mcp@1.0.2","gitHead":"5990e46277d3a52ad543bfd088ca25ef9159fcfd","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/atoship-dev/atoship/issues"},"_nodeVersion":"22.17.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-XOjLyz6pvFzZO4utcXmeM/Zr57NOobaSTFe0NyLm2rGbzIzlm7dOeFxf5j3YCWd654E0xgKh1zXeJ66PA90U6Q==","shasum":"01e523a769d35712181132b604dfbe0170392e64","tarball":"https://registry.npmjs.org/@atoship/mcp/-/mcp-1.0.2.tgz","fileCount":14,"unpackedSize":49807,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCPCpQBKgC6pSrN1xkCIPWcd3LPLtMMYYAMQ2POZq6RWgIgatmrkHryWPHlSPmMrlYMnX5qxS3xY2B3lr4gLNP+7d0="}]},"_npmUser":{"name":"atoship","email":"jtinowa@gmail.com"},"directories":{},"maintainers":[{"name":"atoship","email":"jtinowa@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.0.2_1771397479231_0.28030252026949287"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-13T01:03:22.103Z","modified":"2026-02-18T06:51:19.486Z","1.0.0":"2026-02-13T01:03:22.325Z","1.0.1":"2026-02-18T06:00:35.279Z","1.0.2":"2026-02-18T06:51:19.375Z"},"bugs":{"url":"https://github.com/atoship-dev/atoship/issues"},"author":{"name":"atoship","email":"support@atoship.com"},"license":"MIT","homepage":"https://atoship.com/docs/mcp","keywords":["mcp","shipping","atoship","labels","tracking","rates","claude","ai"],"repository":{"type":"git","url":"git+https://github.com/atoship-dev/atoship.git","directory":"sdk/mcp"},"description":"MCP server for atoship shipping platform - get rates, create labels, track packages via AI assistants","maintainers":[{"name":"atoship","email":"jtinowa@gmail.com"}],"readme":"# @atoship/mcp\n\nTurn your AI assistant into a fully autonomous shipping manager. The `@atoship/mcp` server connects Claude, Cursor, and any MCP-compatible AI to the [atoship](https://atoship.com) shipping platform — enabling real-time rate comparison across USPS, FedEx, and UPS, instant label purchase, shipment tracking, and order management, all through natural conversation.\n\n**Before:** Open carrier website → enter addresses → compare rates across tabs → copy-paste tracking numbers → manually update order status.\n\n**After:** *\"Ship this to John in Austin, cheapest option under 3 days.\"* Done.\n\n## Installation\n\n### Claude Code\n\n```bash\nclaude mcp add atoship -- npx -y @atoship/mcp\n```\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"atoship\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@atoship/mcp\"],\n      \"env\": {\n        \"ATOSHIP_API_KEY\": \"ak_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / Windsurf / Any MCP client\n\n```bash\nATOSHIP_API_KEY=ak_live_xxx npx @atoship/mcp\n```\n\n## Get Your API Key\n\n1. Sign up free at [atoship.com](https://atoship.com) — no credit card required\n2. Go to **Dashboard → Settings → API Keys**\n3. Create a new key (`ak_live_...` for production, `ak_test_...` for development)\n4. Set it as `ATOSHIP_API_KEY` in your environment\n\n> **Test keys are free:** Labels created with `ak_test_...` are never actually shipped and cost nothing. Use them while evaluating.\n\n## What your AI can do\n\nOnce installed, just describe what you need in plain language:\n\n- *\"How much to ship a 2lb box from LA to New York?\"* → Rate comparison table across all carriers\n- *\"Buy the USPS Priority option\"* → Label purchased, tracking number returned\n- *\"Track 9400111899223456789012\"* → Full event history with estimated delivery\n- *\"Show me all FedEx labels from this week\"* → Filtered label list\n- *\"What's my account balance?\"* → Current wallet balance and usage stats\n- *\"Void that last label\"* → Refund issued within carrier void window\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_shipping_rates` | Compare live postage rates from USPS, FedEx, and UPS |\n| `purchase_label` | Buy a shipping label — returns tracking number and download URL |\n| `get_label` | Get label details by ID (status, tracking, label URL) |\n| `list_labels` | List shipping labels with carrier/status/order filters |\n| `void_label` | Cancel an unused label and issue a refund |\n| `track_package` | Real-time package tracking with full event history |\n| `validate_address` | Verify and standardize a delivery address |\n| `create_order` | Create an order with recipient and item details |\n| `get_order` | Get order details by ID |\n| `list_orders` | List orders with status/date/search filters |\n| `get_account` | Check wallet balance, plan, and usage |\n| `list_carrier_accounts` | List configured carrier accounts |\n\n## Built-in Prompts (Slash Commands)\n\nAfter installing, these slash commands are available in your AI client:\n\n| Command | Description |\n|---------|-------------|\n| `/ship` | Full shipping workflow — rates → carrier selection → label purchase |\n| `/rates` | Quick rate comparison across USPS, FedEx, and UPS |\n| `/track` | Track a package by tracking number |\n\n## Why atoship?\n\nShipping 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.\n\natoship eliminates that entirely:\n\n- **Thinks in seconds, not minutes** — Rate comparisons across all carriers happen instantly\n- **Never makes address typos** — Structured data flow from conversation to label, zero manual re-entry\n- **Scales with your business** — Whether you ship 1 or 1,000 packages a day, the workflow is identical\n- **Saves real money** — Discounted carrier rates with no volume minimums, no monthly fees\n- **Works with any AI** — Claude, Cursor, Windsurf, or any MCP-compatible assistant\n\n## Common Use Cases\n\n**E-commerce order fulfillment** — Ship Shopify, eBay, Etsy, or Amazon orders without switching tabs. Automatically find the cheapest carrier for each order.\n\n**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.\n\n**Dropshipping & 3PL logistics** — Generate labels programmatically and track shipments in bulk through natural language commands.\n\n**International shipping** — Cross-border shipping to Canada, UK, Australia, and 200+ countries via USPS International, FedEx International, and UPS Worldwide.\n\n**Returns management** — Generate prepaid return labels for customer returns with a single command.\n\n## Security\n\nThis 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.\n\n**Actions that affect your wallet:** `purchase_label`, `void_label`\n\n**Read-only actions:** `get_shipping_rates`, `track_package`, `list_labels`, `get_label`, `get_account`, `list_carrier_accounts`, `validate_address`, `list_orders`, `get_order`\n\nRecommendations: start with a small wallet balance, use `ak_test_...` keys for development, and set spending alerts in Dashboard → Billing → Notifications.\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `ATOSHIP_API_KEY` | Yes | — | Your atoship API key (`ak_live_...` or `ak_test_...`) |\n| `ATOSHIP_BASE_URL` | No | `https://atoship.com` | Custom API base URL |\n\n## Support & Contact\n\n- **Email:** [support@atoship.com](mailto:support@atoship.com)\n- **Docs:** [atoship.com/docs/mcp](https://atoship.com/docs/mcp)\n- **API Reference:** [atoship.com/docs/api](https://atoship.com/docs/api)\n- **Dashboard:** [atoship.com/dashboard](https://atoship.com/dashboard)\n\nFor API key issues, billing questions, or integration support, email support@atoship.com — we respond within one business day.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}