{"_id":"@codespar/mcp-ucp","_rev":"5-637836b223d008446a818768e52dbaf9","name":"@codespar/mcp-ucp","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.0":{"name":"@codespar/mcp-ucp","version":"0.1.0","keywords":["mcp","ucp","google","universal-commerce-protocol","agentic-commerce","shopping","checkout","cart","agent-shopping"],"license":"MIT","_id":"@codespar/mcp-ucp@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-ucp":"dist/index.js"},"dist":{"shasum":"1d83a63c917d262fad11bc6428e63371c55c29d8","tarball":"https://registry.npmjs.org/@codespar/mcp-ucp/-/mcp-ucp-0.1.0.tgz","fileCount":4,"integrity":"sha512-vHHn4tXM1XDwCIbMP2FDohnkP2Wu7pb5f065oIy4lU6O8hP3sNX1ICN3U2/K4cnU5we+/19pAtVMk2OhJHLGIQ==","signatures":[{"sig":"MEUCICFfS6Bc1NUzrBJJVIYzKPiXglyewGdxigY1dMiak57WAiEA/m8d1KEjCZj9/AndHEIuANIN4IRql3gCYJI+cRRgEik=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28272},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"4b51068ac1d3051108e60c7afea539518f33caaf","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Google UCP — Universal Commerce Protocol for agentic shopping, cart, checkout, orders, and delivery","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-ucp_0.1.0_1775676567108_0.2050712374448267","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-ucp","version":"0.1.2","keywords":["mcp","ucp","google","universal-commerce-protocol","agentic-commerce","shopping","checkout","cart","agent-shopping"],"license":"MIT","_id":"@codespar/mcp-ucp@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-ucp":"dist/index.js"},"dist":{"shasum":"a5f1e0f0f489aa1bd204d9d37dc7bf2a7c1745ff","tarball":"https://registry.npmjs.org/@codespar/mcp-ucp/-/mcp-ucp-0.1.2.tgz","fileCount":4,"integrity":"sha512-aKW623RNp85gtt1Gs6Sehd3I7D7Tb9EXG1rhz3srsbqdrpI0oEE11D8zVxSWDHUpJpqWA3wdZNbgY/wJO9OVyQ==","signatures":[{"sig":"MEUCIQDJ+GbwghcVBhnNNw1ypi4uGQFZ+ZAu7NUJkfigobeQtQIgL+nNTf7ZTBUESh0Wk2Rq8kCKc3KcOHKOtnX8MnzleqU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30858},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-ucp","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Google UCP — Universal Commerce Protocol for agentic shopping, cart, checkout, orders, and delivery","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-ucp_0.1.2_1775953803020_0.42204192847649313","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@codespar/mcp-ucp","version":"0.1.3","keywords":["mcp","ucp","google","universal-commerce-protocol","agentic-commerce","shopping","checkout","cart","agent-shopping"],"license":"MIT","_id":"@codespar/mcp-ucp@0.1.3","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-ucp":"dist/index.js"},"dist":{"shasum":"69c4dc76c3eed3f0eb32645cbc5e84f018184567","tarball":"https://registry.npmjs.org/@codespar/mcp-ucp/-/mcp-ucp-0.1.3.tgz","fileCount":4,"integrity":"sha512-C7GnhonSBXaMf3Jp6ZSr5HxkHHdSovFxqgxT1rHUo3LyOKqdHgzAXth2oq+lWklw7pY095+5I+hHwtdKU1VEZA==","signatures":[{"sig":"MEQCIDzhfr2jPWmAckGHPp7rcpLd8BAzLkeo4xAPE4dTewPfAiAR3yVR7HDHYrLlEe1khXk5zsuVjnWukQnIjzdbYTSIuQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31077},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-ucp","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Google UCP — Universal Commerce Protocol for agentic shopping, cart, checkout, orders, and delivery","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-ucp_0.1.3_1777123280253_0.13279970208966518","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@codespar/mcp-ucp","version":"0.1.4","description":"MCP server for Google UCP — Universal Commerce Protocol for agentic shopping, cart, checkout, orders, and delivery","type":"module","main":"dist/index.js","bin":{"mcp-ucp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^22.0.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","ucp","google","universal-commerce-protocol","agentic-commerce","shopping","checkout","cart","agent-shopping"],"mcpName":"io.github.codespar/mcp-ucp","_id":"@codespar/mcp-ucp@0.1.4","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-caHvlhnDrfgv+ST+K9C5iWGkqHubIGuVQiVxpPkimpCJbDDL+N+7e+v8KG5XoZsAbP1I+JPF0VWVhxl3omSbLA==","shasum":"40019b15b4b337bdde6bdf29aa50aa4088273d29","tarball":"https://registry.npmjs.org/@codespar/mcp-ucp/-/mcp-ucp-0.1.4.tgz","fileCount":4,"unpackedSize":31801,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC7mxnvUqiq7S9kDdJjM+ZetOOvWbzeY5uwquxerXQrXAIhALRYBwQMidcrg1elTBBOo4y/lUw/aPbLBby2CKRVRnzx"}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-ucp_0.1.4_1782153989904_0.5797037496715789"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-08T19:29:27.033Z","modified":"2026-06-22T18:46:30.169Z","0.1.0":"2026-04-08T19:29:27.299Z","0.1.2":"2026-04-12T00:30:03.163Z","0.1.3":"2026-04-25T13:21:20.394Z","0.1.4":"2026-06-22T18:46:30.050Z"},"license":"MIT","keywords":["mcp","ucp","google","universal-commerce-protocol","agentic-commerce","shopping","checkout","cart","agent-shopping"],"description":"MCP server for Google UCP — Universal Commerce Protocol for agentic shopping, cart, checkout, orders, and delivery","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-ucp\n\n> MCP server for **Google UCP** — Universal Commerce Protocol for agentic shopping, cart, checkout, orders, and delivery\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-ucp)](https://www.npmjs.com/package/@codespar/mcp-ucp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## What is UCP?\n\n**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.\n\nUCP works alongside **AP2** (payment processing) and **A2A** (agent-to-agent interoperability), with **MCP** as the transport layer.\n\n## Quick Start\n\n### Claude Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"ucp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-ucp\"],\n      \"env\": {\n        \"UCP_API_KEY\": \"your-key\",\n        \"UCP_MERCHANT_ID\": \"your-merchant-id\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add ucp -- npx @codespar/mcp-ucp\n```\n\n## Tools (20)\n\n| Tool | Purpose |\n|---|---|\n| `search_products` | Search merchant product catalog. |\n| `get_product` | Get detailed product information including pricing, variants, availability, and reviews |\n| `check_availability` | Check product stock and delivery availability for a specific location |\n| `list_merchants` | List UCP-compatible merchants with optional category and region filters |\n| `create_cart` | Create a new shopping cart for a merchant |\n| `add_to_cart` | Add an item to the shopping cart |\n| `remove_from_cart` | Remove an item from the shopping cart |\n| `get_cart` | Get cart contents, item totals, taxes, and shipping estimates |\n| `clear_cart` | Remove all items from the cart |\n| `get_delivery_options` | Get available shipping and delivery options for a cart |\n| `initiate_checkout` | Start the checkout process for a cart. |\n| `apply_payment` | Apply a payment method to the checkout session. |\n| `confirm_order` | Confirm and place the order. |\n| `get_order` | Get order details including items, status, payment, and shipping info |\n| `list_orders` | List orders with optional filters |\n| `cancel_order` | Cancel a pending or confirmed order |\n| `request_return` | Request a return or refund for a delivered order |\n| `track_shipment` | Get real-time shipment tracking details for an order |\n| `link_identity` | Link buyer identity for personalization and order history across merchants |\n| `get_profile` | Get buyer profile, preferences, and linked merchants |\n\n## UCP + AP2 + A2A — The Full Stack\n\n```\nAI Agent\n  └── MCP (tool interface)\n       └── UCP (commerce: discover → cart → checkout → order → delivery)\n            ├── A2A (agent-to-agent discovery & communication)\n            └── AP2 (payment: authorize → execute → settle)\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `UCP_API_KEY` | Yes | API key for UCP platform |\n| `UCP_MERCHANT_ID` | No | Default merchant ID |\n| `UCP_SANDBOX` | No | Set to `true` for sandbox mode |\n\n## Links\n\n- [Google UCP Announcement](https://cloud.google.com/blog)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## Authentication\n\nSet these environment variables before launching the server:\n\n- `UCP_API_KEY` *(required, secret)* — API key for ucp\n\nIssue credentials at the provider's developer portal: <https://developers.google.com/agents/commerce>.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}