base-facts-mcp
An MCP server for AI agents that trade or move money on Base. Each tool calls Base Token Facts and pays for the call itself in USDC over x402, from a small wallet you control. Every answer is read at one block and says which.
Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
claude mcp add base-facts-mcp -- npx -y base-facts-mcp@0.3.1Execute em um terminal.
{ "mcpServers": { "base-facts-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDo publicador
An MCP server for AI agents that trade or move money on Base. Each tool calls Base Token Facts and pays for the call itself in USDC over x402, from a small wallet you control. Every answer is read at one block and says which.
MCP server for AI agents trading on Base: token verdict, token facts, wallet, gas, transaction and Basename lookups, paid per call in USDC over x402
| Tool | Price | Answers |
|---|---|---|
base_token_verdict | $0.01 | Before buying a token: risk level, score and flags (proxy, mint, pause, blacklist, owner, DEX liquidity), each with its on-chain fact |
base_token_sellcheck | $0.005 | Honeypot and tax check: simulates a small buy and immediate sell on the deepest pool, returns buy/sell tax, round-trip loss |
base_token_batch_screen | $0.03 | The same simulation for up to 10 tokens in one call and one payment (per token: taxes, round-trip loss, flags) |
base_token_sellcheck_size | $0.01 | The same check at your trade size (amountEth, 0.001 to 10 ETH): tax, round-trip loss, buy price impact and a depth warning when the size is larger than the pool can absorb |
base_token_facts | $0.005 | ERC20 metadata, owner, proxy and implementation, admin selectors in the bytecode |
base_wallet_snapshot | $0.002 | ETH and USDC balances, nonce, contract or not |
base_gas | $0.001 | Base fee, priority fee, gas price |
base_tx_summary | $0.003 | Status, fee and decoded ERC20 transfers of a transaction |
basename_resolve | $0.002 | name.base.eth to address, or address to its verified primary Basename |
base_facts_budget | free | What this session has spent |
Facts and heuristics, not financial advice. API docs and live revenue counter: https://base-facts.yankii.fr and https://base-facts.yankii.fr/stats
claude_desktop_config.json:{
"mcpServers": {
"base-facts": {
"command": "npx",
"args": ["-y", "base-facts-mcp"],
"env": {
"X402_PAYER_FILE": "/path/to/payer.json",
"MAX_PRICE_USD": "0.03",
"SESSION_BUDGET_USD": "1"
}
}
}
}
payer.json is { "privateKey": "0x..." }; X402_PRIVATE_KEY works too. Without either, the server
uses ~/.base-facts-mcp/payer.json when it exists.
Every setting also exists as an option, for hosts that pass only command and args (Preste):
--payer-file <path>, --max-price <usd>, --budget <usd>, --api <url>. See
integrations/preste/ for the Preste config and skill.
MAX_PRICE_USD says.MAX_PRICE_USD (default 0.03): the client refuses to sign any single payment above it.SESSION_BUDGET_USD (default 1): once reached, the client stops signing until restarted.BASE_FACTS_PAY_TO (default: the official address when using the default API): the only recipient the client will sign for. Required with a custom BASE_FACTS_URL; without it nothing is signed. The client also signs only Base USDC (0x8335…2913).eip155:8453) is ever signed.charged: false with the reason (for example not enough USDC).npm test drives the server over stdio like a real client, with empty wallets: no USDC is spent.
MCP server for AI agents trading on Base: token verdict, token facts, wallet, gas, transaction and Basename lookups, paid per call in USDC over x402
{ "mcpServers": { "base-facts-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
Base Facts roda localmente via stdio.
Última verificação: 2026-10-28. MCP server for AI agents trading on Base: token verdict, token facts, wallet, gas, transaction and Basename lookups, paid per call in USDC over x402