@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

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

License

MIT