gate402-mcp

MCP server for Gate402 — pay-per-call agent APIs over HTTP 402 (x402 / USDC on Base). Gives any MCP client four tools with no signup and a free tier on first runs:

Tool	What it does	Price
gate402_scrape	Fetch any public URL, render JS, strip nav/ads → clean LLM-ready Markdown	$0.002
gate402_scrape_stealth	Hardened headless fetch for JS-heavy / bot-protected pages	$0.05
gate402_minify	Compress text to cut downstream LLM token spend (~40%)	$0.005 / 10k tok
gate402_dedup	Semantic vector-cache lookup (exact + cosine)	$0.001 hit / $0.003 miss
gate402_onchain	On-chain wallet/token intel on Base (balances, EOA/contract, tx count, token metadata)	$0.01
gate402_dex	Live DEX price / liquidity / 24h volume for a Base token	$0.01
gate402_news	Recent news headlines + bull/bear sentiment for a ticker/topic	$0.02
gate402_edgar	Latest SEC EDGAR filings (10-K/10-Q/8-K) for a US ticker	$0.02

…plus three free tools that run locally in this process (pure compute — no payment, no key, no network):

Tool	What it does
gate402_token_count	Estimate the token count of a string (budget your context window)
gate402_html_to_md	Convert an HTML string you already have into clean Markdown
gate402_json_repair	Coerce malformed / LLM-mangled JSON into valid JSON

How billing works

On first use the server self-claims a free-credit API key from Gate402 and caches it at ~/.gate402-mcp/key.json. Calls draw down that credit. When it runs out, tools return a top-up link instead of failing. To skip the free tier, set GATE402_API_KEY to a funded account (top up).

The payment is the auth — there are no accounts to create.

Install

npm install -g gate402-mcp

Or run without installing via npx gate402-mcp.

Configure your MCP client

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json, or claude mcp add):

{
  "mcpServers": {
    "gate402": {
      "command": "npx",
      "args": ["-y", "gate402-mcp"]
    }
  }
}

Cursor / Cline / Windsurf

Same shape — point the MCP server command at npx -y gate402-mcp.

Environment variables

Var	Default	Purpose
GATE402_API_KEY	(unset)	Use a funded account instead of the free tier.
GATE402_BASE_URL	https://gate402.app	Override the gateway (self-hosting / testing).
GATE402_CONFIG_DIR	~/.gate402-mcp	Where the cached free key is stored.

Develop

npm install
npm run build
npm start          # or: npm run dev

License

MIT