mcp-ucp

@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

Tools (20)

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

• Google UCP Announcement
• MCP Dev LATAM
• Landing Page

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