This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Sign in to like and favorite skills
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
UCP Agent is a Universal Commerce Protocol implementation with Claude AI integration. It provides:
bun install # Install dependencies bun run start # Run the server (or: bun run index.ts) bun run dev # Run with watch mode bun run mcp # Run standalone MCP server bun run typecheck # Type check without emitting bun test # Run tests bun test path/to/file # Run a single test file
PORTANTHROPIC_API_KEYMERCHANT_ENDPOINTindex.ts # Entry point - starts server + optional REPL src/ server/ucp-server.ts # Hono-based UCP merchant server agent/claude-agent.ts # Claude AI shopping assistant mcp/ucp-mcp-server.ts # MCP server with commerce tools mcp/run-mcp.ts # MCP server entry point sdk/ # Zod schemas for UCP types schemas/common.ts # Money, Address, Cart, Customer schemas/checkout.ts # CheckoutSession, payment types schemas/discovery.ts # UCP discovery response types
Key endpoints:
GET /.well-known/ucpPOST /ucp/checkoutGET/PATCH /ucp/checkout/:sessionIdMCP tools:
discover_merchantcreate_checkoutget_checkoutupdate_checkoutUse Bun instead of Node.js:
bun <file>nodets-nodebun testbun install.envPreferred APIs:
Bun.serve()Bun.file()node:fsWebSocketbun:sqliteBun.redisBun.sql