{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7sey43wd6rrm","handle":"colleag-mcp-ups","url":"https://wellknown.network/agents/colleag-mcp-ups","links":{"self":"https://wellknown.network/agents/colleag-mcp-ups/record.json","html":"https://wellknown.network/agents/colleag-mcp-ups","markdown":"https://wellknown.network/agents/colleag-mcp-ups/record.md","api":"https://wellknown.network/api/v1/agents/colleag-mcp-ups","status":"https://wellknown.network/api/v1/agents/colleag-mcp-ups/status","claim":"https://wellknown.network/agents/colleag-mcp-ups/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/colleag-mcp-ups/claim.json","badge":"https://wellknown.network/agents/colleag-mcp-ups/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/colleag-mcp-ups/history","tools":"https://wellknown.network/api/v1/agents/colleag-mcp-ups/tools"},"ard":{"identifier":"urn:air::server:colleag-mcp-ups","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"colleag-mcp-ups","summary":"MCP server for UPS shipping: rate shopping, tracking, landed cost — on your own UPS account","description":"# colleag-mcp-ups\n\nAn [MCP](https://modelcontextprotocol.io) server for **UPS shipping**, running\nagainst **your own UPS account**: rate shopping with negotiated prices,\nlive tracking (with an interactive [MCP Apps](https://modelcontextprotocol.io/seps/1865-mcp-apps-interactive-user-interfaces-for-mcp)\ncard), and landed-cost estimates for international shipments.\n\nBuilt by [Colleag.ai](https://colleag.ai), a CargoBeacon AB company. Works with any MCP host —\nColleag.ai, Claude Desktop, VS Code, or your own client.\n\n> **Read-only by design (v0.1).** This release quotes, tracks and estimates —\n> it never books shipments or spends money. Side-effecting tools (booking,\n> pickup scheduling) will follow once host-side human-in-the-loop\n> confirmation conventions are settled; a host, not a connector, should own\n> the \"are you sure?\" step for actions that cost money.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `get_rates` | Compare every available UPS service on a lane (or price one `service_code`) with negotiated account prices and estimated delivery dates |\n| `track_shipment` | Current status, delivery estimate and scan history for a tracking number. Ships an MCP Apps tracking card for hosts that support the `io.modelcontextprotocol/ui` extension |\n| `landed_cost` | Duties, VAT and brokerage estimate for an international shipment (per-commodity lines, incoterm-aware) |\n\n## Setup\n\n1. Create an app on [developer.ups.com](https://developer.ups.com) (*\"I want\n   to integrate UPS technology into my business\"*) and enable the Rating,\n   Tracking and Landed Cost products. This gives you a Client ID and Secret\n   tied to your UPS account.\n2. Configure environment variables:\n\n```bash\nUPS_CLIENT_ID=...          # required\nUPS_CLIENT_SECRET=...      # required, secret\nUPS_ACCOUNT_NUMBER=...     # required — your 6-character shipper number\nUPS_ENVIRONMENT=test       # 'test' (CIE sandbox, default) or 'production'\nSHIP_FROM_NAME=\"Acme AB\"   # optional defaults for the quoting origi…","publisher":null,"homepage":"https://colleag.ai","repository":"https://github.com/colleag-ai/mcp-ups","version":"0.1.0","license":"MIT License\n        \n        Copyright (c) 2026 Colleag.ai\n    …","protocols":["mcp"],"tags":["logistics","mcp","model-context-protocol","shipping","ups"],"pricing":null,"endpoints":[{"url":"pypi:colleag-mcp-ups","type":"package_pypi","auth":null,"probeable":false,"listed":true}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"commerce.pricing","name":"Pricing & Quotes","confidence":0.791,"provenance":"derived"}],"categories":["commerce"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"colleag-mcp-ups","registry":"pypi","observedAt":"2026-11-09T02:25:47.822Z","publishedAt":"2026-09-01T12:52:17.511267Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"colleag-mcp-ups","url":"https://pypi.org/project/colleag-mcp-ups/","firstSeenAt":"2026-09-09T12:27:16.521Z","fetchedAt":"2026-11-09T02:24:29.267Z","normalizedAt":"2026-11-09T02:24:29.267Z"}]},"firstSeenAt":"2026-09-09T12:27:16.521Z","updatedAt":"2026-11-09T02:25:47.822Z"}