walletbureau

@walletbureau/mcp

确认你即将向谁付款。 一个 MCP 服务，为你的 Agent 提供一个工具：在你向 Base 上的钱包转账前，评估其行为风险。

评分依据是 Base 上 x402 / EIP-3009 USDC 付款的完整历史记录——地址存在了多久、谁向它付款、其流入资金的集中程度，以及它的活动是否刚刚激增。你会得到一个 0 到 100 的数字、一个判定（ok / caution / avoid），以及生成这些结果的风险标记，每项都附有通俗易懂的原因。

这些是风险信号，不是指控。方法论：https://walletbureau.com/methodology

安装

npm i @walletbureau/mcp --ignore-scripts

该软件包提供可直接运行的 JavaScript。无需安装脚本、原生模块，也无需在你的机器上构建——--ignore-scripts 在这里不会有任何影响，这是有意为之。

Claude Code

claude mcp add walletbureau -- npx -y @walletbureau/mcp

Claude Desktop / Cursor / 任意 MCP 客户端

将以下内容添加到你的 MCP 配置中（Claude Desktop 使用 claude_desktop_config.json）：

{
  "mcpServers": {
    "walletbureau": {
      "command": "npx",
      "args": ["-y", "@walletbureau/mcp"]
    }
  }
}

全部设置就是这些。没有凭据时，服务会使用公开的免费配额——每天可检查几次——足以让你试用。若要继续使用，请在下方选择一种付款方式。

支付检查费用

完整检查费用为 $0.01。服务根据环境变量选择模式：

模式	设置此项	运行方式
免费试用	无	使用公开的试用配额（每个 IP 地址每天可检查几次）。
预付密钥	WALLETBUREAU_API_KEY=atk_…	每次检查从密钥余额中扣款。不涉及加密货币。
钱包（x402）	X402_PRIVATE_KEY=0x…	服务会通过 x402 自动为每次检查在 Base 上支付 $0.01 的 USDC。

如果两项都已设置，将优先使用预付密钥——其余额已经预付，链上付款会造成重复收费。

{
  "mcpServers": {
    "walletbureau": {
      "command": "npx",
      "args": ["-y", "@walletbureau/mcp"],
      "env": { "WALLETBUREAU_API_KEY": "atk_your_key_here" }
    }
  }
}

使用钱包付款时

X402_PRIVATE_KEY 是真实的支出密钥。请像保护其他支出密钥一样保护它：

• 使用一个专用钱包，并只为其充值少量 USDC——不要使用你的主账户。
• 密钥不会离开你的机器。它用于签署 x402 付款，不会被记录、发送给服务，也不会包含在工具输出中。服务只会看到付款。
• X402_MAX_PRICE_USD（默认值为 0.10）会限制单次调用的费用上限。价格由远程服务报价，因此这项检查设置在代码中、紧邻签名步骤，而不是放在提示词里。

工具

check_counterparty — 付费

输入：{ "address": "0x…" }——Base 上的钱包地址。

返回完整报告：评分、判定、附带原因的风险标记，以及背后的汇总统计数据。调用前，客户端可以在工具描述和工具 _meta 下的 walletbureau/pricing 中看到价格。

{
  "address": "0x…",
  "score": 74,
  "verdict": "ok",
  "flags": [
    { "code": "activity_spike", "severity": "low",
      "reason": "Volume over the last 24 h is 12× the median of the last 30 days" }
  ],
  "stats": {
    "first_seen": "2025-11-02T…Z", "tx_in": 1204, "tx_out": 17,
    "volume_in_usd": "604.31", "volume_out_usd": "12.05",
    "distinct_payers": 311, "confidence_basis": "confirmed+probable"
  },
  "meta": { "computed_at": "…", "cache_age_seconds": 312, "api_version": "v1", "disclaimer": "…" }
}

响应架构是一份稳定的契约：只会添加字段；重命名或删除字段意味着推出新的 API 版本。该架构与 API 一同以 JSON Schema 形式发布。

get_service_stats — 免费

无需输入。公开显示索引统计数据：已索引地址数、已录入转账数、已提供评分数。

配置

变量	默认值	含义
API_BASE_URL	https://walletbureau.com	服务所在位置。仅在需要指向你自己的部署时更改。
WALLETBUREAU_API_KEY	—	预付 API 密钥，atk_…。
X402_PRIVATE_KEY	—	用于通过 x402 按次付款的私钥。
X402_MAX_PRICE_USD	0.10	单次付费调用的硬性价格上限。
REQUEST_TIMEOUT_MS	5000	向服务发送未付款请求的超时时间。
PAYMENT_TIMEOUT_MS	60000	付费调用的时间预算，包括签名和链上结算。

服务只向 stderr 写入日志——stdout 专用于 MCP 协议。

此服务不会做什么

它不包含评分逻辑，也不拥有自己的数据：它只是公共 HTTP API 的轻量封装，因此方法论的修正无需升级软件包，你就能获得更新。它也没有本地缓存——服务本身会缓存数据，另存一份只会导致两者逐渐不一致。

许可证

Apache-2.0