mcp-server · true402 — Claude Code MCP server for paid tools
Connect an agent to true402 tools for web research, SEO, LLM calls, and token checks. Paid calls settle in USDC on Base.
claude mcp add --env WALLET_PRIVATE_KEY=<WALLET_PRIVATE_KEY> --env SERVER_URL=<SERVER_URL> --env MAX_PAYMENT_USDC=<MAX_PAYMENT_USDC> --transport stdio true402-mcp-server -- npx -y @true402.dev/mcp-serverWhat mcp-server does
This MCP server exposes true402 tools for web extraction, SEO audits, search data, token and address checks, Base transaction analysis, and LLM calls. It discovers available tools from the live catalog at startup. list_models is free; other tools may charge per call.
Run it with Node.js 20 or later through npx. To pay, provide WALLET_PRIVATE_KEY for a Base wallet holding USDC. The server signs the payment authorization, while the facilitator covers gas. Without a wallet, paid tools return their payment requirements instead of running. MAX_PAYMENT_USDC caps spending per call, so check the ceiling before using seo_audit: its price is calculated per page.
What it helps with
- check a token and address before a trade
- review Base liquidity changes and large-wallet activity
- inspect a Base transaction before signing
- audit a page for SEO and retrieve search data
- extract web page content or inspect response headers
Example prompts for the agent
- Check this Base token for safety concerns and explain the result.
- Audit this page for SEO and retrieve its search rankings.
- Inspect this Base transaction before I sign it; flag reverts or unlimited approvals.
How to install mcp-server
Platform CLI
claude mcp add --env WALLET_PRIVATE_KEY=<WALLET_PRIVATE_KEY> --env SERVER_URL=<SERVER_URL> --env MAX_PAYMENT_USDC=<MAX_PAYMENT_USDC> --transport stdio true402-mcp-server -- npx -y @true402.dev/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add true402-mcp-server --env WALLET_PRIVATE_KEY=<WALLET_PRIVATE_KEY> --env SERVER_URL=<SERVER_URL> --env MAX_PAYMENT_USDC=<MAX_PAYMENT_USDC> -- npx -y @true402.dev/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"true402-mcp-server": {
"command": "npx",
"args": [
"-y",
"@true402.dev/mcp-server"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"SERVER_URL": "<SERVER_URL>",
"MAX_PAYMENT_USDC": "<MAX_PAYMENT_USDC>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"true402-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@true402.dev/mcp-server"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>",
"SERVER_URL": "<SERVER_URL>",
"MAX_PAYMENT_USDC": "<MAX_PAYMENT_USDC>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e WALLET_PRIVATE_KEY=<WALLET_PRIVATE_KEY> -e SERVER_URL=<SERVER_URL> -e MAX_PAYMENT_USDC=<MAX_PAYMENT_USDC> true402-mcp-server npx -y @true402.dev/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How do I install mcp-server in Claude Code?
Run claude mcp add mcp-server -e WALLET_PRIVATE_KEY=<WALLET_PRIVATE_KEY> -- npx -y @true402.dev/mcp-server. Set the key for a Base wallet funded with USDC.
What does mcp-server do?
It connects an agent to true402 tools for LLM calls, web tasks, SEO, and token or transaction analysis. Paid calls use x402 payments in USDC.
Can I use paid tools without a wallet?
Without WALLET_PRIVATE_KEY, paid tools return the payment requirements rather than making the call. Paying requires a Base wallet with USDC; the facilitator sponsors gas.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.
