UCP Gateway — Claude Code MCP server: what it does, how to install
UCP Gateway connects AI assistants to Universal Commerce Protocol for catalog lookups, basket sync, and protected checkout handoffs.
no license 3,618 installs updated 2026-06-04
claude mcp add --transport http ucp-gateway https://ucp-gateway--theagenttimes.run.toolsWhat UCP Gateway does
The server acts as an integration layer enabling open-source agents to execute commerce workflows via the Universal Commerce Protocol. Agents do not need a custom domain, GitHub account, or direct Shopify API keys to start querying products.
It exposes tools to search catalogs, read product details by variant ID, and manage carts with idempotency keys. Once items are selected and confirmed, the gateway produces a checkout link so the buyer finishes payment directly on the merchant platform.
Payment credentials never pass through shopping_checkout_create. When initiating checkout, buyer phone numbers must follow the E.164 standard and country codes require the ISO-2 format.
What it helps with
- search merchant catalogs and inspect product variants
- build and update shopping carts after buyer verification
- generate safe checkout links for external payment completion
- register hosted agent profiles using JWK public keys
Example prompts for the agent
- Search the product catalog for waterproof running shoes
- Create a new shopping cart with the confirmed variant items
- Generate a checkout handoff link for country US and an E.164 phone
How to install UCP Gateway
Platform CLI: remote server
claude mcp add --transport http ucp-gateway https://ucp-gateway--theagenttimes.run.toolsPlatform CLI: remote server
codex mcp add ucp-gateway --url https://ucp-gateway--theagenttimes.run.toolsConfig file
{
"mcpServers": {
"ucp-gateway": {
"url": "https://ucp-gateway--theagenttimes.run.tools"
}
}
}Config file
{
"servers": {
"ucp-gateway": {
"type": "http",
"url": "https://ucp-gateway--theagenttimes.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http ucp-gateway https://ucp-gateway--theagenttimes.run.toolsStep 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 UCP Gateway
How do I install UCP Gateway in Claude Code?
Run claude mcp add --transport http ucp-gateway https://ucp-gateway--theagenttimes.run.tools in your terminal. It hooks into your agent over HTTP without running local services.
What does UCP Gateway do?
It lets AI agents discover products, maintain shopping carts, and trigger checkout links via the Universal Commerce Protocol. Transactions stay guarded because the user pays on the actual store site.
Does the server accept credit card details?
No, the tool rejects payment credentials by design. Instead, shopping_checkout_create returns a handoff URL where the user enters billing info directly on the merchant site.