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

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.