Model Context Protocol

mcp

One stdio server, three tools. Catalog and request schemas load on demand so connecting does not dump 14 fat schemas into context.

Tool	What it does
list_utilities	GET /v1/meta — names, prices, endpoints (free)
describe_utility	Request body schema for one utility from OpenAPI (free)
call_utility	POST the utility with body; pays via x402 or API key

Install

Package lives at mcp/ in the util.beauty repo (publish as util-beauty-mcp when ready).

Claude Code

claude mcp add util-beauty \
  -e X402_PRIVATE_KEY=0x... \
  -- npx -y util-beauty-mcp

Cursor / Claude Desktop (snippet)

{
  "mcpServers": {
    "util-beauty": {
      "command": "npx",
      "args": ["-y", "util-beauty-mcp"],
      "env": {
        "X402_PRIVATE_KEY": "0x...",
        "UTIL_BEAUTY_BASE_URL": "https://util.beauty"
      }
    }
  }
}

Env

X402_PRIVATE_KEY — preferred; USDC on Base
UB_API_KEY — optional prepaid early-access key
UTIL_BEAUTY_BASE_URL — default https://util.beauty

Prefer the Claude skill if you do not need MCP — lower setup cost for many agents.