ulvane-mcp

An MCP server that lets AI agents (Claude Desktop, Cursor, any MCP client) call Ulvane's onchain intelligence for Base as tools. Each paid call is settled per-request in USDC on Base via x402 — no API keys, no accounts.

Setup

No install step — add this to your MCP client config (Claude Desktop: claude_desktop_config.json) and it runs via npx:

{
  "mcpServers": {
    "ulvane": {
      "command": "npx",
      "args": ["-y", "ulvane-mcp"],
      "env": { "EVM_PRIVATE_KEY": "0x..." }
    }
  }
}

Restart Claude Desktop fully, then use it from a regular chat.

To run from source instead: git clone https://github.com/fatihaura/ulvane-mcp && cd ulvane-mcp && npm install, then use "command": "node" with "args": ["/absolute/path/to/ulvane-mcp/index.mjs"].

Use a dedicated wallet holding only a few dollars of USDC on Base. The key is read locally and only used to sign x402 payment authorizations; it is never sent to Ulvane. Without EVM_PRIVATE_KEY, only the free base_leaderboard tool works.

Optional env: ULVANE_MAX_PRICE_USD (per-call spend cap, default 0.05), ULVANE_BASE_URL.

Every paid response is EIP-191 signed by Ulvane — see the docs for offline verification.

Related MCP server: dyoe-agent-tools-mcp

License

MIT