X402 Tools MCP Server

by mizukaizenio.github.mizukaizen/x402-tools-mcpv0.1.4

22 x402 pay-per-call utility tools for AI agents — scrape, validate, embed, store, moderate, notify, convert, prevent loops. No accounts, no API keys. USDC on Base via the x402 protocol.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing5mo ago

Install X402 Tools MCP server

claude mcp add x402-tools -e X402_PAYMENT_HEADER='<x402-payment-header>' -e X402_INTERNAL_KEY='<x402-internal-key>' -- npx -y @melis-ai/x402-tools-mcp

{
  "mcpServers": {
    "x402-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@melis-ai/x402-tools-mcp"
      ],
      "env": {
        "X402_PAYMENT_HEADER": "<x402-payment-header>",
        "X402_INTERNAL_KEY": "<x402-internal-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "x402-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@melis-ai/x402-tools-mcp"
      ],
      "env": {
        "X402_PAYMENT_HEADER": "<x402-payment-header>",
        "X402_INTERNAL_KEY": "<x402-internal-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "x402-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@melis-ai/x402-tools-mcp"
      ],
      "env": {
        "X402_PAYMENT_HEADER": "<x402-payment-header>",
        "X402_INTERNAL_KEY": "<x402-internal-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "x402-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@melis-ai/x402-tools-mcp"
      ],
      "env": {
        "X402_PAYMENT_HEADER": "<x402-payment-header>",
        "X402_INTERNAL_KEY": "<x402-internal-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
X402_PAYMENT_HEADER	—	yes	Signed x402 payment token from your wallet client. Set if handling payments manually.
X402_INTERNAL_KEY	—	yes	Bypass key for trusted internal callers — skips x402 payment flow entirely.

Freshness

Slowing — last maintenance signal 5mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-05-15 · 5mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-05-15 · 5mo ago · official registry · v0.1.4

FAQ

›How do I install the X402 Tools MCP server in Claude Code?

Run: claude mcp add x402-tools -e X402_PAYMENT_HEADER='<x402-payment-header>' -e X402_INTERNAL_KEY='<x402-internal-key>' -- npx -y @melis-ai/x402-tools-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does X402 Tools require an API key?

Yes. It expects X402_PAYMENT_HEADER, X402_INTERNAL_KEY, of which 2 are secrets.

›Can I use X402 Tools as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is X402 Tools in the official MCP registry?

Yes, as io.github.mizukaizen/x402-tools-mcp.