UCM — Universal Commerce Marketplace

io.github.ucmaiPublished by GitHub account ucmaiv0.3.3Updated Oct 24, 2026

API marketplace for AI agents — 100 services, 87 free, one API key

VerifiedSTDIODesktop onlyWeb Search & ScrapingDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

UCM is a marketplace MCP server that lets an assistant discover and pay for third-party APIs, then call them with credits from one account.

What you can do
  • Discover and browse services: search the catalog by natural-language need, list all services, and read service details and endpoints
  • Call services: buy and execute any catalog API in one step, with automatic refund if the upstream call fails
  • Manage credits: check the balance and view transaction history
  • Register: create an agent account and API key from inside the assistant
  • Coverage spans web search, scraping, image generation, code sandbox, speech, email, finance data, translation and many free data APIs
When to use it
Useful when an assistant should reach many external APIs without each one being pre-integrated, and when a single prepaid credit account with per-call pricing is acceptable. Good for occasional web search, scraping, image or speech tasks and small data lookups.
Requirements
Runs locally via npx from the npm package @ucm/mcp-server, so Node.js is needed. An API key is passed in the UCM_API_KEY environment variable; the register tool can create one. Network access to the UCM registry is required, and calls are billed against prepaid credits.
Before you install
Calls spend real money from a prepaid credit balance at $0.01–$0.05 per call, and the assistant can register accounts and place calls without manual approval. The API key is a bearer credential that grants spending access. Requests and their payloads go to the UCM registry, which forwards them to third-party providers such as Tavily, Firecrawl, Together AI, E2B and Resend; some services send email or run code.

Installation

In SourceWeft

  1. Open UCM — Universal Commerce Marketplace in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

json
{  "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):

ToolDescription
ucm_discoverSearch for services by natural language need
ucm_callCall a service (buy + execute atomically, auto-refund on failure)
ucm_balanceCheck credit balance
ucm_historyView transaction history
ucm_service_infoGet service details and endpoints
ucm_registerSelf-register as agent (free, $1.00 credits)
ucm_list_servicesBrowse the full service catalog

HTTP API

bash
# 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 servicecurl -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

bash
pip install ucm
python
from ucm import UCMClient
client = UCMClient(    registry_url="https://registry.ucm.ai",    api_key="ucm_key_...",)
# Discover servicesservices = await client.discover("weather forecast API")
# Call a serviceresult = await client.call("ucm/web-search", "search", {"query": "AI news"})
# Check balancebalance = await client.balance()

Service Catalog

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

Paid Services

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

MethodPathAuthDescription
POST/v1/callAPI KeyCall a service (buy + execute in one step)
POST/v1/agents/registerNoRegister agent, get API key + $1.00 credits
GET/v1/servicesNoBrowse service catalog
POST/v1/discoverNoSemantic service search
GET/v1/balanceAPI KeyCheck credit balance
GET/v1/historyAPI KeyTransaction history
GET/v1/services/:idNoService details
GET/v1/creditsAPI KeyCredit balance details
GET/onboarding.mdNoAgent onboarding guide

Auth: Authorization: Bearer ucm_key_...

For the full endpoint list, see the API docs.

Documentation

ResourceLink
Docsucm.ai/docs
Onboarding Guideregistry.ucm.ai/onboarding.md
Dashboarddashboard.ucm.ai
npm Package@ucm/mcp-server

Support

Source: README.md at commit 02154c6

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.3LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.