app.wishpool/india-logistics-mcp Model Context Protocol (MCP) Server

This MCP server provides India shipping capabilities for AI agents. It supports Shiprocket courier serviceability checks, creating shipping orders, and tracking parcels using AWB (air waybill) details. The server is exposed over HTTP and is intended for MCP-capable clients.

🛠️ Key Features

India shipping integration for AI agents
Shiprocket courier serviceability
Create orders
Track AWB

🚀 Use Cases

Determine whether a courier can serve a given shipment route
Generate shipping orders for parcels
Retrieve tracking information by AWB

⚡ Developer Benefits

HTTP-based MCP server endpoint (https://logi-in.wishpool.app/mcp)
Credentials, when required, are sent as HTTP headers on each request
Does not store credentials (per the provided threat model reference)

⚠️ Limitations

Limited to the functions described: serviceability, order creation, and AWB tracking
Installation steps and further runtime details are not fully present in the excerpt

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.

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.

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.

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

app.wishpool/india-logistics-mcp Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Related Topics

Topics

check_serviceability

create_shipment

query_tracking

cancel_shipment