x402farm-mcp

MCP server that gives AI agents pay-per-call access to x402-farm — no API keys, no subscription. Each tool is a named job billed in USDC on Base via the x402 protocol.

Tools

| Tool | Job | Price | |---|---|---| | honeypot_check | Token honeypot / rug-pull verdict (OK/CAUTION/HIGH_RISK/AVOID) before trading — 8 chains | $0.006 | | token_market | Live token price, liquidity, volume, FDV by address | $0.004 | | defi_yields | Best DeFi APY pools for a token | $0.005 | | crypto_gas | Current gas price on a chain | $0.003 | | crypto_trending | Trending tokens / hot pairs | $0.004 | | scrape_url | Fetch any URL via a residential IP → clean markdown (reaches sites that block datacenter scrapers) | $0.005 | | web_screenshot | Full-page screenshot via residential IP | $0.006 | | company_kyb_fr | French company KYB (identity, VAT/VIES, insolvency, solidity) | $0.10 | | us_company | US public company / SEC EDGAR by ticker | $0.02 |

Payment

• With a wallet — set X402_PRIVATE_KEY (a wallet funded with USDC on Base). Every call is paid automatically (gasless x402). This is the normal mode for autonomous agents.
• Without a wallet — tools return the HTTP 402 payment instructions so your host can pay however it wants.

Install

Claude Code

claude mcp add x402-farm -- npx -y x402farm-mcp
# with auto-pay:
claude mcp add x402-farm --env X402_PRIVATE_KEY=0xYOUR_KEY -- npx -y x402farm-mcp

Claude Desktop / Cursor / any MCP client

{
  "mcpServers": {
    "x402-farm": {
      "command": "npx",
      "args": ["-y", "x402farm-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_USDC_WALLET" }
    }
  }
}

Run from source (before npm publish)

cd mcp-server && npm install
X402_PRIVATE_KEY=0x… node index.js

Then point your MCP client's command/args at node /absolute/path/mcp-server/index.js.

Config

• X402_PRIVATE_KEY — optional. Funded USDC-on-Base wallet for auto-pay.
• X402_FARM_BASE — optional. Defaults to https://api.x-402.online.

Example — a pre-trade safety gate

An agent building a trade calls honeypot_check(address, chain) and only proceeds when verdict is OK or CAUTION — turning "can I buy this?" into one paid call instead of a per-chain simulation stack.

Made by x402-farm · 85 endpoints, /openapi.json with per-route x-payment-info.