India Logistics (Shiprocket: courier serviceability + rates, create orders, track AWB)

Official4 toolsLive

by junter1989k-ai · JavaScript

India shipping for AI agents: Shiprocket courier serviceability, create orders, track AWB.

Topics

ai-agentclaudefirsindialogisticsmcpmcp-servershippingshiprocketwishpool

Captured live from the server via tools/list.

check_serviceability

India shipping courier serviceability + live rate quote — THE tool to call FIRST. Given a pickup pincode, a delivery pincode, the parcel weight (KG) and whether it is COD, it returns every courier company (Delhivery, Bluedart, Ekart, Xpressbees, DTDC etc.) that can carry the parcel, each with its freight rate (INR), estimated delivery days and rating, plus which one is cheapest. Read-only: quotes only, creates nothing and spends nothing. Bring your own Shiprocket merchant credentials via headers x-shiprocket-email + x-shiprocket-password.

Parameters5

pickup_postcode	string	required	Origin pincode (6-digit Indian postal code the parcel ships FROM). Must be a serviceable pickup pincode on your Shiprocket account.
delivery_postcode	string	required	Destination pincode (6-digit Indian postal code the parcel ships TO).
weight	number	required	Parcel weight in KILOGRAMS (kg). e.g. 0.5 = 500 g. Required.
cod	boolean	optional	true = Cash On Delivery, false = Prepaid. Default false. Serviceability differs by payment mode.
declared_value	number	optional	Optional order value in INR — some couriers gate by declared value / COD amount.

Raw schema

{
  "type": "object",
  "properties": {
    "pickup_postcode": {
      "type": "string",
      "description": "Origin pincode (6-digit Indian postal code the parcel ships FROM). Must be a serviceable pickup pincode on your Shiprocket account."
    },
    "delivery_postcode": {
      "type": "string",
      "description": "Destination pincode (6-digit Indian postal code the parcel ships TO)."
    },
    "weight": {
      "type": "number",
      "description": "Parcel weight in KILOGRAMS (kg). e.g. 0.5 = 500 g. Required."
    },
    "cod": {
      "type": "boolean",
      "description": "true = Cash On Delivery, false = Prepaid. Default false. Serviceability differs by payment mode."
    },
    "declared_value": {
      "type": "number",
      "description": "Optional order value in INR — some couriers gate by declared value / COD amount."
    }
  },
  "required": [
    "pickup_postcode",
    "delivery_postcode",
    "weight"
  ]
}

create_shipment

Create an India shipping order in Shiprocket (adhoc order) — pass the pickup_location nickname (a pickup address you already registered in your Shiprocket dashboard), the buyer billing address, the order_items, the payment_method (COD or Prepaid), the order value (sub_total, INR) and the parcel box in CENTIMETRES (length/breadth/height) + weight in KILOGRAMS. Returns the Shiprocket order_id and shipment_id you then use to assign a courier / print the AWB label and to track. NOTE: creating the order does NOT yet debit your Shiprocket wallet — wallet is charged only when you assign a courier / generate the AWB (a step you do in the dashboard or a later tool). Bring your own Shiprocket merchant credentials via headers x-shiprocket-email + x-shiprocket-password. A completed KYC (Aadhaar/GSTIN) and a registered pickup location are merchant-side prerequisites before real parcels ship. Owner policy headers gate the order value before creation.

Parameters28

order_id	string	optional	Your own order reference (any unique string). Optional — a timestamp-based id is generated if omitted.
order_date	string	optional	Order date "YYYY-MM-DD HH:mm". Optional — defaults to now.
pickup_location	string	required	The nickname of a pickup address ALREADY registered in your Shiprocket dashboard (Settings → Pickup Addresses). Required — must match exactly. This is where the courier collects the parcel.
billing_customer_name	string	required	Buyer first name.
billing_last_name	string	optional	Buyer last name. Optional.
billing_address	string	required	Buyer street address line 1.
billing_address_2	string	optional	Buyer street address line 2. Optional.
billing_city	string	required	Buyer city.
billing_pincode	string	required	Buyer 6-digit Indian pincode.
billing_state	string	required	Buyer state (e.g. Maharashtra, Karnataka).
billing_country	string	optional	Buyer country. Default India.
billing_email	string	required	Buyer email.
billing_phone	string	required	Buyer 10-digit phone.
shipping_is_billing	boolean	optional	true (default) = ship to the billing address. Set false to provide a separate shipping_* address.
shipping_customer_name	string	optional	Shipping recipient name (only if shipping_is_billing=false).
shipping_address	string	optional	Shipping street address (only if shipping_is_billing=false).
shipping_city	string	optional	Shipping city (only if shipping_is_billing=false).
shipping_pincode	string	optional	Shipping pincode (only if shipping_is_billing=false).
shipping_state	string	optional	Shipping state (only if shipping_is_billing=false).
shipping_country	string	optional	Shipping country (only if shipping_is_billing=false). Default India.
shipping_phone	string	optional	Shipping phone (only if shipping_is_billing=false).
order_items	array	required	Line items in the parcel. At least one. Each: { name (required), units (required int), selling_price (required INR), sku (optional) }.
payment_method	string	required	COD or Prepaid. Required.
sub_total	number	required	Order value in INR (sum of line items). Required. Owner policy headers gate this amount before the order is created.
length	number	required	Parcel length in CENTIMETRES (cm). Required, > 0.5.
breadth	number	required	Parcel breadth in CENTIMETRES (cm). Required, > 0.5.
height	number	required	Parcel height in CENTIMETRES (cm). Required, > 0.5.
weight	number	required	Parcel weight in KILOGRAMS (kg). Required, > 0.

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "Your own order reference (any unique string). Optional — a timestamp-based id is generated if omitted."
    },
    "order_date": {
      "type": "string",
      "description": "Order date \"YYYY-MM-DD HH:mm\". Optional — defaults to now."
    },
    "pickup_location": {
      "type": "string",
      "description": "The nickname of a pickup address ALREADY registered in your Shiprocket dashboard (Settings → Pickup Addresses). Required — must match exactly. This is where the courier collects the parcel."
    },
    "billing_customer_name": {
      "type": "string",
      "description": "Buyer first name."
    },
    "billing_last_name": {
      "type": "string",
      "description": "Buyer last name. Optional."
    },
    "billing_address": {
      "type": "string",
      "description": "Buyer street address line 1."
    },
    "billing_address_2": {
      "type": "string",
      "description": "Buyer street address line 2. Optional."
    },
    "billing_city": {
      "type": "string",
      "description": "Buyer city."
    },
    "billing_pincode": {
      "type": "string",
      "description": "Buyer 6-digit Indian pincode."
    },
    "billing_state": {
      "type": "string",
      "description": "Buyer state (e.g. Maharashtra, Karnataka)."
    },
    "billing_country": {
      "type": "string",
      "description": "Buyer country. Default India."
    },
    "billing_email": {
      "type": "string",
      "description": "Buyer email."
    },
    "billing_phone": {
      "type": "string",
      "description": "Buyer 10-digit phone."
    },
    "shipping_is_billing": {
      "type": "boolean",
      "description": "true (default) = ship to the billing address. Set false to provide a separate shipping_* address."
    },
    "shipping_customer_name": {
      "type": "string",
      "description": "Shipping recipient name (only if shipping_is_billing=false)."
    },
    "shipping_address": {
      "type": "string",
      "description": "Shipping street address (only if shipping_is_billing=false)."
    },
    "shipping_city": {
      "type": "string",
      "description": "Shipping city (only if shipping_is_billing=false)."
    },
    "shipping_pincode": {
      "type": "string",
      "description": "Shipping pincode (only if shipping_is_billing=false)."
    },
    "shipping_state": {
      "type": "string",
      "description": "Shipping state (only if shipping_is_billing=false)."
    },
    "shipping_country": {
      "type": "string",
      "description": "Shipping country (only if shipping_is_billing=false). Default India."
    },
    "shipping_phone": {
      "type": "string",
      "description": "Shipping phone (only if shipping_is_billing=false)."
    },
    "order_items": {
      "type": "array",
      "description": "Line items in the parcel. At least one. Each: { name (required), units (required int), selling_price (required INR), sku (optional) }.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Product name."
          },
          "sku": {
            "type": "string",
            "description": "Stock keeping unit / product code. Optional — derived from name if omitted."
          },
          "units": {
            "type": "number",
            "description": "Quantity (integer >= 1)."
          },
          "selling_price": {
            "type": "number",
            "description": "Unit price in INR."
          }
        },
        "required": [
          "name",
          "units",
          "selling_price"
        ]
      }
    },
    "payment_method": {
      "type": "string",
      "description": "COD or Prepaid. Required."
    },
    "sub_total": {
      "type": "number",
      "description": "Order value in INR (sum of line items). Required. Owner policy headers gate this amount before the order is created."
    },
    "length": {
      "type": "number",
      "description": "Parcel length in CENTIMETRES (cm). Required, > 0.5."
    },
    "breadth": {
      "type": "number",
      "description": "Parcel breadth in CENTIMETRES (cm). Required, > 0.5."
    },
    "height": {
      "type": "number",
      "description": "Parcel height in CENTIMETRES (cm). Required, > 0.5."
    },
    "weight": {
      "type": "number",
      "description": "Parcel weight in KILOGRAMS (kg). Required, > 0."
    }
  },
  "required": [
    "pickup_location",
    "billing_customer_name",
    "billing_address",
    "billing_city",
    "billing_pincode",
    "billing_state",
    "billing_email",
    "billing_phone",
    "order_items",
    "payment_method",
    "sub_total",
    "length",
    "breadth",
    "height",
    "weight"
  ]
}

query_tracking

Track an India shipment by its shipment_id (the one create_shipment returned) or by AWB number. Returns the current courier status plus a plain-English hint. Common Shiprocket statuses: NEW, PICKUP SCHEDULED, PICKED UP, IN TRANSIT, OUT FOR DELIVERY, DELIVERED, UNDELIVERED, RTO INITIATED, RTO DELIVERED, CANCELED, LOST. The raw tracking_data (scan activities, EDD, courier) is always included. Non-terminal statuses carry next_steps. Safe to call anytime. NOTE: a brand-new order shows no tracking until a courier/AWB is assigned.

Parameters2

shipment_id	string	optional	The shipment_id returned by create_shipment (preferred).
awb	string	optional	Alternative to shipment_id: the AWB / tracking number assigned by the courier.

Raw schema

{
  "type": "object",
  "properties": {
    "shipment_id": {
      "type": "string",
      "description": "The shipment_id returned by create_shipment (preferred)."
    },
    "awb": {
      "type": "string",
      "description": "Alternative to shipment_id: the AWB / tracking number assigned by the courier."
    }
  }
}

cancel_shipment

Cancel one or more India Shiprocket orders by their Shiprocket order id(s). Pass a single order_id or an array of ids. Cancellation is only possible before the parcel is picked up / in transit — an already-shipped order cannot be cancelled here (it would need an RTO). Returns the cancellation result reported by Shiprocket.

Parameters2

order_id	string	optional	A single Shiprocket order id to cancel (the numeric id Shiprocket returned, not your own reference).
order_ids	array	optional	Alternative: an array of Shiprocket order ids to cancel in one call.

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "A single Shiprocket order id to cancel (the numeric id Shiprocket returned, not your own reference)."
    },
    "order_ids": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Alternative: an array of Shiprocket order ids to cancel in one call."
    }
  }
}

README.md6 KBView on GitHub

India Logistics MCP 🇮🇳 — How can my AI agent ship a parcel across India (Delhivery / Bluedart / Ekart via Shiprocket)?

Use it in 60 seconds

Paste this into your MCP client config (Claude Desktop, Cursor, Windsurf, or any MCP-capable agent):

json

{
  "mcpServers": {
    "india-logistics": {
      "type": "http",
      "url": "https://logi-in.wishpool.app/mcp"
    }
  }
}

Nothing to install. Credentials, when you need them, travel as HTTP headers on each request and are never stored — see the threat model.

Or run it yourself

Would you rather not send production credentials to a server you do not control? Deploy this identical code to your own account and point your agent at your own URL:

bash

git clone https://github.com/junter1989k-ai/india-logistics-mcp && cd india-logistics-mcp && npx vercel --prod

MIT-licensed. Self-hosting removes us from the picture entirely, at no cost and with no loss of function.

Remote MCP server that lets any AI agent ship parcels across India — over Delhivery, Bluedart, Ekart, Xpressbees, DTDC and more — through the Shiprocket shipping API. Check courier serviceability + live rates by pincode, create shipping orders, track parcels by AWB, and cancel orders. Stateless, bring-your-own merchant credentials, never stores anything.

Live endpoint: https://logi-in.wishpool.app/mcp · Registry: app.wishpool/india-logistics-mcp

Quick start

json

{
  "mcpServers": {
    "india-logistics": {
      "type": "http",
      "url": "https://logi-in.wishpool.app/mcp",
      "headers": {
        "x-shiprocket-email": "your_api_user@example.com",
        "x-shiprocket-password": "your_api_user_password"
      }
    }
  }
}

No shared demo — use your own Shiprocket account. Create an API user in the Shiprocket dashboard (Settings → API → Configure / Create an API User) and send its email + password in the headers above. The server is stateless: on every call it exchanges the credentials for a short-lived Bearer token at Shiprocket's /auth/login and stores nothing. Real shipping requires completed merchant KYC (Aadhaar/GSTIN) and at least one registered pickup location — merchant-side prerequisites.

Tools

Tool	What it does
`check_serviceability`	Call this first. Given `pickup_postcode`, `delivery_postcode`, `weight` (kg) and `cod`, returns every serviceable courier (Delhivery, Bluedart, Ekart, Xpressbees, DTDC…) with its `rate` (INR), `estimated_delivery_days` and rating, and flags the cheapest. Read-only — quotes only, spends nothing.
`create_shipment`	Create a Shiprocket adhoc order. `pickup_location` (a nickname already registered in your dashboard) + buyer address + `order_items` (`name`/`units`/`selling_price`) + `payment_method` (COD/Prepaid) + `sub_total` (INR) + parcel box `length`/`breadth`/`height` (cm) + `weight` (kg). Returns `order_id`, `shipment_id`, `status`. Creating the order does not charge your wallet — that happens when a courier/AWB is assigned.
`query_tracking`	Track by `shipment_id` (preferred) or `awb`. Returns `current_status` from the Shiprocket set — `NEW` / `PICKUP SCHEDULED` / `PICKED UP` / `IN TRANSIT` / `OUT FOR DELIVERY` / `DELIVERED` / `UNDELIVERED` / `RTO INITIATED` / `RTO DELIVERED` / `CANCELED` / `LOST` — plus a plain-English hint; non-terminal statuses carry `next_steps`. Raw `tracking_data` always included.
`cancel_shipment`	Cancel one or more Shiprocket orders by their Shiprocket `order_id` (or `order_ids` array). Only works before pickup — an already-shipped order needs an RTO.

Owner policy guardrails ride optional headers (x-agentpay-max-amount, x-agentpay-approval-above, x-agentpay-allowed-tools) — set by the human owner in client config; the agent cannot relax them. The order value (INR) is gated before the order is created: approval-above returns an unsigned draft with no order created.

Units

Weight in kilograms (kg), parcel box dimensions in centimetres (cm), money in INR.

Develop

bash

node test/serve.js   # local server on :3246 (/mcp)
node test/e2e.js     # protocol + validation + policy/shiprocket units + fake-credential live probe to apiv2.shiprocket.in (expects native 403)

How it talks to Shiprocket

Every tool call is two server-to-server requests: first POST /v1/external/auth/login ({ email, password } → { token }), then the business endpoint with Authorization: Bearer <token> — the token is never cached (stateless). check_serviceability is GET /v1/external/courier/serviceability/?pickup_postcode=&delivery_postcode=&weight=&cod=. create_shipment is POST /v1/external/orders/create/adhoc. query_tracking is GET /v1/external/courier/track/shipment/{shipment_id} (or /track/awb/{awb}). cancel_shipment is POST /v1/external/orders/cancel ({ ids: [...] }). Base URL https://apiv2.shiprocket.in.

Safety

Pure stateless translation layer. Orders, labels and tracking are held by Shiprocket and the couriers; the merchant credentials travel per-request in headers, are exchanged for a short-lived token, and nothing is stored. Parcels flow sender ↔ courier ↔ recipient directly. Privacy policy.

Sister servers

USA labels (USPS/UPS/FedEx) via EasyPost live in usa-logistics-mcp; Taiwan CVS pickup + home delivery in taiwan-logistics-mcp. One family of stateless BYO local-commerce MCP servers: local payments in 81 countries at mcp.wishpool.app, plus electronic-invoice servers across nine countries including India GST, Mexico CFDI, Brazil NF-e, Chile DTE and Peru CPE.

MIT licensed.

Install

Tools (4)

check_serviceabilitycreate_shipmentquery_trackingcancel_shipment

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://logi-in.wishpool.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "india-logistics-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://logi-in.wishpool.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.