MCP SERVERRun a Shiprocket seller account end to end: quote couriers for a route, create the order, assign a courier, book the pickup, pull the label and track the parcel.
LABSCO SUMMARY
The rate calculator is the useful centre of the set: couriers, prices and delivery dates for a route come back before the order exists, so the choice can be made against numbers and then applied with order_ship. Read this as a write-capable integration rather than a reporting one — order_create, order_ship, order_schedule_pickup and order_cancel all change what happens to a live shipment.
A seller-side server over Shiprocket, ten tools spanning rate quotes, order creation, courier assignment, pickup scheduling, labels and tracking.
A Shiprocket seller account for the server to act as, and at least one pickup address registered on it: order_create takes a pickup_location_nickname, and list_pickup_addresses is where those nicknames come from.
Build from source — git clone https://github.com/bfrs/shiprocket-mcp.git
USE CASES
Ask which couriers serve the route with their prices and delivery dates for the weight and payment mode in question, or take the estimated date alone when the customer only wants to know when it lands.
Pick the pickup location by its nickname, create the order with the customer, address, items and dimensions, assign a courier, book the pickup date, and generate the label that goes on the box.
Track by AWB number for the status, last activity and last scan location, and list orders by stage when the question is about the whole day's shipments rather than one of them.
Find it among the orders not yet in transit, then cancel it — optionally on the sales channel it originated from as well, so the two systems do not disagree.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
estimated_deliveryGet the Estimated Date of Delivery (EDD) for a given destination.
Args: delivery_pincode: String representing pincode of order delivery destination
Returns: Dictionary containing following info: estimated_delivery_date: Date-time formatted string representing expected date & time of delivery delivery_pincode: String representing pincode of order delivery destination
generate_shipment_labelGenerate shipment label and get the link of generated label as PDF file
Returns: file_url: String representing URL of generated label
list_pickup_addressesGet all the pickup address of the seller
Returns: List of dictionary representing pickup addresses of seller with following info: pickup_address_id: Number representing pickup address ID pickup_location_nickname: String representing short nickname of pickup location address: String representing pickup address line city: String representing pickup address city state: String representing pickup address state country: String representing pickup address country pincode: 6-digit number representing pickup address pincode
order_cancelCancel order
Args: order_id: Number representing order ID cancel_on_channel: Optional boolean representing if the order should also be cancelled on the original channel
Returns: Dictionary containing success status and a status message
order_createCreate order
Args: pickup_location_nickname: String representing short nickname of pickup location customer_name: String representing name of the customer who placed order customer_email: String representing email of the customer who placed order customer_phone: 10-digit number representing phone number of the customer who placed order delivery_address: String representing customer address on which order will be delivered delivery_city: String representing city of delivery address delivery_pincode: 6-digit number representing pincode of delivery address delivery_state: String representing state of delivery address delivery_country: String representing country of delivery address length: Number representing length of the order package in centimeters breadth: Number representing breadth of the order package in centimeters height: Number representing height of the order package in centimeters weight: Number representing wight of the order package in kilograms mode_of_payment: Enum('COD', 'PREPAID') representing mode of payment for the order order_items: List of dictionary containing following info of each product in the order: name: String representing name of the product item sku: String representing SKU of the product item units: Number representing quantity of product ordered selling_price: Number representing price of product ordered
Returns: Dictionary containing success status and a status message
order_listGet list of orders
Args: status: Optional ENUM('NEW', 'READY_TO_SHIP', 'IN_TRANSIT', 'DELIVERED') representing status filter for orders
order_schedule_pickupSchedule pickup for the order shipment
Args: order_id: Alphanumeric ID which can be 'Order ID' or 'Channel Order ID' or 'Shipment ID' pickup_date: Date formatted ('YYYY-MM-DD') string representing date on which pickup will be scheduled
Returns: Dictionary containing success status and a status message
order_shipShip order by assigning courier to the order
Args: order_id: Alphanumeric ID which can be 'Order ID' or 'Channel Order ID' or 'Shipment ID' courier_id: Optional number representing courier ID to assign shipment
Returns: Dictionary containing success status and a status message
order_trackGet order tracking related information.
Args: awb_number: String representing AWB number assigned to the order
Returns: Dictionary containing following info: order_status: String representing order status awb_number: String representing AWB number of order last_activity: String representing last marked activity of order last_scan_location: String representing last marked location of order last_scan_time: Timestamp formatted string representing last order scan timestamp tracking_url: String representing URL of order tracking page
shipping_rate_calculatorGet serviceable shipping couriers, their prices and EDDs (Estimated Delivery Dates).
Args: pickup_postcode: String representing pincode of order pickup location delivery_postcode: String representing pincode of order delivery location weight_in_kg: String representing weight of the order package cod_or_prepaid: Enum('COD', 'PREPAID') representing mode of payment of the order
Returns: List of dictionary containing following info: courier_name: String representing name of the courier cutoff_time: String representing time deadline for etd: Date-time formatted string representing expected date & time of delivery freight_charge: Number represeting cost of shipment in Indian Rupees transport_mode: Enum('SURFACE', 'AIR') representing mode of transport rto_charges: Number represeting the cost (in Indian Rupees) associated with return shipment if order gets RTO
BEFORE YOU INSTALL
10 tools when we connected. Two tools are named differently from the documentation: call estimated_delivery and order_schedule_pickup, not estimated_date_of_delivery and order_pickup_schedule.
Both documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 10 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Clone the repository
git clone https://github.com/bfrs/shiprocket-mcp.git
cd shiprocket-mcpInstall dependencies and build
npm install
npm run build{
"mcpServers": {
"Shiprocket": {
"command": "npm",
"args": [
"--prefix",
"<YOUR_PATH_TO_SRC>",
"start",
"--silent"
],
"env": {
"SELLER_EMAIL": "<YOUR_SELLER_EMAIL>",
"SELLER_PASSWORD": "<YOUR_SELLER_PASSWORD>"
}
}
}
}<YOUR_PATH_TO_SRC> is the full path of the shiprocket-mcp folder you cloned and built above — npm --prefix runs the server’s start script from that folder.
MCP servers
kuaidi100-api
shipb
trackmage
vinaybhosle