UPS MCP Server
About
An MCP server for accessing UPS shipping and logistics services.
Details
- Author
- ups-api
- Categories
- Other, API
Jump to
Setup
Install UPS MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/ups-api/ups-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol (MCP) server for UPS shipping and logistics capabilities. This server enables AI systems to seamlessly integrate with UPS API tools.
Users can integrate with the MCP server to allow AI agents to facilitate tracking events on their behalf, including tracking the status of a shipment, the latest transit screen, and expected delivery date and time. Agents will be authenticated using OAuth client credentials provided by the user after application creation on the UPS Developer Portal.
- Obtain a Client ID and Client Secret: Create an application on the UPS Developer Portal to obtain your OAuth credentials – Client ID and Client Secret. (https://developer.ups.com/get-started?loc=en_US)
- Python 3.12 or higher
- Install uv (Python Package)
- CLIENT_ID- UPS Client ID
- CLIENT_SECRET- UPS Client Secret
- ENVIRONMENT- Whether to point to Test (CIE) or Production (Accepted values: test, production)
Note: Your API credentials are sensitive. Do not commit them to version control. We recommend managing secrets securely using GitHub Secrets, a vault, or a password manager.
uvx --from git+https://github.com/UPS-API/ups-mcp ups-mcp
To use an older version, you can specify the version number like so:
uvx --from git+https://github.com/UPS-API/ups-mcp@v1.0.0 ups-mcp
Here are sample config files for popular integrations. Different MCP Clients may require modification.
{ "mcpServers": { "ups-mcp": { "type": "stdio", "command": "uvx", "args": ["--from", "git+https://github.com/UPS-API/ups-mcp", "ups-mcp"], "env": { "CLIENT_ID": "", "CLIENT_SECRET": "", "ENVIRONMENT": "test" } } } }
{ "servers": { "ups-mcp": { "type": "stdio", "command": "uvx", "args": ["--from", "git+https://github.com/UPS-API/ups-mcp", "ups-mcp"], "env": { "CLIENT_ID": "", "CLIENT_SECRET": "", "ENVIRONMENT": "test" } } } }
-
track_package: Track a package using the UPS Tracking API
- inquiryNumber (str): the unique package identifier. Each inquiry number must be between 7 and 34 characters in length. Required.
- locale (str): Language and country code of the user, separated by an underscore. Default value is 'en_US'. Not required.
- returnSignature (bool): a boolean to indicate whether a signature is required, default is false. Not required.
- returnMilestones (bool): a boolean to indicate whether detailed information on a package's movements is required, default is false. Not required
- returnPOD (bool): a boolean to indicate whether a proof of delivery is required, default is false. Not required
- str: The response from the tracking capability, this is a string of json tracking data.
validate_address: Validate an address using the UPS Address Validation API for the U.S. or Puerto Rico
- addressLine1 (str): The primary address details including the house or building number and the street name, e.g. 123 Main St. Required.
- addressLine2 (str): Additional information like apartment or suite numbers, e.g. Apt 4B. Not required.
- politicalDivision1 (str): The two-letter state or province code, e.g. GA for Georgia. Required.
- politicalDivision2 (str): The city or town name, e.g. Springfield. Required.
- zipPrimary (str): The postal code. Required.
- zipExtended (str): 4 digit Postal Code extension. For US use only. Not required.
- urbanization (str): Puerto Rico Political Division 3. Only valid for Puerto Rico. Not required.
- countryCode (str): The country code, e.g. US. Required.
- str: The json response body from the address validation API
UPS MCP server is still in active development. More tools coming soon!
Transaction-complete hotel booking over MCP — 300K+ properties, real hotel confirmation numbers, loyalty points, secure checkout. Hotels are merchant of record. Builders set their own booking fee via Stripe Connect. Built on proven distribution infrastructure.
Static MCP discovery card for x402 spend-policy, paid MCP launch guidance, seller checkout repair, and agent-payment safety APIs.
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, inventory, and more.
A TypeScript-based MCP server for interacting with the Etsy API, featuring a simple notes system.
AI-native vacation rental infrastructure — search properties, check availability, get quotes, and complete direct bookings via MCP. Supports multi-language, real-time calendar sync, and dynamic staircase pricing across a federated host network.
37 MCP servers for agentic commerce — Stripe ACP, x402, AP2, Google UCP, plus 14 Brazilian payment rails. ~480 tools.
An MCP server for interacting with the Rami Levy online grocery store API.
Remote MCP server for sommelier-grade wine pairing. 7 tools powered by a proprietary Wine DNA algorithm. API key or x402 pay-per-call.
MCP server for OpenTable - let AI agents make restaurant reservations and find availability
he Zaslat MCP Server enables AI assistants to seamlessly manage end-to-end logistics, including rate comparison, shipment creation, and package tracking directly through chat.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




