aarsiv-groups/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

Log in to Shipi Dashboard → Settings → General → copy 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

Links

• Shipi Website
• Shipi Dashboard
• API Documentation
• Support

License

MIT