🚀 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?"