Overview
What is UUPT FREIRHT MCP?
UUPT FREIRHT MCP is a lightweight MCP server that integrates with the UU货运 (uupt.com) open platform, enabling AI agents to create delivery orders via the Model Context Protocol. It is the first delivery service provider in China to fully support the MCP protocol, covering functions like price enquiry, order placement, order details, and real-time courier location.
How to use UUPT FREIRHT MCP?
Install the server via pip (pip3 install uupt-mcp-freight-server), then configure your MCP client (e.g., mcpServers in claude_desktop_config.json) with the command python -m uupt_mcp_freight_server and required environment variables: APP_ID, APP_SECRET, OPEN_ID, and ORDER_CITY. After setup, you can invoke MCP tools to enquire prices, place orders, cancel orders, and query order status.
Key features of UUPT FREIRHT MCP
- Enquire delivery price with address and vehicle type
- Place an order using a price token and receiver phone
- Cancel an order and see any deduction fee
- Query order details including status, addresses, and distance
- Configured via environment variables for API credentials
Use cases of UUPT FREIRHT MCP
- AI agents creating delivery orders with a single voice command
- Integrating real-time courier tracking into AI applications
- Automating price estimation and order submission for logistics workflows
- Enabling developers to prototype delivery features without deep API integration
FAQ from UUPT FREIRHT MCP
What prerequisites are required to use this server?
You need Python 3.11 or later, and valid credentials (APP_ID, APP_SECRET, OPEN_ID) from the UU开放平台 at https://open.uupt.com/. The server uses stdio transport and runs as a Python module.
How do I get the API keys for this server?
Register an account at the UU开放平台, create an application in "我的应用", and obtain your APP_ID, APP_SECRET, and OPEN_ID. Then set these as environment variables in your MCP client configuration.
Can I use this server without a Chinese phone number?
The README does not specify geographic restrictions; however, the service requires a valid receiver phone number (手机号码) when placing orders, and the platform is designed for the Chinese market.
Is there a limit on the number of orders or API calls?
The README does not mention any rate limits or usage caps. Limits may be governed by your UU开放平台 account plan.
What transport does the server use?
The server uses stdio transport (transportType: "stdio") as shown in the configuration example. It communicates via standard input/output with the host MCP client.
