🔒

DHL Shipment Tracking (UTAPI ) MCP Server

Connect seamlesslyto all DHL products to track your shipments Get your key at https://developer.dhl.com

0 installs

Trust: 34 — Low

Security

Ask AI about DHL Shipment Tracking (UTAPI ) MCP Server

I know everything about DHL Shipment Tracking (UTAPI ) MCP Server. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

DHL Shipment Tracking MCP Server 🚚📦

Powered by Microsoft Copilot Studio ❤️ MCP

This project provides an MCP (Model Context Protocol) Server exposing a DHL Shipment Tracking tool that can be used by Microsoft Copilot Studio, GitHub Copilot Agents, or any other MCP‑compatible client.

It is based on the official Microsoft MCP Streamable HTTP Template, but the server logic has been replaced with a production‑ready DHL shipment tracking integration.

✨ What This Server Does

The server exposes one MCP Tool: track-shipment

🔧 `track-shipment`

Tracks a DHL shipment using the official DHL Shipment Tracking - Unified API. https://developer.dhl.com/api-reference/shipment-tracking

Parameters:

Name	Type	Description
trackingNumber	string	The DHL tracking number
apiKey	string	User-provided DHL API key

Response:
Formatted JSON output from the DHL API, suitable for LLM processing.

⚙️ How It Works

The server is built on:

Express.js for HTTP routing
Model Context Protocol SDK for defining tools
Streamable HTTP Transport for Copilot Studio compatibility
Zod for schema validation

MCP clients communicate via:

POST /mcp

If you open /mcp in the browser, seeing this means the server is working:

{"jsonrpc":"2.0","error":{"code":-32000,"message":"Method not allowed."},"id":null}

📁 Project Structure

src/
server.ts ← DHL MCP server implementation
assets/ ← Optional images
infra/ ← Azure deployment template (from Microsoft)
README.md

🏃‍♂️ Run the MCP Server Locally

Install and start:

npm install
npm run build && npm run start

Server runs on:

http://localhost:3000

Using VS Code Dev Tunnels (Recommended for Copilot Studio)

Start the server
Open VS Code Terminal → PORTS
Forward port 3000
Set visibility to Public
Use the forwarded URL ending in /mcp, e.g.:

https://abc-3000.devtunnels.ms/mcp

🌐 Deploy to Azure (Optional)

azd auth login

Deploy:

azd up

Remove everything later:

azd down

🤖 Using the DHL MCP Server in Visual Studio Code

Open Command Palette
Run: MCP: Add Server
Choose HTTP / SSE
Enter your URL ending in /mcp
Name it e.g. DHLTracking
Open GitHub Copilot → Agent Mode
Enable the tool

Ask:

Track shipment 00340434161234567890 using API key XYZ.

🧠 Use in Microsoft Copilot Studio

Open Custom Connectors
Import from GitHub
Set the connector host to your tunnel/Azure URL
Create or open an Agent
Add the MCP Server under Tools → Model Context Protocol
Create a connection
Test with:

Track shipment 00340434161234567890.

🔐 Authentication Notes

The user must provide their own DHL API key.
The server does not store, log, or cache the API key.

📦 Example MCP Tool Invocation

{ "method": "tools.call", "params": { "name": "track-shipment", "arguments": { "trackingNumber": "0034043416XXXXXXX", "apiKey": "<YOUR_KEY>" } } }

🧰 Template Reference

This project is originally based on:

Microsoft MCP Streamable HTTP Template
https://github.com/microsoft/mcsmcp

Only the server logic was replaced to support DHL tracking.

🗣 Feedback & Contributions

Contributions are welcome.
For Microsoft MCP feedback, use the upstream template repo.

™ Trademarks

DHL trademarks belong to DHL and are used only for demo/integration purposes.
Microsoft trademarks follow Microsoft’s standard brand guidelines.