shipi-mcp-server

# Shipi MCP Server AI-powered multi-carrier shipping management for [Claude Desktop](https://claude.ai/download), [Claude Code](https://docs.anthropic.com/en/docs/claude-code), and any MCP-compatible AI client. Ship packages, compare rates, manage addresses, and track shipments — all through natural conversation with AI. ## What You Can Do Talk to your AI assistant naturally: - *"List my recent shipments"* - *"Get FedEx and UPS rates for a 5lb package from NYC to LA"* - *"Create a shipment using my primary FedEx account"* - *"Track package 794987330490"* - *"Add a new shipper address for our LA warehouse"* - *"Show me shipping stats for this month"* - *"What's my account balance?"* ## 18 Tools Available | Category | Tools | |----------|-------| | **Shipments** | `list_shipments`, `get_shipment`, `search_shipments`, `create_shipment`, `cancel_shipment` | | **Rates** | `get_shipping_rates` — compare live rates across all carriers | | **Pickup** | `schedule_pickup` — schedule carrier pickup at your location | | **Tracking** | `track_shipment` — get tracking URL with auto carrier detection | | **Labels** | `fetch_labels` — retrieve labels for printing | | **Address Book** | `list_addresses`, `get_address`, `add_address`, `edit_address`, `delete_address` | | **Carriers** | `list_carriers`, `get_carrier` — view configured carrier accounts | | **Account** | `get_account_info`, `get_shipping_stats` — billing, plan, analytics | ## Supported Carriers FedEx, UPS, USPS, DHL, DHL Express, Canada Post, Purolator, Canpar, Aramex, BlueDart, Delhivery, DTDC, Ecom Express, Australia Post, and more. ## Quick Setup ### 1. Get Your Integration Key Log in to [Shipi Dashboard](https://app.myshipi.com) → **Settings** → **General** → copy your **Integration Key**. ### 2. Install **Option A: Install from npm (recommended)** ```bash npm install -g shipi-mcp-server ``` **Option B: Clone and install locally** ```bash git clone https://github.com/aarsiv-groups/shipi-mcp-server.git cd shipi-mcp-server npm install ``` ### 3. Configure Claude Desktop Open Claude Desktop → Settings → Developer → Edit Config, and add: ```json { "mcpServers": { "shipi": { "command": "npx", "args": ["shipi-mcp-server"], "env": { "SHIPI_INTEGRATION_KEY": "your_integration_key_here" } } } } ``` **If installed locally**, use the full path instead: ```json { "mcpServers": { "shipi": { "command": "node", "args": ["C:/path/to/shipi-mcp-server/index.js"], "env": { "SHIPI_INTEGRATION_KEY": "your_integration_key_here" } } } } ``` ### 4. Restart Claude Desktop Close and reopen Claude Desktop. You should see the Shipi tools available (hammer icon). ## Configuration | Environment Variable | Required | Description | |---------------------|----------|-------------| | `SHIPI_INTEGRATION_KEY` | Yes | Your Shipi integration key | | `SHIPI_BASE_URL` | No | API base URL (default: `https://app.myshipi.com`) | ## Example Conversations ### Compare shipping rates > **You:** I need to ship a 3lb package from New York (10001) to Los Angeles (90001). What are my options? > > **Claude:** Let me check rates across your carriers... *[calls get_shipping_rates]* > > FedEx Ground: $12.50 (5-7 days), UPS Ground: $11.80 (5-7 days), FedEx Express: $28.90 (2 days)... ### Create a shipment > **You:** Ship it with FedEx Ground > > **Claude:** I'll need the recipient details. What's the recipient name and full address? > > **You:** Jane Doe, 456 Oak Ave, Los Angeles CA 90001 > > **Claude:** *[calls create_shipment]* Shipment created! Tracking: 794987330490, Label: [download link] ### Track packages > **You:** Where is order ORD-1234? > > **Claude:** *[calls search_shipments]* Found it — shipped via FedEx, tracking 794987330490. *[calls track_shipment]* Track here: https://track.myshipi.com/?no=794987330490 ## Requirements - [Node.js](https://nodejs.org/) 18 or higher - A [Shipi](https://myshipi.com) account with at least one carrier configured - [Claude Desktop](https://claude.ai/download) or any MCP-compatible AI client ## Security - Your integration key is stored locally on your machine (never sent to third parties) - The MCP server only communicates with Shipi's API (`app.shipi.xyz`) - Carrier API credentials are **never** exposed through the MCP tools - All API calls use HTTPS ## Links - [Shipi Website](https://myshipi.com) - [Shipi Dashboard](https://app.myshipi.com) - [API Documentation](https://resources.myshipi.com/category/general/api-reference/) - [Support](mailto:support@myshipi.com) ## License MIT