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):

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

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

Auth: `Authorization: Bearer ucm_key_...`

For the full endpoint list, see the API docs.

Documentation

Support

• Report a bug
• Request a feature
• Request a new service
• Email: admin@ucm.ai