Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http ucp-gateway https://ucp-gateway--theagenttimes.run.tools
Open on GitHub

What 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.tools

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 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open