English Français العربية

io.github.mercuryx402/mercury-x402-mcp

Official registry AI and agents

Agent-payable web data over x402: 18 keyless services an agent pays per call.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mercury-x402-mcp 'https://network.mercury-hq.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mercury-x402-mcp": {
            "type": "http",
            "url": "https://network.mercury-hq.com/mcp"
        }
    }
}
NPM package mercury-x402-mcp
Claude Code 
claude mcp add mercury-x402-mcp -- npx -y mercury-x402-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mercury-x402-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mercury-x402-mcp@1.0.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

mercury-x402-mcp

17 keyless, signed-provenance web-data tools your AI agent can pay for itself — over x402 on Base mainnet (USDC). No Mercury API key, no account, no signup. Your agent calls a tool, it pays the SKU with your wallet, and gets back the result plus an EIP-191 provenance receipt it can verify offline, forever.

Tools include: clean fetch, LLM-ready markdown, structured extract, link graph, robots, diff, notarize, headers, table extract, feed, availability, validate, batch, sitemap, DNS, readability, redirect — built live from Mercury's catalog, so the list is always current.

Install

npx mercury-x402-mcp

Add to your MCP host (Claude Desktop / Cursor / Cline / any MCP client):

{
  "mcpServers": {
    "mercury": {
      "command": "npx",
      "args": ["-y", "mercury-x402-mcp"],
      "env": {
        "MERCURY_PRIVATE_KEY": "0xYOUR_BASE_MAINNET_WALLET_KEY"
      }
    }
  }
}

MERCURY_PRIVATE_KEY is your Base-mainnet wallet (funded with a little USDC). Mercury is keyless — the only thing you bring is a wallet to pay per call. Tools cost ~$0.003–$0.02 each.

The mercury_catalog and mercury_verify tools work without a wallet (free).

Why

Firecrawl / Jina / Tavily all gate behind a human-created API key + a credit-card plan — an agent can't onboard itself. Mercury can: an agent discovers the tools, pays over x402, and every result is cryptographically signed so the bytes are provably genuine and untampered — what RAG, trading, and agent-to-agent commerce actually need.

Discovery: https://mercury-x402-jed.fly.dev/.well-known/x402 · https://mercury-x402-jed.fly.dev/llms.txt

Frequently asked questions

What is io.github.mercuryx402/mercury-x402-mcp?

Agent-payable web data over x402: 18 keyless services an agent pays per call.

How do I install io.github.mercuryx402/mercury-x402-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http mercury-x402-mcp 'https://network.mercury-hq.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.mercuryx402/mercury-x402-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.mercuryx402/mercury-x402-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.mercuryx402/mercury-x402-mcp?

It is published by mercuryx402. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.