# x402farm-mcp

MCP server that gives AI agents **pay-per-call** access to [x402-farm](https://api.x-402.online) — no API keys, no subscription. Each tool is a named job billed in USDC on Base via the [x402](https://x402.org) 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
```bash
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
```json
{
  "mcpServers": {
    "x402-farm": {
      "command": "npx",
      "args": ["-y", "x402farm-mcp"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_USDC_WALLET" }
    }
  }
}
```

### Run from source (before npm publish)
```bash
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](https://api.x-402.online) · 85 endpoints, `/openapi.json` with per-route `x-payment-info`.