# UCP Gateway

UCP Gateway connects AI assistants to Universal Commerce Protocol for catalog lookups, basket sync, and protected checkout handoffs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 3618 installs
- Author: theagenttimes
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/theagenttimes/ucp-gateway
- Updated: 2026-06-04
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ucp-gateway

## What it 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.

## Requirements
- Remote server: `https://ucp-gateway--theagenttimes.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http ucp-gateway https://ucp-gateway--theagenttimes.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add ucp-gateway --url https://ucp-gateway--theagenttimes.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ucp-gateway": {
            "url": "https://ucp-gateway--theagenttimes.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ucp-gateway": {
            "type": "http",
            "url": "https://ucp-gateway--theagenttimes.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http ucp-gateway https://ucp-gateway--theagenttimes.run.tools
```

## When to use it
- 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
- 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

## Similar
- [mcp-ucp](https://affpapa.org/en/nevibecode/mcp/mcp-ucp.md) — MCP server · ★ 279 repo stars
- [ucp](https://affpapa.org/en/nevibecode/skills/vercel-labs-ucp.md) — skill · 960 installs
- [UCP Checker](https://affpapa.org/en/nevibecode/mcp/ucp-checker.md) — MCP server · 2529 installs
- [agent-ready-ucp](https://affpapa.org/en/nevibecode/skills/agent-ready-ucp.md) — skill · ★ 141 repo stars
- [post-purchase-upsell-flow](https://affpapa.org/en/nevibecode/skills/post-purchase-upsell-flow.md) — skill · 132000 installs
- [iwant.fyi](https://affpapa.org/en/nevibecode/mcp/iwantfyi.md) — MCP server · 6979 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
