{
  "markdown": "# @true402.dev/mcp-server\n\nMCP server for the **[true402](https://true402.dev)** machine-native marketplace — give your agent pay-per-call access to AI inference and web tools over [x402](https://x402.org) (HTTP 402 micropayments in USDC on Base).\n\nNo accounts, no API keys. The agent's **wallet is its identity**: each paid tool returns an HTTP 402 challenge, the server signs an EIP-3009 USDC authorization, and the call settles on-chain. Configure a funded wallet to auto-pay, or run without one and the paid tools will surface the exact payment requirements instead of failing.\n\n## Tools\n\n| Tool | Price | What it does |\n|------|-------|--------------|\n| `chat` | per-token + 3% | OpenAI-compatible LLM inference across many models |\n| `list_models` | free | List available models + pricing |\n| `token_safety` | $0.005 | ERC-20 rug/honeypot pre-check on Base → 0–100 score, risk band, flags, liquidity depth + a buy/sell honeypot simulation |\n| `seo_audit` | $0.04/page | SEO + GEO (generative-engine-optimization) audit of a page → structured report |\n| `web_extract` | $0.005 | Fetch a URL → clean text + markdown + links + metadata |\n| `link_preview` | $0.003 | Fetch a URL → Open Graph / unfurl card |\n| `robots_check` | $0.003 | A site's AI-crawler policy (GPTBot, ClaudeBot, Google-Extended, PerplexityBot, …) + sitemaps + llms.txt |\n| `headers_check` | $0.003 | HTTP security-headers analysis (HSTS, CSP, …) + a 0–100 score |\n| `new_pairs` | $0.003 | Newly created Base DEX pairs (Uniswap V3 / Aerodrome) — fresh token launches |\n| `liquidity_pulls` | $0.003 | Liquidity-removal / rug alerts on Base pools |\n| `whale_swaps` | $0.005 | Large swaps on Base by USD size — whale flow |\n| `token_report` | $0.01 | Fuller on-chain token report |\n| `liquidity_history` | $0.005 | What ALREADY happened to a Base token's liquidity — every removal with amount/block/tx, plus the other tokens drained in the same transaction. History a live simulation cannot re-derive |\n| `tx_preflight` | $0.008 | Check an **unsigned** Base transaction before signing: does it revert, does it grant an unlimited approval, and has the counterparty been seen draining liquidity. Takes no key and no signature, so it cannot broadcast or front-run |\n\nTools are **auto-discovered** from the live catalog, so new marketplace stalls appear automatically.\nPrices are illustrative; the live 402 challenge is authoritative.\n\n## Example: add token-safety to your agent\n\nA copy-paste reference in [`examples/token-safety/`](examples/token-safety/) — a framework-agnostic\nx402 client plus a drop-in LangChain tool that rug/honeypot-checks any Base token for $0.005/call.\n\n## Install\n\nRequires Node.js ≥ 20. Runs over stdio — point any MCP client at it via `npx`.\n\n### Claude Desktop / Claude Code\n\nAdd to your MCP config (`claude_desktop_config.json`, or `.mcp.json` for Claude Code):\n\n```json\n{\n  \"mcpServers\": {\n    \"true402\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@true402.dev/mcp-server\"],\n      \"env\": {\n        \"WALLET_PRIVATE_KEY\": \"0xYOUR_FUNDED_BASE_WALLET_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / Cline / other MCP clients\n\nSame idea — command `npx`, args `[\"-y\", \"@true402.dev/mcp-server\"]`, and the `WALLET_PRIVATE_KEY` env var.\n\n## Configuration\n\n| Env var | Default | Description |\n|---------|---------|-------------|\n| `SERVER_URL` | `https://true402.dev/api` | true402 API base. Override to point at a self-hosted instance. |\n| `WALLET_PRIVATE_KEY` | _(none)_ | A funded **Base** wallet private key used to sign x402 payments. Needs **USDC** (gas is sponsored by the facilitator — no ETH required). Without it, paid tools return the 402 requirements instead of paying. |\n| `MAX_PAYMENT_USDC` | `0.25` | Hard per-call spend ceiling in USDC. This server **auto-discovers every paid stall** the marketplace advertises (it walks the live OpenAPI spec, not a fixed list), so a new or repriced stall can appear above the default at any time — a call over the ceiling is refused (not paid, not crashed), and the refusal names the price and the ceiling. Raise it if a discovered tool's description shows a price close to or over your configured value; one stall (`seo_audit`) is priced **per page** and can itself exceed a typical ceiling on a large page. |\n\n> **Security:** the key is read only from the environment and is never logged, echoed, or returned. Use a dedicated low-balance wallet — fund it with only what you intend to spend.\n\n## How payment works\n\n1. The tool calls the true402 endpoint with no payment.\n2. The server replies `402` with accepted payment options (USDC on Base).\n3. This MCP server signs an EIP-3009 `transferWithAuthorization` with your wallet.\n4. It retries with the signed `X-PAYMENT` header; the service verifies and responds.\n5. Settlement happens on-chain. Your wallet pays only USDC — the facilitator sponsors gas.\n\n## Links\n\n- Marketplace: <https://true402.dev>\n- Free Telegram rug-check bot (no wallet): <https://t.me/True402bot>\n- Live tool catalog: <https://true402.dev/api/v1/services>\n- x402 protocol: <https://x402.org>\n\n## Also available for\n\nMCP (Claude Code / Desktop, Cursor, **Hermes**) · **Hermes Agent** · **OpenClaw** · **ElizaOS** ·\n**LangChain** · **CrewAI** · **Vercel AI SDK** · **Coinbase AgentKit** · **Virtuals GAME** · CLI —\nsame on-chain checks, one install command each:\n**[true402.dev/integrations](https://true402.dev/integrations)**\n\n## Paying, exactly\n\nThe rules below are the service's, not this package's — they bite whatever client you use, and they\nare the ones that surprise people writing their own payer.\n\n- **Pay the EXACT amount quoted in the 402.** Underpaying is rejected. **Overpaying is refused with\n  403 and never credited** — settlement submits the signed value and there is no refund path, so a\n  surplus would simply be swept. Equality is also what binds an authorization to the resource it was\n  quoted for.\n- **One authorization buys exactly one response.** A replay is refused, not double-charged.\n- **You are charged on success only.** Settlement is submitted only when the endpoint returns 2xx; if\n  it errors or times out, your signed authorization is never submitted, so there is nothing to refund.\n- Some endpoints serve a few free calls per day per client IP, with no wallet. The per-operation\n  description in the [OpenAPI spec](https://true402.dev/api/openapi.json) says which.\n\nFull rules: **[true402.dev/terms](https://true402.dev/terms)** · what is logged and kept:\n**[true402.dev/privacy](https://true402.dev/privacy)**\n\n## License\n\nMIT\n",
  "bytes": 6529,
  "sha": "bc28c086e940ead9740ee646da02ce89750f60480f95c408b31a313968503757",
  "repo_slug": "true402/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_true402_mcp_server_cebbc897/readme"
}