mcp-ucp — Claude Code MCP server: what it does, install
An MCP server for UCP shopping flows, from product search to orders and delivery. The package is deprecated and has no live endpoint at present.
claude mcp add mcp-ucp -e UCP_API_KEY=<UCP_API_KEY> -- npx -y @codespar/mcp-ucpWhat mcp-ucp does
mcp-ucp is intended to expose Google UCP commerce actions to an AI agent. Its tool set covers product discovery, product details, stock and delivery checks, cart changes, checkout, payment, orders, returns, shipment tracking, and buyer identity. There are 20 tools in total.
The package is deprecated because its current endpoint does not serve a working UCP service, so these tools cannot reach a commerce backend now. A working provider can be supplied through UCP_BASE_URL; requests use UCP_API_KEY as a Bearer token and may include UCP_MERCHANT_ID as the merchant header. Without a live UCP endpoint, catalog and order requests will fail.
What it helps with
- search a merchant product catalog
- check stock and delivery for a location
- build a cart and review shipping options
- start checkout and confirm an order
- track a shipment or request a return
Example prompts for the agent
- Search the merchant catalog for a product and show its price, variants, and availability.
- Create a cart, add the selected item, and list the delivery options.
- Look up the order status and shipment details.
How to install mcp-ucp
Platform CLI
claude mcp add mcp-ucp -e UCP_API_KEY=<UCP_API_KEY> -- npx -y @codespar/mcp-ucpReplace <…> with your own values
Platform CLI
codex mcp add ucp --env UCP_API_KEY=<UCP_API_KEY> -- npx -y @codespar/mcp-ucpReplace <…> with your own values
Config file
{
"mcpServers": {
"ucp": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-ucp"
],
"env": {
"UCP_API_KEY": "<UCP_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"ucp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-ucp"
],
"env": {
"UCP_API_KEY": "<UCP_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e UCP_API_KEY=<UCP_API_KEY> ucp npx -y @codespar/mcp-ucpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-ucp
How do I install mcp-ucp in Claude Code?
Run claude mcp add mcp-ucp -e UCP_API_KEY=<UCP_API_KEY> -- npx -y @codespar/mcp-ucp.
What does mcp-ucp do?
It exposes UCP tools for product search, carts, checkout, orders, delivery, returns, and buyer profiles. The current package does not reach a live commerce service.
What does mcp-ucp need to work?
It requires UCP_API_KEY. A working provider endpoint must also be supplied with UCP_BASE_URL; UCP_MERCHANT_ID is an optional merchant identifier.
