Shipi MCP Server

AI-powered multi-carrier shipping management for Claude Desktop, 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

2. Install

Option A: Install from npm (recommended)

npm install -g shipi-mcp-server

Option B: Clone and install locally

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:

{
  "mcpServers": {
    "shipi": {
      "command": "npx",
      "args": ["shipi-mcp-server"],
      "env": {
        "SHIPI_INTEGRATION_KEY": "your_integration_key_here"
      }
    }
  }
}

If installed locally, use the full path instead:

{
  "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 18 or higher
A Shipi account with at least one carrier configured
Claude Desktop 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

License

MIT

shipi-mcp-server