@codespar/mcp-ucp
Deprecated: no live endpoint. Measured on 2026-09-27: commerce.googleapis.com answers every path with Google's generic Error 404 (Not Found) page, and sandbox.commerce.googleapis.com (used with UCP_SANDBOX=true) fails the TLS handshake, because the certificate served there covers *.googleapis.com and not the extra label. UCP is an open specification, not an API Google hosts. No tool in this server reaches a service. The package is deprecated on npm and stays in this repository for reference only. If you have a working endpoint, point the server at it with UCP_BASE_URL. To bring the package back, open an issue in mcp-dev-latam with the provider's documented base URL.
MCP server for Google UCP — Universal Commerce Protocol for agentic shopping, cart, checkout, orders, and delivery

What is UCP?
Universal Commerce Protocol (UCP) is Google's open standard for agentic commerce. It enables AI agents to autonomously discover products, build carts, checkout, manage orders, and track deliveries — without screen-scraping or bespoke merchant integrations.
UCP works alongside AP2 (payment processing) and A2A (agent-to-agent interoperability), with MCP as the transport layer.
Quick Start
Claude Desktop
{
"mcpServers": {
"ucp": {
"command": "npx",
"args": ["-y", "@codespar/mcp-ucp"],
"env": {
"UCP_API_KEY": "your-key",
"UCP_MERCHANT_ID": "your-merchant-id"
}
}
}
}
Claude Code
claude mcp add ucp -- npx @codespar/mcp-ucp
| Tool | Purpose |
|---|
search_products | Search merchant product catalog. |
get_product | Get detailed product information including pricing, variants, availability, and reviews |
check_availability | Check product stock and delivery availability for a specific location |
list_merchants | List UCP-compatible merchants with optional category and region filters |
create_cart | Create a new shopping cart for a merchant |
add_to_cart | Add an item to the shopping cart |
remove_from_cart | Remove an item from the shopping cart |
get_cart | Get cart contents, item totals, taxes, and shipping estimates |
clear_cart | Remove all items from the cart |
get_delivery_options | Get available shipping and delivery options for a cart |
initiate_checkout | Start the checkout process for a cart. |
apply_payment | Apply a payment method to the checkout session. |
confirm_order | Confirm and place the order. |
get_order | Get order details including items, status, payment, and shipping info |
list_orders | List orders with optional filters |
cancel_order | Cancel a pending or confirmed order |
request_return | Request a return or refund for a delivered order |
track_shipment | Get real-time shipment tracking details for an order |
link_identity | Link buyer identity for personalization and order history across merchants |
get_profile | Get buyer profile, preferences, and linked merchants |
UCP + AP2 + A2A — The Full Stack
AI Agent
└── MCP (tool interface)
└── UCP (commerce: discover → cart → checkout → order → delivery)
├── A2A (agent-to-agent discovery & communication)
└── AP2 (payment: authorize → execute → settle)
Environment Variables
| Variable | Required | Description |
|---|
UCP_API_KEY | Yes | Sent as Authorization: Bearer |
UCP_MERCHANT_ID | No | Sent as the X-Merchant-Id header |
UCP_SANDBOX | No | true switches BASE_URL to https://sandbox.commerce.googleapis.com/ucp/v1, which fails TLS |
Links
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
Authentication
The server sends UCP_API_KEY as an Authorization: Bearer header and UCP_MERCHANT_ID as an X-Merchant-Id header on every request (src/index.ts:78-83).
There is no portal issuing those credentials. The developer portal this README used to link, developers.google.com/agents/commerce, answers HTTP 404.
License
MIT