ucp-mcp

KituDigital — UCP (Universal Commerce Protocol) backend + FastMCP server.
Agentic digital goods checkout for Claude and other AI agents.

What's inside

| File | Purpose | |---|---| | ucp_backend.py | FastAPI app — 9 fully UCP-compliant REST endpoints | | server.py | FastMCP server — 10 Claude-callable tools wrapping the backend | | catalog.json | Product catalog — 6 digital goods (dev tools, CTF bundles, study packs) | | docker-compose.yml | Runs the FastAPI backend on port 8100 | | requirements.txt | Python deps | | setup.sh | One-shot bootstrap (venv + install) |

Business: KituDigital

A Kenya-based digital goods marketplace. Zero inventory, instant downloads, agentic-first.

Products:

• kitu-001 Kenya Developer Starter Pack — $4.99
• kitu-002 University CS Exam Study Pack — $3.49
• kitu-003 CTF Quickstart Bundle — $5.99
• kitu-004 Self-Hosted Infrastructure Playbook — $7.99
• kitu-005 UI Design Starter Kit (Figma + SVG) — $6.49
• kitu-006 MCP Server Development Guide — $9.99

Coupons: KITU10 (10%), DEVDAY (20%), WELCOME (15%)

Quick start

# 1 — clone and bootstrap
git clone https://github.com/jaguar999paw-droid/ucp-mcp ~/MCP/ucp-mcp
cd ~/MCP/ucp-mcp
chmod +x setup.sh && ./setup.sh

# 2 — start the UCP backend
docker compose up -d

# 3 — verify
curl http://localhost:8100/.well-known/ucp | python3 -m json.tool

# 4 — restart Claude Desktop to activate the MCP server

MCP tools exposed to Claude

| Tool | What it does | |---|---| | ucp_business_profile | Fetch /.well-known/ucp — capabilities + endpoints | | ucp_search_products | Discover products with text/category/price/tag filters | | ucp_get_product | Single product detail | | ucp_create_session | Open a checkout session | | ucp_get_session | Read session state | | ucp_update_session | Change items / apply coupon / add email | | ucp_complete_checkout | Submit AP2 payment mandate → confirm order | | ucp_get_order | Order status + download links | | ucp_cancel_order | Cancel an order | | ucp_generate_token | Dev-mode AP2 payment token for testing |

UCP endpoints

GET  /.well-known/ucp
GET  /ucp/products/search
GET  /ucp/products/{id}
POST /ucp/checkout/sessions
GET  /ucp/checkout/sessions/{sid}
PUT  /ucp/checkout/sessions/{sid}
POST /ucp/checkout/sessions/{sid}/complete
GET  /ucp/orders/{oid}
POST /ucp/orders/{oid}/cancel

Claude Desktop config entry

Already written to ~/.config/claude/claude_desktop_config.json and ~/.config/Claude/claude_desktop_config.json by the setup process.

"ucp-mcp": {
  "command": "/home/kamau/MCP/ucp-mcp/venv/bin/python",
  "args": ["/home/kamau/MCP/ucp-mcp/server.py"],
  "env": {
    "UCP_BASE_URL": "http://localhost:8100",
    "UCP_PAYMENT_SECRET": "kitudigital-dev-secret-2026"
  }
}

Protocol compatibility

UCP is interoperable with MCP, A2A, and AP2. This server uses MCP as the transport binding, with REST as the underlying backend protocol — exactly the architecture described in the UCP spec.

License

MIT