UCM — Universal Commerce Marketplace

An API marketplace that lets AI agents autonomously discover and use services — no human intervention required.

Why UCM

Today, AI agents can only use tools that developers have pre-integrated. UCM gives agents autonomous API access:

Agent needs to search the web
  → ucm_discover("search the web for information")
  → Found: ucm/web-search, $0.01/call
  → ucm_call("ucm/web-search", "search", { query: "..." })
  → Results returned, $0.01 deducted from credits

No UI, no manual approval — register once, get $1.00 free credits, start calling APIs.

Features

• 100 Live Services — Web search, image generation, code sandbox, TTS, NASA, recipes, anime, Pokemon, D&D, npm/PyPI, Nobel Prize, and 80+ more (87 free)
• $0.01–$0.05 per call — Affordable micropayments with $1.00 free credits on registration
• One-Step API Calls — POST /v1/call atomically purchases and executes any service
• Auto-Refund on Failure — Credits refunded automatically if upstream API fails
• MCP Server — npx @ucm/mcp-server gives any MCP-capable agent 7 marketplace tools
• Semantic Discovery — Natural language search powered by pgvector embeddings
• Credits System — $1.00 on registration, $2.00 bonus when claimed via dashboard, redemption & referral codes
• Dashboard — dashboard.ucm.ai — manage agents, credits, and usage history

Quick Start

For AI Agents (Recommended)

Give your agent this prompt:

Read https://registry.ucm.ai/onboarding.md and follow the instructions to join UCM.

The agent will self-register, get an API key + $1.00 credits, and start using services autonomously.

MCP Server

Add to your MCP config (Claude Desktop, Claude Code, Cursor, etc.):

{
  "mcpServers": {
    "ucm": {
      "command": "npx",
      "args": ["-y", "@ucm/mcp-server@latest"],
      "env": {
        "UCM_API_KEY": "ucm_key_..."
      }
    }
  }
}

No API key yet? The ucm_register tool will create one automatically.

MCP Tools (7):

Tool	Description
ucm_discover	Search for services by natural language need
ucm_call	Call a service (buy + execute atomically, auto-refund on failure)
ucm_balance	Check credit balance
ucm_history	View transaction history
ucm_service_info	Get service details and endpoints
ucm_register	Self-register as agent (free, $1.00 credits)
ucm_list_services	Browse the full service catalog

HTTP API

# 1. Register (free, get $1.00 credits)
curl -X POST https://registry.ucm.ai/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'
# → { "api_key": "ucm_key_...", "credits": { "balance": "1.00" } }

# 2. Call a service
curl -X POST https://registry.ucm.ai/v1/call \
  -H "Authorization: Bearer ucm_key_..." \
  -H "Content-Type: application/json" \
  -d '{"service_id": "ucm/web-search", "endpoint": "search", "body": {"query": "AI news"}}'
# → { "amount_charged": "0.01", "result": { ... } }

Python SDK

pip install ucm

from ucm import UCMClient

client = UCMClient(
    registry_url="https://registry.ucm.ai",
    api_key="ucm_key_...",
)

# Discover services
services = await client.discover("weather forecast API")

# Call a service
result = await client.call("ucm/web-search", "search", {"query": "AI news"})

# Check balance
balance = await client.balance()

Service Catalog

100 services, 217 endpoints (87 free, 13 paid at $0.01–$0.05/call).

Paid Services

Service	Price	What It Does
ucm/web-search	$0.01	Search the web (Tavily)
ucm/web-scrape	$0.02	Scrape web pages (Firecrawl)
ucm/image-generation	$0.05	Generate images from text (Together AI)
ucm/code-sandbox	$0.03	Execute code in sandbox (E2B)
ucm/text-to-speech	$0.01	Convert text to audio (Kokoro TTS)
ucm/speech-to-text	$0.01	Transcribe audio (Whisper)
ucm/email	$0.01	Send emails (Resend)
ucm/doc-convert	$0.02	Convert documents (Firecrawl)
ucm/us-stock	$0.01	US stock market data (Finnhub)
ucm/cn-finance	$0.01	China financial data (Tushare Pro)
ucm/translate	$0.01	Text translation (MyMemory)
ucm/qr-code	$0.01	Generate QR codes (GoQR.me)
ucm/news	$0.01	Latest news (NewsData.io)

Free Services (87)

Weather, Wikipedia, currency exchange, countries, holidays, dictionary, books, geocode, math, IP geolocation, address lookup, academic papers, nutrition, crypto prices, timezone, domain info, quotes, Hacker News, random data, poetry, movies, word associations, universities, zip codes, trivia, jokes, advice, bored activity ideas, Bible verses, Chuck Norris facts, recipes, cocktails, breweries, food products, sunrise/sunset, dog images, cat facts, avatars, colors, Lorem Ipsum, NASA, SpaceX, ISS tracker, space news, arXiv papers, earthquakes, World Bank, FDA data, carbon intensity, elevation, age/gender/nationality prediction, UK postcodes, vehicle data, Met Museum, Art Institute of Chicago, TV shows, anime, iTunes, music, radio stations, free games, game deals, Pokemon, D&D, memes, IP lookup, barcodes, Wayback Machine, npm, PyPI, GitHub repos, country flags, deck of cards, Star Wars, xkcd, Rick & Morty, Nobel Prize, historical events, Kanye quotes, Rust crates, Docker Hub, Lichess, periodic table, airports, random fox images.

Browse the live catalog: GET https://registry.ucm.ai/v1/services

API Reference

Method	Path	Auth	Description
POST	/v1/call	API Key	Call a service (buy + execute in one step)
POST	/v1/agents/register	No	Register agent, get API key + $1.00 credits
GET	/v1/services	No	Browse service catalog
POST	/v1/discover	No	Semantic service search
GET	/v1/balance	API Key	Check credit balance
GET	/v1/history	API Key	Transaction history
GET	/v1/services/:id	No	Service details
GET	/v1/credits	API Key	Credit balance details
GET	/onboarding.md	No	Agent onboarding guide

Auth: Authorization: Bearer ucm_key_...

For the full endpoint list, see the API docs.

Documentation

Resource	Link
Docs	ucm.ai/docs
Onboarding Guide	registry.ucm.ai/onboarding.md
Dashboard	dashboard.ucm.ai
npm Package	@ucm/mcp-server

Support

• Report a bug
• Request a feature
• Request a new service
• Email: [email protected]