🚀 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.

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 orders
order_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 order
generate_shipment_label - Generate label of an order or shipment
order_cancel - Cancel an order by providing order ID
order_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 Integration