# DHL MCP MCP

> DHL MCP connects your AI agent directly to global logistics operations. You can instantly track any shipment worldwide, quote Express Worldwide or Economy rates for cross-border moves, create shipping labels, and validate addresses before dispatch. Manage the entire supply chain lifecycle—from initial rate check to final customs documentation.

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

## Description

Managing shipments used to mean jumping between carrier websites, manually entering tracking numbers into separate portals, and calling customer service just to confirm an address or get a quote. Now, your AI agent handles the whole sequence. You can start by running `validate_address` against any destination postal code to make sure it's valid for international routes. Next, use `get_rates` to compare costs and transit times across different services. Once you have those details locked down, you generate the label using `create_shipment`. If customs documentation is needed, pull the necessary proof of value with `get_proforma_invoice`. The whole process—tracking real-time status via `track_shipment` or finding a local drop-off point with `find_locations`—is exposed to your agent. Because all these actions run through Vinkius, you don't worry about managing credentials; they pass through a zero-trust proxy every time. You just talk to your AI client and get the logistics done.

## Tools

### create_shipment
Generates a shipping label and tracking number required to send out an outbound package.

### find_locations
Finds the address, hours, and services available at nearby DHL service points.

### get_proforma_invoice
Retrieves a formal document used for customs clearance or proof of value on a shipment.

### get_rates
Compares shipping costs and estimates delivery speeds between two addresses.

### track_shipment
Provides the current status, estimated time of arrival, and key checkpoints for a package using its tracking number.

### validate_address
Checks if an entered shipping address is correct and returns standardized formatting to prevent delivery failures.

## 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

### Calculate Shipping Costs
Get instant rate comparisons and transit times for various DHL services between two locations.

### Create Shipment Labels
Generate full shipping labels and the tracking number needed to send out a package.

### Verify Destination Addresses
Check if an address is formatted correctly for DHL delivery, stopping potential failures before they happen.

### Monitor Shipment Status
Pull the real-time status of a package, including customs checkpoints and projected local delivery hours.

### Locate Service Points
Find the closest official DHL drop-off or pickup center, complete with operating hours.

### Generate Customs Documents
Retrieve necessary documentation like a proforma invoice for customs clearance.

## Use Cases

### Processing a new e-commerce order
An agent receives an order for US -> Germany. It first runs `validate_address` on the German zip code, then uses `get_rates` to select the fastest service, and finally calls `create_shipment`, completing the process in three steps.

### Auditing a delayed shipment
A client asks about waybill 1234567890. The agent runs `track_shipment` and reports that the package is currently stuck at 'Customs clearance status updated' in Chicago Hub, giving them exact details on the delay.

### Setting up a new pickup point
A warehouse manager needs to know where to drop off boxes today. The agent runs `find_locations` and tells them the nearest center is open until 6:00 PM, avoiding wasted trips.

### Preparing for customs audit
The finance team needs proof of value for a large shipment. Instead of emailing multiple documents, they prompt the agent to run `get_proforma_invoice` immediately after generating the label.

## Benefits

- Stop guessing rates. Before generating a label, run `get_rates` to compare Express Worldwide and Economy Select quotes instantly, making sure you charge the customer correctly.
- Avoid failed deliveries entirely. Always use `validate_address` first. This prevents your system from attempting to create a shipment using an address that DHL won't accept.
- Build entire workflows in one chat. You can chain together checking rates (`get_rates`), confirming addresses (`validate_address`), and finally generating the label (`create_shipment`) all with one prompt.
- Keep records clean for customs. When a shipment is done, use `get_proforma_invoice` to pull the necessary documentation immediately, without logging into another portal.
- Get full visibility on where things are. Don't just wait for updates; ask your agent to run `track_shipment` and get real-time status, including customs checkpoints, right away.

## How It Works

The bottom line is that you tell your AI client what shipment needs managing, and it executes the required steps across DHL's global API.

1. Subscribe to this MCP and provide your DHL App Credentials (Client ID, Secret, Account Number).
2. Connect that single credential set to your preferred AI client. Your agent now has access to the entire global logistics network.
3. Use natural language prompts to direct your agent through complex workflows—for instance, asking it to 'Check rates for a 5kg item from Chicago to Berlin and generate the label if successful.' 

## Frequently Asked Questions

**How do I use `track_shipment` with DHL?**
You provide your 10-digit tracking number to the agent, and it pulls the current status and delivery estimate. The response includes detailed checkpoints like origin, destination, or customs.

**Can I check rates using `get_rates`?**
Yes. Just give your AI client the origin address, destination zip code, package weight, and desired service type (like Express Worldwide). It returns a comparison of costs and transit times.

**What is `validate_address` for?**
`validate_address` ensures that before you spend time quoting rates or creating labels, the address itself is formatted correctly according to DHL standards. It prevents failure up front.

**After I create a shipment, how do I get customs proof? (get_proforma_invoice)**
You instruct your agent to run `get_proforma_invoice`. This retrieves the necessary document for customs clearance or as proof of value without you having to manually download it from DHL's portal.

**When I use `create_shipment`, what structure must my input data follow?**
The system requires structured inputs for shipper and recipient details, along with exact weight and service type. If the addresses aren't standardized first, the API call will fail or return an error requiring manual correction.

**How reliable is the data from `find_locations` regarding operating hours?**
The tool retrieves current operational information and services offered at a location. However, always treat the retrieved opening hours as suggestions; cross-reference with local business listings for final confirmation.

**Are there any rate limits or performance concerns when repeatedly calling `get_rates`?**
The MCP handles standard API throttling and implements retry logic. If you exceed the allowed calls, your agent will receive a specific error code telling it exactly when to try again.

**What security measures protect the data I send through `create_shipment`?**
Your credentials pass through Vinkius's zero-trust proxy and are never stored on disk. Every transaction is audited using a cryptographically signed, tamper-proof log.