# DHL MCP

> DHL MCP gives your AI agent real-time access to DHL's global logistics network. You can track shipments across customs checkpoints, instantly quote international shipping rates, and even generate labels for outbound packages without leaving your chat window.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** tracking, shipment-management, logistics-api, supply-chain-visibility, freight-quotes, delivery-status

## Description

Managing global supply chains means dealing with mountains of data: tracking numbers, fluctuating quotes, and compliance checks. This MCP connects any compatible AI client directly to the DHL Express Enterprise API. You can ask your agent to track a package by its number, get instant cost comparisons for different shipping methods, or verify if an address will actually work cross-border. It handles everything from calculating customs documentation to finding the nearest drop-off point. Everything is exposed through Vinkius's catalog, so you don't need to learn a new dashboard—you just tell your AI client what you need done. The result is deep visibility into any shipment's status, whether it's sitting in customs or ready for final delivery.

## Tools

### create_shipment
Generates a complete DHL shipment label, returning the tracking number and required documentation URL for outbound packages.

### find_locations
Looks up nearby official DHL service points, including their addresses, current opening hours, and available drop-off services.

### get_proforma_invoice
Retrieves the necessary proforma invoice document, useful for customs documentation or proving shipment value.

### get_rates
Compares shipping costs and transit times across various DHL services (Express Worldwide, Economy Select) based on package details and addresses.

### track_shipment
Provides the current status and detailed checkpoint history for any international or domestic delivery using a tracking number.

### validate_address
Checks an entered shipping address against DHL standards, returning a standardized format and suggesting corrections to prevent failed deliveries.

## Prompt Examples

**Prompt:** 
```
Investigate the real-time exact customs and logistics status for DHL waybill 1928374650.
```

**Response:** 
```
I checked DHL's core network. Shipment 1928374650 is currently at 'Customs clearance status updated' in Cincinnati Hub, USA. It's scheduled for delivery tomorrow before end of day.
```

**Prompt:** 
```
Evaluate the logistics rates for sending a 5-kilogram package from ZIP 10001 (US) to ZIP 80331 (DE).
```

**Response:** 
```
For a 5kg package from US (10001) to Germany (80331), DHL Express Worldwide costs approximately $145.20 USD with a 2-day transit time. Economy Select costs $89.50 with a 5-day transit.
```

**Prompt:** 
```
Where is the closest official DHL drop-off service center near ZIP 90210?
```

**Response:** 
```
The nearest official DHL Service Point to 90210 is located on Santa Monica Blvd, 1.2 miles away. It accepts drop-offs until 6:00 PM local time today.
```

## Capabilities

### Track Live Shipments
Monitor a package’s exact location and checkpoint status using only its tracking number.

### Calculate Shipping Costs
Determine the fastest and cheapest shipping option by comparing real-time quotes for specific routes and weights.

### Create Outbound Labels
Generate necessary labels and tracking numbers to dispatch a new shipment automatically.

### Verify Addresses
Check if a full mailing address is valid before attempting to ship, preventing costly delivery failures.

### Locate Service Points
Find the operating hours and location of any nearby DHL drop-off or pickup center.

## Use Cases

### Handling a Customer Inquiry about a Delay
A customer texts: 'Where is my order 1234?' Your agent uses `track_shipment` and replies immediately with the current status, knowing if it's stalled in customs or nearing delivery.

### Quoting a Client for Cross-Border Goods
An analyst needs to quote shipping from Miami to Berlin. They prompt their agent to use `get_rates`, providing the package size and weight, getting instant cost comparisons across multiple service tiers.

### Preparing a Shipment for an Unfamiliar ZIP Code
A seller is sending goods to a new state. They first run `validate_address` using the target ZIP code. The MCP confirms the address format is correct, preventing a failed delivery attempt.

### Coordinating Local Pickup Points
An office manager needs to send several packages today. She uses `find_locations` to identify the closest DHL service center that's open until 6 PM and generates labels using `create_shipment`.

## Benefits

- Instantly know where a package is. Instead of logging into a separate tracking website, use the `track_shipment` tool to get real-time status and checkpoint history directly from your agent.
- Avoid delivery failures. Before committing to a shipment, run `validate_address` with any potential destination address to ensure it meets DHL's standards—no guesswork required.
- Compare costs without leaving the chat. Use `get_rates` to compare Express Worldwide vs. Economy Select options instantly, factoring in weight and dimensions for accurate quoting.
- Automate dispatching labels. When you confirm a sale, simply trigger `create_shipment`. The agent handles generating the label document URL and the official tracking number.
- Plan logistics runs efficiently. Use `find_locations` to quickly pinpoint the nearest service point's hours and address when coordinating physical package drops or pickups.

## How It Works

The bottom line is that you interact with complex logistics processes using simple conversation prompts instead of navigating multiple external websites and forms.

1. Subscribe to this MCP and provide your DHL App credentials (Client ID, Secret, Account Number) through Vinkius.
2. Invoke a function using natural language prompts in your AI client, specifying the required details like tracking numbers or origin/destination ZIP codes.
3. Receive structured data from DHL—whether it's a current status update, a generated label URL, or a rate quote.

## Frequently Asked Questions

**How do I use DHL MCP to track my package?**
You use the `track_shipment` tool by providing your 10-digit tracking number. The agent returns the current status, including detailed checkpoints and estimated delivery times.

**Can DHL MCP calculate shipping costs for me?**
Yes, you use the `get_rates` tool. Just give your agent the origin, destination, package weight, and dimensions, and it compares multiple services instantly.

**Do I need to manually generate labels after using DHL MCP?**
No. You simply ask the agent to 'create a shipment,' triggering the `create_shipment` tool which handles label generation and returns the tracking number immediately.

**What if my address is wrong? Does DHL MCP help?**
Absolutely. Before shipping, use `validate_address`. This tool checks your full mailing details against official standards and suggests corrections to prevent delivery failure.

**Does DHL MCP tell me where the nearest drop-off point is?**
Yes, run `find_locations` by providing a ZIP code. The agent retrieves nearby service points, including their operating hours and services available today.