--- title: "Delhivery One MCP: Setup, Use Cases & Example" slug: "delhivery-one-mcp-setup-use-cases-example" updated: 2026-11-05T07:32:15Z published: 2026-11-05T07:32:15Z canonical: "help.delhivery.com/delhivery-one-mcp-setup-use-cases-example" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.delhivery.com/llms.txt > Use this file to discover all available pages before exploring further. # Delhivery One MCP: Setup, Use Cases & Example Connect your AI assistant to your Delhivery One account through the Model Context Protocol (MCP). Track shipments, compare shipping rates, resolve failed deliveries, review pickup requests and pickup locations, look up orders, check your wallet balance and follow up on support tickets, all by simply asking. Works with Claude Desktop, Claude Code, OpenAI Codex, Cursor, Kiro and any MCP-compatible client. Direct connection from the Claude and ChatGPT chat apps is coming soon. ## What you can do - **Track shipments.** Get the status and full scan history of any AWB, or search all your shipments by status, mode, payment type or date. Find B2B (LTL) shipments by LRN. - **Compare rates.** Quote one parcel or many at once, Surface or Express, prepaid or COD, using your contracted rate card. - **Resolve NDRs.** Find failed deliveries and other exceptions with their reason and SLA, and request a reattempt, return to origin (RTO), or repack and deliver. - **Manage pickups.** Review pickup requests and their status, see the full history of any pickup and why it failed, and check your pickup locations, addresses and working hours. - **Review orders.** Search domestic and international orders and open the details of any order. - **Check wallet and support.** See your wallet balance and limits, and your support tickets with their latest replies. ## Get started Setup takes a few minutes and follows the same steps as **Settings → API & MCP Setup** in the Delhivery One platform. ### Step 1: Check requirements Make sure you have: - A Delhivery One account with access to **Settings → API & MCP Setup**. - A supported AI client: Claude Desktop, Claude Code, OpenAI Codex, Cursor, Kiro or another MCP-compatible client. - uv installed. uv provides everything the server needs, so you don't need to install Python or Node.js. For other platforms, see the uv installation guide (docs.astral.sh/uv). ```bash # macOS (Homebrew) brew install uv # Any platform with pip pip install uv # Verify the installation uvx --version ``` ### Step 2: Copy your configuration In the Delhivery One platform, go to **Settings → API & MCP Setup** and copy your MCP configuration. Your account credentials are pre-filled. The configuration looks like this. The `command` and `args` values are the same for every account. All environment variables are specific to your account and are filled in for you. ```json { "mcpServers": { "delhivery-one": { "command": "uvx", "args": ["d1-mcp-mint@latest"], "env": { "D1_CLIENT_ID": "", "D1_CLIENT_SECRET": "", "D1_AUTH_URL": "", "D1_REALM": "", "D1_CLIENT_CMS": "", "D1_MCP_URL": "" } } } } ``` | Variable | Description | | --- | --- | | `D1_CLIENT_ID` | Your account's API client ID | | `D1_CLIENT_SECRET` | Your account's API client secret | | `D1_AUTH_URL` | The sign-in server for your account | | `D1_REALM` | Your account's sign-in realm | | `D1_CLIENT_CMS` | Your Delhivery client ID | | `D1_MCP_URL` | The Delhivery One MCP server address for your account | > Keep your client secret private. Don't share it or commit it to a code repository. ### Step 3: Add the configuration to your AI client | Client | Where to add it | | --- | --- | | Claude Desktop | `claude_desktop_config.json` | | Claude Code | `claude mcp add-json` command | | OpenAI Codex | `~/.codex/config.toml` | | Cursor | `~/.cursor/mcp.json` or `.cursor/mcp.json` in your project | | Kiro | `~/.kiro/settings/mcp.json` or `.kiro/settings/mcp.json` in your workspace | | Other MCP clients (Hermes, Claw, Muse) | The client's MCP settings | #### Claude Desktop 1. Open the Claude Desktop configuration file: - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` 2. Paste the `delhivery-one` entry from your configuration under `mcpServers`. 3. Save the file, then quit and reopen Claude Desktop. #### Claude Code In your terminal, run: ```bash claude mcp add-json delhivery-one '{"command":"uvx","args":["d1-mcp-mint@latest"],"env":{"D1_CLIENT_ID":"","D1_CLIENT_SECRET":"","D1_AUTH_URL":"","D1_REALM":"","D1_CLIENT_CMS":"","D1_MCP_URL":""}}' ``` To confirm the server is registered, run `claude mcp list`. #### OpenAI Codex Add the following to `~/.codex/config.toml`, then restart Codex: ```toml [mcp_servers.delhivery-one] command = "uvx" args = ["d1-mcp-mint@latest"] [mcp_servers.delhivery-one.env] D1_CLIENT_ID = "" D1_CLIENT_SECRET = "" D1_AUTH_URL = "" D1_REALM = "" D1_CLIENT_CMS = "" D1_MCP_URL = "" ``` #### Cursor Paste your configuration into `~/.cursor/mcp.json` to use it in every project, or into `.cursor/mcp.json` to use it in one project. #### Kiro Paste your configuration into `~/.kiro/settings/mcp.json` to use it in every workspace, or into `.kiro/settings/mcp.json` to use it in one workspace. #### Other MCP clients Hermes, Claw, Muse and other agents that support local (stdio) MCP servers use the same command, arguments and environment variables. Add them in the client's MCP settings. Dedicated guides will be added as these clients are verified. ### Step 4: Restart and verify Restart your AI client or refresh its MCP servers. Confirm that the `delhivery-one` server shows as **Connected** or **Running**. ### Step 5: Start asking You're all set. Try one of these: - *"Show my recent shipments."* - *"What is my Delhivery One wallet balance?"* - *"Show my pickup requests for today and their status."* - *"List my open support tickets."* ## Tools You don't need to call tools by name. Your assistant picks the right one from your request. ### Shipments | Tool | Description | | --- | --- | | `get-shipment-details-by-awb` | Shipment details by AWB: status, addresses, weight, payment and delivery attempts. | | `get-awb-transit-history` | Full scan history for an AWB. | | `shipment-search` | Search and filter shipments by AWB, order, status, mode, payment type or date. | | `lrn-shipment-search` | Find B2B (LTL) shipments by LRN. | ### Exceptions and NDR | Tool | Description | | --- | --- | | `list-exceptions` | List failed deliveries and other exceptions with reason, SLA and available actions. | | `update-exceptions` | Request a reattempt, return to origin, or repack and deliver. | ### Rates and wallet | Tool | Description | | --- | --- | | `bulk-rate-calculator` | Shipping rates for one or many B2C parcels. | | `get-wallet-details` | Wallet balance and limits. | ### Orders | Tool | Description | | --- | --- | | `list-sale-orders-es` | Search and list sale orders. | | `get-sale-order` | Details of a sale order. | | `list-starfleet-orders` | Search and list international orders. | ### Pickups | Tool | Description | | --- | --- | | `list-pickup-requests` | Search pickup requests and their status. | | `get-pickup-request-details` | Details and status history of a pickup request. | | `list-pickup-locations` | Your pickup locations, addresses and working hours. | ### Support and account | Tool | Description | | --- | --- | | `list-client-tickets` | Your support tickets and their status. | | `get-ticket-details` | Full details and replies for a ticket. | | `list-client-mappings` | Delhivery services active on your account. | ## Example prompts - *"What is the status of AWB 17837910080802? If it is delayed, tell me why."* - *"Compare Surface and Express rates for a 1 kg COD parcel from 110001 to 560001."* - *"How many NDRs are overdue? Group them by reason."* - *"Reattempt delivery for AWB 17837910080802."* - *"Which pickup locations had the most failed pickups in the last 30 days?"* - *"Show the status history of pickup request 308951247."* - *"Do I have any support tickets waiting for my reply?"* The workflows below show sample prompts with example responses. > Example responses use sample data. Shipping rates are estimates based on your contracted rate card. Review AI-generated recommendations before you act on them. ### 1. Compare shipping rates across routes Get estimated charges for several origin and destination pairs in one request. **Prompt** ```text Calculate shipping charges for a 500 g express, prepaid package on these routes. Show a table with total freight only: 560001 to 110001, 600001 to 122001, 641001 to 201301, 682001 to 302001, 530001 to 160017 ``` **Sample response** | Origin | Destination | Zone | Freight (₹) | Total with GST (₹) | | --- | --- | --- | --- | --- | | 560001 (Bengaluru) | 110001 (Delhi) | C | 58.00 | 72.82 | | 600001 (Chennai) | 122001 (Gurugram) | C | 58.00 | 72.82 | | 641001 (Coimbatore) | 201301 (Noida) | D | 73.00 | 91.04 | | 682001 (Kochi) | 302001 (Jodhpur) | D | 73.00 | 91.04 | | 530001 (Visakhapatnam) | 160017 (Chandigarh) | D | 73.00 | 91.04 | Totals include 18% GST (CGST plus SGST). Zone C routes cost less than Zone D in this sample. ### 2. Check shipment status and delay reasons Track one shipment, or search several at once, without looking up each AWB manually. **Prompt** ```text What is the current status of AWB 17837910080802? If it is delayed or undelivered, tell me why. ``` **Sample response** - **Status:** Lost. The shipment will not be delivered. - **Mode:** Surface, prepaid. Consignee in Chandigarh (160036). - **Why:** It was picked up on Jan 7 and never moved beyond its first facility. It was marked lost on Jan 17 with no delivery attempts. | Date | Event | | --- | --- | | Jan 7, 2026 | Manifest uploaded | | Jan 7, 2026 | Picked up at origin facility | | Jan 7, 2026 | Weight captured | | Jan 17, 2026 | Shipment marked lost | ### 3. Check wallet balance against planned shipping cost Find out before manifesting whether your wallet covers the freight. **Prompt** ```text What is my wallet balance? I plan to manifest 1,000 shipments of 2 kg each, via Express from Chennai to Bangalore. Calculate the total freight and tell me whether my balance is enough. ``` **Sample response** | Component (per shipment, Zone B, 2 kg) | Amount (₹) | | --- | --- | | Freight | 129.00 | | DPH charge | 3.82 | | CGST (9%) | 12.13 | | SGST (9%) | 12.13 | | **Total per shipment** | **159.08** | | For 1,000 shipments | Amount (₹) | | --- | --- | | Total freight cost | 1,59,080.00 | | Wallet balance | 505.38 | | **Shortfall** | **1,58,574.62** | The balance covers about 3 shipments. Top up by roughly ₹1,58,575 to manifest all 1,000. ### 4. Check support ticket status See open tickets and the latest update without opening the Support section. **Prompt** ```text Are there any support tickets raised for AWB 17837910004830? Give me the details. ``` **Sample response** | Field | Details | | --- | --- | | Status | Reopened | | Category | Claim LnD B2C | | Sub-category | Missing - In Transit | | Claim type | Lost in Network | | Priority | 3 | | Raised from | UCP | | Escalated | No | The ticket has one reply from Delhivery Customer Support. The shipment was classified as lost and the ticket was closed. Credit note (CN) or COF queries should be raised separately under Claims > CN/COF. The ticket was reopened after that reply. ### 5. Find problem shipments and next actions Let the assistant group shipments with failed attempts, exceptions or delays, and suggest what to do. **Prompt** ```text Analyze my shipments and find the ones with delivery issues. Group them by problem type, explain each issue, and recommend the next action. ``` **Sample response** | Priority | AWB | Issue | Recommended action | | --- | --- | --- | --- | | 1 | 17837910086634 | Lost, no insurance | Raise a loss claim immediately | | 1 | 17837910086623 | Lost, no insurance | Raise a loss claim immediately | | 2 | 17837910084836 | Lost, insured | File an insurance claim | | 3 | 17837910080824 | Overdue in transit, promised delivery date breached | Escalate the support ticket | | 3 | 17837910080802 | Overdue in transit, promised delivery date breached | Escalate the support ticket | | 4 | 17837910096946 | Cancelled | Confirm and close | For NDR shipments, the assistant can also help you decide between a delivery reattempt and a return to origin. ### 6. Find the cheapest pickup location for a destination If you ship from several warehouses, compare charges from each to one destination. **Prompt** ```text I want to ship a 500 g surface package to Bhopal. Show the top 3 cheapest pickup locations with prices. ``` **Sample response** | Rank | Pickup location | City | PIN | Zone | Total (₹) | | --- | --- | --- | --- | --- | --- | | 1 | Warehouse A | Gurgaon, Haryana | 122002 | D1 | 66.78 | | 2 | Warehouse B | Mumbai, Maharashtra | 400002 | D1 | 66.78 | | 3 | Warehouse C | Surat, Gujarat | 395007 | D1 | 66.78 | In this sample, 44 or more locations tie at ₹66.78. Locations in the northeast (Guwahati, Meghalaya, Mizoram) fall in Zone E and cost more, at ₹78.93. ### 7. Use the assistant as your logistics manager Ask for a consolidated summary of shipment performance, issues and priorities instead of reviewing shipments one by one. **Prompt** ```text Act as my logistics operations manager. Review my last 30 days of orders, shipments and pickups. Give me a short morning summary of what is going well, what needs attention, and the top 5 actions my team should take today. ``` **Sample response** | Area | Finding | | --- | --- | | Going well | Order volume is healthy (1,254 orders). Auto-dispatch routes most pickups without manual intervention. | | Needs attention | Of 38 pickup requests in the last 15 days, 23 were not picked (60%), 13 were cancelled (34%), 1 is in progress and none are completed. | | Needs attention | A series of COD orders flagged high RTO risk is stuck awaiting labels. Review before shipping. | | Needs attention | Wallet balance is ₹771.74, which is low for any meaningful shipment volume. | ### 8. Analyze pickup performance across locations Spot the pickup locations with repeated failures and see the reasons. **Prompt** ```text Analyze my pickup performance over the last 30 days. Highlight the key issues, what is going well, and what I should fix. ``` **Sample response** | Location | Issue | Fix | | --- | --- | --- | | Mumbai (400093) | 15+ consecutive failures: wrong address and shipper unreachable | Correct or deactivate the pickup address | | Goa (403002) | Repeated failures: regulatory paperwork insufficient | Sort the compliance documents before the next pickup | | Bangalore (560066) | Repeated failures: shipment not ready | Require seller readiness confirmation | | Thane (400601) | Pickups show 0 g weight and were never dispatched | Audit or deactivate the location | Overall in this sample: 66 requests, 0 successful pickups, 64% not picked, 20% cancelled. ## Security - Access uses an API credential issued to your company through the OAuth 2.0 client credentials flow. Your Delhivery One login password is never used or stored. - Every access token is tied to your company account, so every request returns only your account's data. - Review any action, such as a reattempt or return to origin, before you approve it in your AI client. - Keep your client secret private. Don't share your configuration or commit it to a code repository. ### How it works 1. Your AI client starts the Delhivery One MCP server locally with `uvx d1-mcp-mint@latest` and sends your request as a tool call over standard input/output (stdio). 2. The local server signs in at your account's auth URL (`D1_AUTH_URL`) with your account credentials and gets an access token. 3. The local server forwards the request to the Delhivery One MCP server (`D1_MCP_URL`), which runs the tool against your account's data. 4. The result returns to your AI client, and your assistant presents it to you. ## FAQ **Do I need Python or Node.js?** No. uv handles everything the server needs. **Do I need to enter credentials manually?** No. Your configuration in the Delhivery One platform under **Settings → API & MCP Setup** is pre-filled with your account's credentials. **Can I create orders or schedule pickups?** Not yet. These are coming in a future release. You can already review pickup requests and act on failed deliveries. **Can I connect from the Claude or ChatGPT apps?** Direct connection from the Claude and ChatGPT chat apps is coming soon. Today, use Claude Desktop, Claude Code or another supported client. **My assistant can't connect.** Run `uvx --version` to confirm uv is installed, check that you pasted the full configuration, and restart your client. If it still fails, contact your Delhivery account manager.