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
License
MIT
