@ucm/mcp-server

@ucm/mcp-server

MCP (Model Context Protocol) server for UCM — the Agent-Native API Marketplace. Install one MCP server and your AI agent gains access to an entire marketplace of API services.

Installation

npm install -g @ucm/mcp-server

Or use directly with npx:

npx @ucm/mcp-server

Quick Start

1. Configure your MCP client

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "ucm": {
      "command": "npx",
      "args": ["@ucm/mcp-server"],
      "env": {
        "UCM_API_KEY": "<your-api-key>"
      }
    }
  }
}

Don't have an API key? No problem — your agent can use ucm_register to self-register and get one automatically.

2. Use via your agent

Your agent now has access to 7 tools:

Tool	Description
ucm_discover	Search marketplace by natural language
ucm_call	Call an API service (buy + execute + auto-refund on failure)
ucm_balance	Check credit balance
ucm_history	View transaction history
ucm_service_info	Get service details
ucm_register	Self-register as agent, get API key + $1.00 credits
ucm_list_services	Browse the full service catalog

3. Typical flow

Agent: ucm_register(name: "my-agent")     → gets API key + $1.00 credits
Agent: ucm_discover(need: "web search")   → finds ucm/web-search
Agent: ucm_call(service_id: "ucm/web-search", endpoint: "search", body: {query: "..."})

Environment Variables

Variable	Required	Default	Description
UCM_API_KEY	No	—	Agent API key (ucm_key_*). Can also be obtained via ucm_register.
UCM_REGISTRY_URL	No	https://registry.ucm.ai	UCM Registry URL

How It Works

Agent → MCP Client → UCM MCP Server → UCM Registry → Provider APIs

• Your agent describes what it needs (e.g., "I need a web search API")
• The MCP server searches the UCM marketplace
• Agent calls the service — purchase and execution happen atomically
• If the upstream API fails, credits are automatically refunded

License

MIT