Base Token Facts

io.github.yankiifrv0.2.1更新于 Oct 6, 2026

Base token checks for agents: simulated buy and sell, taxes, honeypots. Pay per call in USDC (x402).

已验证STDIO仅桌面Security & MonitoringFinance

概览

AI 生成的概览

让助手在交易前核查 Base 代币：风险判定、蜜罐与税费模拟、钱包与 Gas 数据，按次以 USDC 付费。

功能
它提供一组只读工具查询 Base Token Facts 服务：base_token_verdict 返回风险等级、评分与代理、增发、暂停、黑名单、所有者、DEX 流动性等标记；base_token_sellcheck 在最深池上模拟小额买入并立即卖出，给出买入/卖出税费与往返损失；base_token_facts 返回 ERC20 元数据、所有者、代理与实现；base_wallet_snapshot、base_gas、base_tx_summary 和 basename_resolve 分别覆盖余额、费用、交易解码与 Basename 解析。base_facts_budget 显示本次会话已花费金额。每次付费调用通过 x402 从你控制的钱包以 USDC 结算，答案基于单一区块读取。
适用场景
当助手准备在 Base 上买入、卖出或转移代币，需要先获取链上事实并做蜜罐或税费检查时使用。它面向在 Base 上交易或转移资金的智能体工作流，而非通用区块链浏览。
运行要求
以 stdio 在本地运行，通常通过 npx base-facts-mcp，因此需要 Node.js。需要一个专用的 Base 钱包并存入少量 USDC，通过 X402_PRIVATE_KEY 或付款方文件提供（X402_PAYER_FILE，默认 ~/.base-facts-mcp/payer.json）。可选设置包括 MAX_PRICE_USD 与 SESSION_BUDGET_USD。需要访问 Base Token Facts API 的网络连接；未声明账号或登录。
安装前请注意
该服务器会在 Base 上签署真实的 USDC 付款，每次调用 0.001 至 0.01 美元，因此有资金的钱包存在风险；请使用专用钱包，切勿使用主钱包。X402_PRIVATE_KEY 与付款方文件包含私钥，必须妥善保护。MAX_PRICE_USD 与 SESSION_BUDGET_USD 限制单次与单会话支出，失败的调用不会扣费。输出为事实与启发式判断，不构成财务建议。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Base Token Facts，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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.

ToolPriceAnswers
base_token_verdict$0.01Before 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.005Honeypot and tax check: simulates a small buy and immediate sell on the deepest pool, returns buy/sell tax, round-trip loss
base_token_facts$0.005ERC20 metadata, owner, proxy and implementation, admin selectors in the bytecode
base_wallet_snapshot$0.002ETH and USDC balances, nonce, contract or not
base_gas$0.001Base fee, priority fee, gas price
base_tx_summary$0.003Status, fee and decoded ERC20 transfers of a transaction
basename_resolve$0.002name.base.eth to address, or address to its verified primary Basename
base_facts_budgetfreeWhat 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

Setup

  1. Make a dedicated wallet and put a little USDC on it, on the Base network (1 USDC pays for 100 verdicts). No ETH is needed: the x402 facilitator pays the gas. Never use your main wallet.
  2. Add the server to your MCP client, for example claude_desktop_config.json:
json
{  "mcpServers": {    "base-facts": {      "command": "npx",      "args": ["-y", "base-facts-mcp"],      "env": {        "X402_PAYER_FILE": "/path/to/payer.json",        "MAX_PRICE_USD": "0.02",        "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.

Spending safety

  • MAX_PRICE_USD (default 0.02): the client refuses to sign any single payment above it.
  • SESSION_BUDGET_USD (default 1): once reached, the client stops signing until restarted.
  • Only USDC on Base (eip155:8453) is ever signed.
  • A refused or failed call (4xx/5xx) cancels the settlement: you are not charged, and the tool says charged: false with the reason (for example not enough USDC).
  • Paid calls run one at a time so the budget count stays exact.

Development

npm test drives the server over stdio like a real client, with empty wallets: no USDC is spent.

来源：README.md，提交 9ad460f

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.2.1最新Oct 6, 2026