Shiprocket MCP server
Commit Sep 22, 2026Lets an AI client manage Shiprocket orders, calculate shipping rates, track shipments, and schedule pickups.
Also known as bfrs/shiprocket-mcp
- Stars
- 29
- Tools
- 10
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Sep 22, 2026
- License
- —
What is Shiprocket MCP?
Shiprocket lets an AI client manage Shiprocket orders, calculate shipping rates, track shipments, and schedule pickups. It exposes 10 tools, such as estimated_date_of_delivery, shipping_rate_calculator, list_pickup_addresses.
Summary generated from the project's README
About Shiprocket MCP server
Managing logistics and e-commerce fulfillment directly from an AI interface is what this server enables for Shiprocket users. Developers and sellers can use it within Claude Desktop or Cursor to handle complex shipping tasks through natural language. The integration allows for checking courier rates based on pincodes, creating or canceling orders, and tracking shipments using AWB or order IDs.
Users can set this up locally by providing their Shiprocket email and password in a configuration file. Alternatively, it can be deployed as a remote HTTP server using OAuth for a more secure experience where sellers log in via a browser. The server supports different permission levels through scopes, such as seller:read for viewing delivery estimates and order lists, or seller:write for executing actions like order_ship and order_pickup_schedule.
What you can do with it
- 1Compare shipping rates and couriersAsk the AI to find the most efficient or cheapest courier options for a specific package and destination.
- 2Track package delivery statusRequest real-time updates on a shipment using an AWB number or order ID.
- 3Automate order fulfillmentInstruct the AI to create new orders or schedule pickups for existing ones.
- 4Generate shipping documentationHave the client produce labels for shipments that are ready to go.
Written from the project's README. Every use case is checked against a quote from it.
Shiprocket MCP tools 10
Detected from the READMEestimated_date_of_deliveryshipping_rate_calculatorlist_pickup_addressesorder_listorder_trackorder_shiporder_pickup_schedulegenerate_shipment_labelorder_cancelorder_create
Configuration
SELLER_EMAILSELLER_PASSWORD
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebfrs/shiprocket-mcp is public and reachablegithub.com/bfrs/shiprocket-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-09-22github.com/bfrs/shiprocket-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model10 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub🚀 Shiprocket MCP Integration
This is a Model Context Protocol (MCP) server for Shiprocket.
With this, you can:
- Check best and fastest serviceable courier partners(based on city or pincodes) and their shipping rates
- Create, update (single or bulk), and cancel orders
- Ship orders directly
- Track orders using the AWB number, Shiprocket Order ID, or Source Order ID
It connects to your personal Shiprocket account directly via Email and password.
Here's an example of what you can do when it's connected to Claude.
🛠️ Prerequisites
- Node (version > 20.0.0 and < 23.0.0)
- Claude Desktop app (or Cursor)
🛠️ Installation
1. Clone the Repository
git clone https://github.com/bfrs/shiprocket-mcp.git
cd shiprocket-mcp
2. Install Dependencies using the existing package.json
# Install dependencies
npm install
# Build the binary
npm run build
3. Connect to MCP server
Add the following to your claude_desktop_config.json or mcp.json
{
"mcpServers": {
"Shiprocket": {
"command": "npm",
"args": [
"--prefix",
"{{PATH_TO_SRC}}",
"start",
"--silent"
],
"env": {
"SELLER_EMAIL":"<Your Shiprocket Email>",
"SELLER_PASSWORD":"<Your Shiprocket password>"
}
}
}
}
For Claude, save this as claude_desktop_config.json in your Claude Desktop configuration directory at:
~/Library/Application Support/Claude/claude_desktop_config.json
For Cursor, save this as mcp.json in your Cursor configuration directory at:
~/.cursor/mcp.json
Open Claude Desktop and you should now see Shiprocket as an available integration.
Or restart Cursor.
Running as a remote (HTTP + OAuth) server
Instead of every user running a local copy with their password in a config file, the server can be hosted once and sellers connect by URL. Clients (Claude.ai, ChatGPT, Claude Code, Cursor) discover the OAuth endpoints automatically and open a browser login.
cp .env.example .env # then fill in the HTTP section
npm run build && npm run start:http
# or: docker compose up
| Variable | Required | Purpose |
|---|---|---|
OAUTH_ISSUER |
production | Public base URL, e.g. https://mcp.example.com |
TOKEN_ENC_KEY |
production | Base64 32-byte key; seller tokens are AES-256-GCM encrypted in Redis. Generate with openssl rand -base64 32. Rotating it invalidates every stored token (sellers re-login). |
REDIS_HOST / REDIS_PORT / REDIS_PASSWORD / REDIS_TLS |
production | Token store. Without REDIS_HOST an in-memory store is used (development only). |
Endpoints: /.well-known/oauth-authorization-server, /oauth/register (DCR),
/oauth/authorize, /oauth/consent, /oauth/token, /oauth/revoke (RFC 7009 — revoking
either token of a pair invalidates both and closes any live MCP session), /mcp.
Consent and scopes
Authorization is consent → login. The seller first sees which application is asking
(its registered client_name and redirect host) and exactly what it will be allowed to do,
with Allow / Deny; only after Allow are they asked for Shiprocket credentials. The forms carry
a single opaque txn; all OAuth parameters stay server-side.
| Scope | Grants | Tools |
|---|---|---|
seller:read (default) |
read-only access | estimated_delivery, order_track, order_list, shipping_rate_calculator, list_pickup_addresses, generate_shipment_label |
seller:write |
create / ship / cancel | order_ship, order_schedule_pickup, order_cancel, order_create |
A client that requests no scope gets seller:read only. Tools outside the granted scope are
not listed to the client and are refused with insufficient_scope if called anyway. In stdio
mode (seller's own credentials) every scope is implied.
MCP Tools
Clients (Claude or Cursor) can access the following tools to interact with Shiprocket:
estimated_date_of_delivery- To know more about the date of delivery for any location.shipping_rate_calculator- To check shippable couriers with their rates and coverage.list_pickup_addresses- List all the configured pickup addresses.order_list- Fetch recently created ordersorder_track- Track any order to know more about the current status of the order.order_ship- Ship an order to any serviceable courier partner based on the configured rules or specifying names.order_pickup_schedule- Schedule pickup of an ordergenerate_shipment_label- Generate label of an order or shipmentorder_cancel- Cancel an order by providing order IDorder_create- Create an order
Examples:
- "Show me the fastest serviceable courier from Delhi to Banglore"
- "What are the courier options and delivery times from Delhi to Bangalore for a 0.5 KG COD package?"
- "Where is my order?"
- "How long will it take to deliver a package to Mumbai?"
Shiprocket MCP questions
What tools does Shiprocket MCP provide?
It exposes 10 tools, including estimated_date_of_delivery, shipping_rate_calculator, list_pickup_addresses, order_list, order_track.
What can I do with the Shiprocket MCP server?
You can check courier rates and delivery estimates, create, update, or cancel orders, ship orders, and track them using AWB or Order IDs.
How does the server connect to my account?
In local mode, it connects directly via your Shiprocket email and password. In remote mode, it uses OAuth for secure browser-based login.