Base Token Facts

本地服务

base-facts.yankii.fr金融数据02 周前更新

代码仓库访问官网

关于 Base Token Facts

Base Token Facts 是面向需要检查 Base 链代币、钱包和交易的 Agent 的 MCP 服务。它通过 x402 使用 USDC 按次支付 API 调用费用，并标明每项结果对应的区块。

主要功能

01评估代币风险标记和评分
02模拟代币买卖以检查税费
03单次筛查最多 10 种代币
04按指定交易规模检查卖出影响
05读取钱包余额、Gas 和交易详情
06将 Basename 解析为地址

适用场景

01买入前检查代币
02比较不同代币的税费和损失估算
03按计划交易规模评估资金池深度
04检查钱包或 Base 链交易

MCP 相关

该 MCP 服务向 MCP 客户端提供 Base Token Facts 检查工具。调用通过 x402 从配置的钱包以 USDC 支付，并设有单次费用上限和会话预算。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "yankiifr-base-facts": {
      "command": "npx",
      "args": [
        "-y",
        "base-facts-mcp"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>",
        "SESSION_BUDGET_USD": "<SESSION_BUDGET_USD>"
      }
    }
  }
}

启动命令npx -y base-facts-mcp

需要配置的环境变量

X402_PRIVATE_KEY密钥Private key of a small x402 payer wallet holding a little USDC on Base (pays $0.002-$0.01 per call). Alternative: X402_PAYER_FILE.

SESSION_BUDGET_USDStop paying once this much was spent in the session (default 1).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmbase-facts-mcp0.2.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
token	string	是	Base 上的代币合约地址

详细介绍

base-facts-mcp

为在 Base 上交易或转移资金的 AI Agent 提供的 MCP 服务。每个工具都会调用 Base Token Facts，并通过 x402 使用你控制的小额钱包为调用本身付款。每个答案都基于同一个区块读取，并注明对应区块。

工具	价格	回答内容
`base_token_verdict`	$0.01	购买代币前查询：风险等级、评分和标记（代理合约、铸造、暂停、黑名单、所有者、DEX 流动性），每项均附带对应的链上事实
`base_token_sellcheck`	$0.005	貔貅盘和税费检查：在最深的池中模拟小额买入并立即卖出，返回买入／卖出税费及往返损失
`base_token_batch_screen`	$0.03	一次调用并付款，即可对最多 10 个代币进行相同模拟（每个代币返回税费、往返损失和标记）
`base_token_sellcheck_size`	$0.01	按你的交易规模进行相同检查（`amountEth` 为 0.001 至 10 ETH）：税费、往返损失、买入价格影响，以及交易规模超出池子承受能力时的深度警告
`base_token_facts`	$0.005	ERC20 元数据、所有者、代理合约及实现合约、字节码中的管理函数选择器
`base_wallet_snapshot`	$0.002	ETH 和 USDC 余额、nonce、是否为合约
`base_gas`	$0.001	Base 基础费、优先费、Gas 价格
`base_tx_summary`	$0.003	交易状态、费用及解码后的 ERC20 转账
`basename_resolve`	$0.002	将 `name.base.eth` 解析为地址，或将地址解析为其已验证的主 Basename
`base_facts_budget`	免费	本次会话的支出

这些是事实和启发式判断，不构成财务建议。API 文档和实时收入计数器： https://base-facts.yankii.fr 和 https://base-facts.yankii.fr/stats

设置

创建一个专用钱包，并在 Base 网络上存入少量 USDC（1 USDC 可支付 100 次风险判定）。无需 ETH：x402 促进方会支付 Gas。切勿使用主钱包。
将服务添加到你的 MCP 客户端，例如 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 的内容为 { "privateKey": "0x..." }；也可以使用 X402_PRIVATE_KEY。如果两者都未设置，且 ~/.base-facts-mcp/payer.json 文件存在，服务会使用该文件。

每项设置也都有对应的选项，适用于只传入 command 和 args 的宿主（Preste）： --payer-file <path>、--max-price <usd>、--budget <usd>、--api <url>。Preste 配置和技能请参阅 integrations/preste/。

支出安全

每个工具都有自己的金额上限（其公布价格：Gas 为 0.001，批量检查为 0.03，依此类推）：如果某个路由请求的金额超过其公布价格，无论 MAX_PRICE_USD 的值是什么，都会被拒绝。
如果付款签名后，付费调用的答案丢失，该金额仍会计入会话预算（付款可能已结算），并且工具会说明这一点：重试前请检查钱包。
MAX_PRICE_USD（默认值为 0.03）：客户端不会为任何超过此金额的单笔付款签名。
SESSION_BUDGET_USD（默认值为 1）：达到上限后，客户端会停止签名，直至重启。
BASE_FACTS_PAY_TO（使用默认 API 时，默认值为官方地址）：客户端唯一会为其签名的收款方。使用自定义 BASE_FACTS_URL 时必须设置此项；未设置则不会签名。客户端也只会为 Base USDC（0x8335…2913）签名。
只会为 Base 上的 USDC（eip155:8453）签名。
被拒绝或失败的调用（4xx/5xx）会取消结算：你不会被扣款，工具会返回 charged: false 以及原因（例如 USDC 不足）。
付费调用会逐个运行，以确保预算计数准确。