SuperAPI AI 工具集

byte-mcp-server

PayPerByte MCP Server 是一个模型上下文协议(MCP)服务器,让 AI 智能体直接接入 PayPerByte 数据市场。它提供经过密码学证明、可验证来源的数据源:智能体可发现数据源,通过 x402 按次付费(在 Base 主网以 USDC 结算),或订阅链上数据流(Arbitrum Sepolia 测试网)。每次付费的 x402 响应都附带 EIP-712 PayloadAttestation 收据,智能体在执行操作前先验证。该服务无需 API 密钥、无代币、无链下账户。

访问官网

工具介绍

PayPerByte MCP Server 是一个遵循模型上下文协议(MCP)的服务器,为 AI 智能体提供对 PayPerByte 数据市场的直接访问。这些数据源经过密码学证明且来源可验证;其中 X-BYTE-Attestation 收据用于证明交付完整性——即这些字节确实由 PayPerByte 在 BYTE Library 域下提供并证明,但不代表独立数据发布方对其签名,也不代表数据本身正确。

主要能力

  • 发现数据源:列出 PayPerByte 目录,或按主题搜索发布方(如天气)。
  • 交易对手筛查:在结算前对某个域名和收款地址进行筛查,返回由 Merchant Screen Oracle 签名的 ALLOW/WARN/BLOCK 判定,并附带 EIP-712 证明收据。该判定不构成对判定本身正确性的保证,也不观察或约束你最终结算的地址。
  • 低成本的先验测试:获取天气、查询今日 4 级以上地震等数据,按每个数据源标价支付真实 USDC,每次响应均带证明收据,便于在花费较高费用前体验“先验证后行动”。
  • 订阅数据流(测试网):如订阅地震数据源,自动批准 MockUSDC 以在 Arbitrum Sepolia 上持续结算。
  • 查询事实预言机(测试网):向已注册的事实预言机发布方提交签名的 EIP-712 问题,获取带引用的链上签名答案;目前尚无发布方在广播,该工具会超时直到有发布方注册并广播。

两条支付轨道

  1. x402 按次付费(byte_buy_data):Base 主网(eip155:8453),使用真实 USDC。付费数据源结算真实资金,每个价格在 402 挑战中报价,并按数据源列在 https://x402.payperbyte.io/feeds。示例:Merchant Screen Oracle 返回对商户域名和收款地址的签名 ALLOW/WARN/BLOCK 检查,由对精确响应字节的签名 EIP-712 证明支撑,在智能体向其结算 x402 付款前运行。验证的是真实性和交付完整性,而非判定本身的正确性保证,也不观察或约束你最终结算到的地址。请使用仅存放你计划花费金额的专用钱包。
  2. 链上订阅/发布/查询层(BYTE Library 合约 + 索引器):Arbitrum Sepolia 测试网(chain 421614),使用 MockUSDC。该层的主网受外部安全审计限制(暂未提供审计完成时间)。无论通过哪条轨道支付,EIP-712 证明签名域始终锚定在 421614。

一个 PRIVATE_KEY 同时服务两条轨道。切勿重复使用存有你无法承受损失的资金的钱包密钥。

接入方式

将服务器接入 MCP 客户端(如 Claude Desktop),配置示例如下(Linux 路径 ~/.config/claude/claude_desktop_config.json,macOS 路径 ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "payperbyte": {
      "command": "npx",
      "args": ["-y", "byte-mcp-server"],
      "env": {
        "PRIVATE_KEY": "<your_private_key>"
      }
    }
  }
}

PRIVATE_KEY 为可选:只读工具无需它即可使用。添加它才能启用订阅、发布、购买和查询功能。环境变量详见仓库说明。

购买判定(POST oracle)

GET 数据源只需提供 feed。任何方法包含 POST 的数据源(实时列表见 https://x402.payperbyte.io/feeds)将查询作为请求体接收,byte_buy_data 会自动将调用从 GET 切换为 POST。返回签名判定的判定预言机数据源包括:merchant-screen、address-reputation、sanctions-screen、pkg-verdict、reasoning-verdict。

付费响应返回签名判定,以及对 X-BYTE-Attestation 收据的内联先验证后行动结果。仅当 verification.gatewayVerified === true 时才行动——收据证明网关交付了这些精确字节,而非数据正确。

其他 POST 请求体格式:

  • address-reputation:{domain,address}
  • sanctions-screen:{address|name}
  • pkg-verdict:{ecosystem,package[,version]}
  • reasoning-verdict:{subject}

GET 数据源(天气、地震等)可完全省略请求体。

工具

共 15 个工具,分为:发现类(只读,无需钱包)、订阅数据流(需 PRIVATE_KEY)、按需购买(需 PRIVATE_KEY)。

先验证后行动(ForeSeal)

可通过一条命令查看完整的先验证后行动循环,无需安装、注册或钱包(本地运行,不涉及真实 USDC):展示智能体对真实字节采取行动,并拒绝四种攻击——篡改字节、伪造签名、缺失收据、分叉签名域。

同一原语以两个包提供,可放入你自己的技术栈:

  • Kit — @payperbyte/sdk:买方在行动前验证收据。
  • Gate — @foreseal/gate:卖方在任何 x402 端点上盖章可验证收据。

订阅与购买两种模式

购买:零配置、按需付费,已在真实结算下上线。订阅:在受审计限制的测试网层上交付每次广播。根据访问模式选择。

费用与许可

核心 npm 包为免费 MIT 许可(见 LICENSE)。另提供可选付费套件($39):买方侧智能体套件——一个购买并验证数据源的智能体,附带可放入 Claude Desktop / Claude Code / Cursor 的配置,以及一次免费 30 分钟准备度通话。npm 包始终免费 MIT;套件出售的是组装好的配置。

其他信息

  • 无代币。
  • 合约地址固定在捆绑配置中;npm 发布版附带可直接使用的默认值。
  • 链接:payperbyte.io(PayPerByte 主页)、x402.payperbyte.io/feeds(实时数据源目录)、模型上下文协议规范、MCP TypeScript SDK、gold-402(实时 x402 服务目录,PayPerByte 已收录)。

限制与说明

  • 证明的是交付完整性和真实性,不保证数据正确性。
  • x402 轨道使用 Base 主网真实 USDC,涉及真实资金,需谨慎。
  • 链上订阅层目前仅在 Arbitrum Sepolia 测试网,主网受外部安全审计限制(审计状态暂未提供)。
  • 事实预言机当前无发布方广播,该工具会超时。