Summary
Shiprocket API for Indian e-commerce shipping: orders and shipments, courier serviceability and rates, tracking by AWB, shipment or order, NDR, pickup locations, channels, products, inventory, wallet balance and statement, labels and invoices. Creating orders, AWB, pickups, cancellations and NDR actions installed switched off. API user email and password.
Guided setup
Connect Shiprocket to Gemini in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Shiprocket in the guided setup, then add your MCP URL to Gemini. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Shiprocket
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Shiprocket, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Shiprocket + Gemini
Shiprocket API for Indian e-commerce shipping: orders and shipments, courier serviceability and rates, tracking by AWB, shipment or order, NDR, pickup locations, channels, products, inventory, wallet balance and statement, labels and invoices. Creating orders, AWB, pickups, cancellations and NDR actions installed switched off. API user email and password.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
SHIPROCKET_EMAIL, SHIPROCKET_PASSWORD
Step 1 — Get credentials
Setting up takes about 3 minutes.
- Sign in at https://app.shiprocket.in and open Settings, API, Add New API User (Configure).
- Click Create API User, enter an email address that is different from your Shiprocket login, choose the modules the user may access and whether it may see buyer details, then click Create User.
- Copy the API user's password right away (it is shown once). Paste the API user's email into
SHIPROCKET_EMAILand the password intoSHIPROCKET_PASSWORD.
The connector signs in at POST /auth/login and reuses the token, which Shiprocket keeps valid for 10 days, signing in again before it expires. Your main login does not work here: use the API user.
Where to start: shiprocket_list_orders (newest first), then shiprocket_get_order for the shipment, AWB and courier. Tracking: shiprocket_track_awb.
Orders and shipments: shiprocket_list_orders, shiprocket_get_order, shiprocket_list_shipments, shiprocket_get_shipment. Two ids matter: the Shiprocket order id (id) used by every tool, and your own channel_order_id. An order has one shipment (shipment_id), which gets an AWB when a courier is booked.
Rates and couriers: shiprocket_check_serviceability lists the couriers between two pincodes with rate, estimated days and rating; shiprocket_list_couriers your enabled couriers.
Tracking: shiprocket_track_awb, shiprocket_track_awbs (up to 50), shiprocket_track_shipment, shiprocket_track_order. Undelivered parcels: shiprocket_list_ndr, shiprocket_get_ndr.
Account: shiprocket_get_wallet_balance, shiprocket_get_statement, shiprocket_list_pickup_locations, shiprocket_list_channels, shiprocket_list_products, shiprocket_get_inventory, shiprocket_get_postcode_details. Documents: shiprocket_generate_label and shiprocket_generate_invoice answer a link to the PDF (free, for shipments that already have an AWB).
Shipping (installed switched off): the usual flow is shiprocket_create_order, shiprocket_check_serviceability, shiprocket_assign_awb (charges the wallet), shiprocket_request_pickup, then the label. shiprocket_cancel_orders, shiprocket_cancel_shipments and shiprocket_ndr_action (a return is charged as RTO) are switched off as well. Turn them on only for workspaces that ship through Shiprocket, and confirm each call with the user.
Units and pitfalls: weight in kg, sizes in cm, money in INR, pincodes have 6 digits. Dates are YYYY-MM-DD; times in answers are India time (IST). Order lists are paged with page and per_page. A 422 names the missing or wrong field.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell) —anythingmcpshould show as connected. - Start prompting — Gemini CLI can now call the
Shiprockettools.
Available tools
| Tool | What it does |
|---|---|
shiprocket_list_orders | List orders, newest first: id (Shiprocket order id), channel_order_id (your order id), channel_name, customer name, email, phone and… |
shiprocket_get_order | Read one order by its Shiprocket order id: customer and billing details, pickup location, products (name, sku, quantity, price), payment… |
shiprocket_list_shipments | List shipments: id (shipment id), order_id, channel_order_id, awb, courier, status, pickup and delivery dates, weight, dimensions, charges.… |
shiprocket_get_shipment | Read one shipment by shipment id: order, AWB, courier, status, weight and dimensions, charges, pickup and delivery dates. Read-only |
shiprocket_check_serviceability | Couriers that can carry a parcel between two pincodes, with rates: per courier courier_company_id, courier_name, rate (INR) and freight and… |
shiprocket_list_couriers | The couriers of your account: courier id, name, type, active status and service details, with a total count. Read-only |
shiprocket_track_awb | Track a shipment by AWB: track_status, shipment_status, current_status (e.g. Delivered, In Transit, RTO), courier_name, origin… |
shiprocket_track_awbs | Track up to 50 shipments at once by AWB: per AWB the same tracking data as shiprocket_track_awb. Read-only |
shiprocket_track_shipment | Track a shipment by shipment id (same data as shiprocket_track_awb). Read-only |
shiprocket_track_order | Track the shipments of an order by your channel order id, with the channel id when the same order id exists in several channels. Read-only |
shiprocket_list_pickup_locations | Your pickup addresses: id, pickup_location (the name used on orders), name, phone, email, address, city, state, pin_code, status and… |
shiprocket_list_ndr | Shipments in NDR (non-delivery report: the courier could not deliver): AWB, order, customer, attempts, NDR reason and history, and the date… |
shiprocket_get_ndr | Read the NDR details of one shipment by AWB: attempts, reasons, customer details and history. Read-only |
shiprocket_get_wallet_balance | Your Shiprocket wallet balance in INR (balance_amount). Shipping charges are taken from it. Read-only |
shiprocket_get_statement | Your account statement: wallet credits and debits per shipment or recharge, with date, amount, AWB and description. Paged. Read-only |
shiprocket_list_channels | Your sales channels (custom, Shopify, WooCommerce, Amazon...): id, name, status, base channel and sync settings. Read-only |
shiprocket_list_products | Products in your Shiprocket catalog: id, name, sku, category, price, weight, dimensions and HSN. Paged. Read-only |
shiprocket_get_inventory | Inventory per product SKU: sku, name, quantity on hand and available. Paged. Read-only |
shiprocket_get_postcode_details | City, state and country of an Indian pincode, and its localities. Read-only |
shiprocket_generate_label | Generate the shipping label PDF for shipments that already have an AWB: label_url (a link to the PDF), label_created and the shipment ids… |
shiprocket_generate_invoice | Generate the invoice PDF for orders: invoice_url (a link to the PDF), is_invoice_created and the order ids not created. Costs nothing |
shiprocket_create_order | Create a custom (adhoc) order with its shipment record. Installed switched off. The order object follows Shiprocket's create/adhoc model… |
shiprocket_assign_awb | Book a courier for a shipment: assigns the AWB and charges the shipping cost to your wallet. Installed switched off. Without courier_id… |
shiprocket_request_pickup | Request a courier pickup for one shipment that has an AWB. The courier is scheduled for the next working day or pickup_date. Installed… |
shiprocket_cancel_orders | Cancel orders by Shiprocket order id. Cannot be undone; a shipment already picked up is not stopped. Installed switched off |
shiprocket_cancel_shipments | Cancel shipments by AWB before they are out for pickup (up to 2000 at once). Installed switched off |
shiprocket_ndr_action | Act on an NDR shipment: re-attempt delivery (optionally with a new phone, address or date) or return it to origin, which is charged as RTO.… |
Example prompts
- "Track AWB 1234567890123 and tell me when it will be delivered."
- "Which couriers can deliver a 1.5 kg COD parcel from 110001 to 560001, and at what rate?"
- "Which shipments are in NDR right now, and why?"
- "What is my Shiprocket wallet balance, and what was charged this week?"
- "Show today's orders that still have no AWB."
FAQ
Which login does it use? An API user you create under Settings, API, Add New API User, with an email that differs from your main Shiprocket login. Its password is shown once.
What does it cover? Orders and shipments, courier serviceability and rates, tracking by AWB, shipment or order, NDR, pickup locations, channels, products, inventory, wallet balance and statement, labels and invoices.
Which tools install switched off? shiprocket_create_order, shiprocket_assign_awb (charges the wallet), shiprocket_request_pickup, shiprocket_cancel_orders, shiprocket_cancel_shipments and shiprocket_ndr_action. Switch them on on the connector page only if the AI should book or cancel shipments.
Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.
Next steps
Was this guide helpful?