# India Logistics MCP

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

- MCP endpoint (Streamable HTTP): https://logi-in.wishpool.app/mcp
- Credential headers: x-shiprocket-email + x-shiprocket-password (your Shiprocket API-user email/password — create one in the dashboard: Settings -> API -> Configure/Create an API User). No shared demo merchant. Stateless: every call first exchanges the credentials for a short-lived Bearer token at https://apiv2.shiprocket.in/v1/external/auth/login, then calls the endpoint; nothing is cached or stored.
- Units: weight in KILOGRAMS (kg), parcel box dimensions in CENTIMETRES (cm), money in INR.
- Flow: check_serviceability (pickup_postcode + delivery_postcode + weight + cod -> serviceable couriers with rates + delivery days, cheapest flagged) -> create_shipment (pickup_location + buyer address + order_items + payment_method -> order_id + shipment_id) -> assign a courier / print the AWB (dashboard step; this is when the wallet is charged) -> query_tracking (by shipment_id or AWB). cancel_shipment cancels an order before pickup.

## Tools

- check_serviceability: THE tool to call first. Required: pickup_postcode, delivery_postcode, weight (kg). Optional: cod (bool), declared_value (INR). Returns every serviceable courier company (courier_company_id, courier_name, rate INR, estimated_delivery_days, rating), the cheapest, and serviceable=true/false. Read-only, spends nothing.
- create_shipment: Create a Shiprocket adhoc order. Required: pickup_location (a nickname already registered in your Shiprocket dashboard), billing_customer_name, billing_address, billing_city, billing_pincode, billing_state, billing_email, billing_phone, order_items (array of { name, units, selling_price, sku? }), payment_method (COD | Prepaid), sub_total (INR), length + breadth + height (cm) and weight (kg). Optional: order_id, order_date, billing_last_name/address_2/country, shipping_is_billing (default true) + shipping_* when false. Returns order_id, shipment_id, status. NOTE: creating the order does NOT charge the wallet — courier/AWB assignment (a later step) does.
- query_tracking: Track by shipment_id (preferred) or awb. Status enum (Shiprocket): NEW, PICKUP SCHEDULED, PICKUP GENERATED, PICKED UP, IN TRANSIT, OUT FOR DELIVERY, DELIVERED, UNDELIVERED, RTO INITIATED, RTO DELIVERED, CANCELED, LOST, DAMAGED — each with a plain-English hint; non-terminal statuses include next_steps. Raw tracking_data (scan activities, EDD, courier) always included. A brand-new order shows no tracking until a courier/AWB is assigned.
- cancel_shipment: Cancel one or more Shiprocket orders by their Shiprocket order id (order_id single, or order_ids array). Only works before pickup / while not shipped; an already-shipped order needs an RTO.
- Owner policy guardrails: x-agentpay-max-amount (hard cap on order value INR), x-agentpay-approval-above (returns an unsigned draft for human review — no order is created), x-agentpay-allowed-tools (tool allow-list) — set by the human owner in the MCP client config; the agent cannot relax them. The order value is gated before creation.

## Safety

Stateless translation layer. Shiprocket credentials travel per-request in headers, are exchanged for a short-lived token, and are never stored; orders, labels and tracking are held by Shiprocket and the couriers, never here. Parcels flow sender <-> courier <-> recipient directly. Real shipping requires completed merchant KYC (Aadhaar/GSTIN) and a registered pickup location. Privacy policy: https://logi-in.wishpool.app/privacy

## Sister servers

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