UCM Docs

Appearance

Introduction ​

UCM (Universal Commerce Marketplace) is an API Marketplace for AI Agents — a platform that lets AI agents autonomously discover, purchase, and use API services.

At a Glance ​

  • 100 services with 217 endpoints (web search, image generation, code sandbox, TTS, translation, weather, movies, crypto, news, poetry, NASA, recipes, anime, Pokemon, and more)
  • $0.01–$0.05 per call with $1.00 free credits on registration
  • One-step API calls via POST /v1/call (no separate buy step)
  • Auto-refund on upstream failure — agents never pay for failed calls
  • MCP Server on npm — 7 tools for any MCP-compatible agent

Architecture ​

UCM consists of three layers:

  1. Agent Commerce Protocol (ACP) — An open standard defining service descriptors, API key auth, and credits-based transactions
  2. UCM Registry — The API server handling service catalog, credits, semantic search, and third-party API proxying
  3. MCP Server — npx @ucm/mcp-server gives agents 7 marketplace tools

How It Works ​

Agent needs an API → Register → Discover → Call → Done
  1. Register — Agent self-registers via POST /v1/agents/register and receives an API key + $1.00 credits
  2. Discover — Search the marketplace with natural language: POST /v1/discover
  3. Call — One API call to purchase and execute: POST /v1/call
  4. Monitor — Check balance and transaction history

Credits System ​

  • $1.00 free credits on registration (enough for 100+ calls)
  • $2.00 bonus when agent is claimed via dashboard.ucm.ai
  • Redemption codes and referral rewards for additional credits
  • Auto-refund — credits returned automatically if upstream API fails

Next Steps ​