@codespar/mcp-ucp

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	API key for UCP platform
UCP_MERCHANT_ID	No	Default merchant ID
UCP_SANDBOX	No	Set to true for sandbox mode

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

Set these environment variables before launching the server:

• UCP_API_KEY (required, secret) — API key for ucp

Issue credentials at the provider's developer portal: https://developers.google.com/agents/commerce.

License

MIT