Shipi MCP Server

1# Shipi MCP Server
2 
3AI-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.
4 
5Ship packages, compare rates, manage addresses, and track shipments — all through natural conversation with AI.
6 
7## What You Can Do
8 
9Talk to your AI assistant naturally:
10 
11- *"List my recent shipments"*
12- *"Get FedEx and UPS rates for a 5lb package from NYC to LA"*
13- *"Create a shipment using my primary FedEx account"*
14- *"Track package 794987330490"*
15- *"Add a new shipper address for our LA warehouse"*
16- *"Show me shipping stats for this month"*
17- *"What's my account balance?"*
18 
19## 18 Tools Available
20 
21| Category | Tools |
22|----------|-------|
23| **Shipments** | `list_shipments`, `get_shipment`, `search_shipments`, `create_shipment`, `cancel_shipment` |
24| **Rates** | `get_shipping_rates` — compare live rates across all carriers |
25| **Pickup** | `schedule_pickup` — schedule carrier pickup at your location |
26| **Tracking** | `track_shipment` — get tracking URL with auto carrier detection |
27| **Labels** | `fetch_labels` — retrieve labels for printing |
28| **Address Book** | `list_addresses`, `get_address`, `add_address`, `edit_address`, `delete_address` |
29| **Carriers** | `list_carriers`, `get_carrier` — view configured carrier accounts |
30| **Account** | `get_account_info`, `get_shipping_stats` — billing, plan, analytics |
31 
32## Supported Carriers
33 
34FedEx, UPS, USPS, DHL, DHL Express, Canada Post, Purolator, Canpar, Aramex, BlueDart, Delhivery, DTDC, Ecom Express, Australia Post, and more.
35 
36## Quick Setup
37 
38### 1. Get Your Integration Key
39 
40Log in to [Shipi Dashboard](https://app.myshipi.com) → **Settings** → **General** → copy your **Integration Key**.
41 
42### 2. Install
43 
44**Option A: Install from npm (recommended)**
45 
46```bash
47npm install -g shipi-mcp-server
48```
49 
50**Option B: Clone and install locally**
51 
52```bash
53git clone https://github.com/aarsiv-groups/shipi-mcp-server.git
54cd shipi-mcp-server
55npm install
56```
57 
58### 3. Configure Claude Desktop
59 
60Open Claude Desktop → Settings → Developer → Edit Config, and add:
61 
62```json
63{
64  "mcpServers": {
65    "shipi": {
66      "command": "npx",
67      "args": ["shipi-mcp-server"],
68      "env": {
69        "SHIPI_INTEGRATION_KEY": "your_integration_key_here"
70      }
71    }
72  }
73}
74```
75 
76**If installed locally**, use the full path instead:
77 
78```json
79{
80  "mcpServers": {
81    "shipi": {
82      "command": "node",
83      "args": ["C:/path/to/shipi-mcp-server/index.js"],
84      "env": {
85        "SHIPI_INTEGRATION_KEY": "your_integration_key_here"
86      }
87    }
88  }
89}
90```
91 
92### 4. Restart Claude Desktop
93 
94Close and reopen Claude Desktop. You should see the Shipi tools available (hammer icon).
95 
96## Configuration
97 
98| Environment Variable | Required | Description |
99|---------------------|----------|-------------|
100| `SHIPI_INTEGRATION_KEY` | Yes | Your Shipi integration key |
101| `SHIPI_BASE_URL` | No | API base URL (default: `https://app.myshipi.com`) |
102 
103## Example Conversations
104 
105### Compare shipping rates
106> **You:** I need to ship a 3lb package from New York (10001) to Los Angeles (90001). What are my options?
107>
108> **Claude:** Let me check rates across your carriers... *[calls get_shipping_rates]*
109>
110> FedEx Ground: $12.50 (5-7 days), UPS Ground: $11.80 (5-7 days), FedEx Express: $28.90 (2 days)...
111 
112### Create a shipment
113> **You:** Ship it with FedEx Ground
114>
115> **Claude:** I'll need the recipient details. What's the recipient name and full address?
116>
117> **You:** Jane Doe, 456 Oak Ave, Los Angeles CA 90001
118>
119> **Claude:** *[calls create_shipment]* Shipment created! Tracking: 794987330490, Label: [download link]
120 
121### Track packages
122> **You:** Where is order ORD-1234?
123>
124> **Claude:** *[calls search_shipments]* Found it — shipped via FedEx, tracking 794987330490. *[calls track_shipment]* Track here: https://track.myshipi.com/?no=794987330490
125 
126## Requirements
127 
128- [Node.js](https://nodejs.org/) 18 or higher
129- A [Shipi](https://myshipi.com) account with at least one carrier configured
130- [Claude Desktop](https://claude.ai/download) or any MCP-compatible AI client
131 
132## Security
133 
134- Your integration key is stored locally on your machine (never sent to third parties)
135- The MCP server only communicates with Shipi's API (`app.shipi.xyz`)
136- Carrier API credentials are **never** exposed through the MCP tools
137- All API calls use HTTPS
138 
139## Links
140 
141- [Shipi Website](https://myshipi.com)
142- [Shipi Dashboard](https://app.myshipi.com)
143- [API Documentation](https://resources.myshipi.com/category/general/api-reference/)
144- [Support](mailto:support@myshipi.com)
145 
146## License
147 
148MIT
149