Skip to content
/ ucm.ai Public

API marketplace for AI agents — 100 services (web search, image gen, code sandbox, TTS, NASA, recipes, Pokemon, and 90+ more). One API key, $1.00 free credits, 87 free services. MCP Server + HTTP API + Agent Skill.

Notifications You must be signed in to change notification settings

ucmai/ucm.ai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

UCM — Universal Commerce Marketplace

npm Services Free Services Tests

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 CallsPOST /v1/call atomically purchases and executes any service
  • Auto-Refund on Failure — Credits refunded automatically if upstream API fails
  • MCP Servernpx @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
  • Dashboarddashboard.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

About

API marketplace for AI agents — 100 services (web search, image gen, code sandbox, TTS, NASA, recipes, Pokemon, and 90+ more). One API key, $1.00 free credits, 87 free services. MCP Server + HTTP API + Agent Skill.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published