legible-check

legible-check — 面向 AI Agent 的按次付费数据工具（x402 + MCP）

一个 MCP 服务和 x402 卖家，提供 Agent 可调用的链上数据工具，并支持在 Base 上以 USDC 按请求付费。无需注册、无需 API 密钥、无需订阅：未付款的调用会返回带有价格的 HTTP 402，付款方签署 USDC 授权后，工具即可运行。

• MCP 端点（Streamable HTTP）： https://legible-check.ezealfa.workers.dev/mcp
• OpenAPI： https://legible-check.ezealfa.workers.dev/openapi.json
• 健康检查： https://legible-check.ezealfa.workers.dev/health
• 收款钱包： 0xF3D5de46f73d9f55DFce23F4AAF3Db5505c823c5（Base）

从 MCP 客户端连接

{
  "mcpServers": {
    "legible-check": {
      "type": "streamable-http",
      "url": "https://legible-check.ezealfa.workers.dev/mcp"
    }
  }
}

服务器通过 POST /mcp 响应 JSON-RPC 2.0；当客户端发送 Accept: text/event-stream 时，也会以 text/event-stream 帧响应。

方法：initialize、tools/list、tools/call。

工具

工具	价格（USDC）	返回内容
evm_block	0.001	区块号、时间戳、基础费用、Gas 用量、交易数量
evm_gas	0.001	拆分为基础费用和优先费用的 Gas 价格
evm_balance	0.002	以 wei 和原生单位表示的原生代币余额
evm_token_balance	0.003	包含小数位数和代币符号的 ERC20 余额
evm_nonce	0.002	下一个交易 nonce
evm_tx	0.002	按哈希解码的交易
evm_tx_status	0.001	带确认数的成功／已回滚／待处理状态
evm_receipt	0.002	收据：状态、区块、Gas 用量、实际 Gas 价格
evm_transfers	0.003	某地址在 N 个区块内的 ERC20 转账
evm_token_info	0.002	名称、符号、小数位数、总供应量
evm_contract	0.003	是否为合约的检查、字节码大小、Sourcify ABI
evm_portfolio	0.005	一次调用获取原生代币余额、nonce 和最多 10 个代币余额
evm_decode	0.003	calldata 解码器：选择器、函数签名、解码后的参数
crypto_price	0.001	实时价格、24 小时涨跌幅和市值
dex_quote	0.002	含流动性和 24 小时交易量的 DEX 交易对报价
arena_commit_reveal_roll	0.010	加密承诺-揭示随机性基准测试，验证 SHA-256 确定性 PRNG
security_ai_vault_ctf	0.050	AI 红队安全挑战（CTF／漏洞赏金）：对抗性提示词注入测试

支持的链：base、polygon、arbitrum（HTTP 请求中传入 ?chain=，或在工具参数中传入 chain）。

付款方式

1. 不带付款信息调用工具。服务器会返回 402，其中包含 accepts[]：payTo、amount （以 USDC 最小单位计，6 位小数）、asset、network（eip155:8453）。
2. 为该金额签署 EIP-3009 TransferWithAuthorization。
3. 使用包含 base64 载荷的 PAYMENT-SIGNATURE 标头重试相同请求： { x402Version: 2, accepted: <requirement>, payload: { type: "eip3009", signature, authorization } }。
4. 服务器通过 CDP facilitator 验证并结算，然后返回数据以及包含结算交易的 PAYMENT-RESPONSE 标头。

HTTP 请求中的参数名称为查询参数（?address=、?token=、?hash=、?chain=）。 不支持的链会在请求付款前被 400 拒绝。

为什么要构建此服务

Agent 经济按调用付费，但大多数端点都是没有架构说明的封装接口。 此服务发布机器可读的契约：带有 x-payment-info 的 OpenAPI、包含输入架构的 MCP 工具列表，以及始终注明链和读取数据所在区块的响应。

研究与安全合规

此服务提供的所有工具、基准测试和挑战都严格用于自主 AI Agent 研究、加密协议评估和网络安全红队测试：

• arena_commit_reveal_roll 展示了确定性的 SHA-256 伪随机提交-揭示验证。
• security_ai_vault_ctf 采用开放的漏洞研究模式（夺旗赛 / 漏洞赏金）。费用代表推理计算成本，奖池则作为对齐赏金。 此服务不从事未经许可的赌博、下注或托管金融服务。

许可证

MIT