Base Token Facts MCP Server

by yankiifrio.github.yankiifr/base-facts-mcpv0.2.3

MCP server for AI agents trading on Base: token verdict, token facts, wallet, gas, transaction and Basename lookups, paid per call in USDC over x402

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active2d ago

Install Base Token Facts MCP server

claude mcp add base-facts -e X402_PRIVATE_KEY='<x402-private-key>' -- npx -y base-facts-mcp

{
  "mcpServers": {
    "base-facts": {
      "command": "npx",
      "args": [
        "-y",
        "base-facts-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<x402-private-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "base-facts": {
      "command": "npx",
      "args": [
        "-y",
        "base-facts-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<x402-private-key>"
      }
    }
  }
}

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

{
  "servers": {
    "base-facts": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "base-facts-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<x402-private-key>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "base-facts": {
      "command": "npx",
      "args": [
        "-y",
        "base-facts-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<x402-private-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
X402_PRIVATE_KEY	—	yes	Private key of a small x402 payer wallet holding a little USDC on Base (pays $0.002-$0.01 per call). Alternative: X402_PAYER_FILE.
SESSION_BUDGET_USD	—	—	Stop paying once this much was spent in the session (default 1).

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 3d ago · official registry · v0.2.3

FAQ

›How do I install the Base Token Facts MCP server in Claude Code?

Run: claude mcp add base-facts -e X402_PRIVATE_KEY='<x402-private-key>' -- npx -y base-facts-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Base Token Facts require an API key?

Yes. It expects X402_PRIVATE_KEY, of which 1 is a secret.

›Can I use Base Token Facts as a remote (hosted) MCP server?

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

›Is Base Token Facts in the official MCP registry?

Yes, as io.github.yankiifr/base-facts-mcp.