@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. Generate Ed25519 keys

node -e "
import('@noble/ed25519').then(async ed => {
  const priv = ed.utils.randomPrivateKey();
  const pub = await ed.getPublicKeyAsync(priv);
  console.log('UCM_PRIVATE_KEY=' + Buffer.from(priv).toString('hex'));
  console.log('UCM_PUBLIC_KEY=' + Buffer.from(pub).toString('hex'));
})
"

2. Configure your MCP client

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "ucm": {
      "command": "npx",
      "args": ["@ucm/mcp-server"],
      "env": {
        "UCM_REGISTRY_URL": "https://registry.ucm.ai",
        "UCM_PRIVATE_KEY": "<your-private-key-hex>",
        "UCM_PUBLIC_KEY": "<your-public-key-hex>"
      }
    }
  }
}

3. Use via your agent

Your agent now has access to 11 tools:

Tool	Description
ucm_discover	Search marketplace by natural language
ucm_buy	Purchase service access token
ucm_call	Buy + call provider API in one step
ucm_balance	Check budget remaining
ucm_history	View transaction history
ucm_service_info	Get service details
ucm_register	Self-register as agent, get API key
ucm_publish	Publish a service on the marketplace
ucm_delete_service	Remove a service
ucm_authorize	Create budget authorization for an agent
ucm_verify_token	Verify an ACP access token

Environment Variables

Variable	Required	Default	Description
UCM_PRIVATE_KEY	Yes	—	Ed25519 private key (hex)
UCM_PUBLIC_KEY	Yes	—	Ed25519 public key (hex)
UCM_REGISTRY_URL	No	http://localhost:3000	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 selects a service and purchases access
• The access token is used to call the provider API directly

License

MIT