PayPerByte MCP 服务器

一个 Model Context Protocol 服务器，为 AI 代理提供对 PayPerByte 的直接访问——面向 AI 代理的加密证明、来源可验证的数据源（X-BYTE-Attestation 收据证明交付完整性——这些正是 PayPerByte 在 BYTE Library 域名下提供并证明的字节，而非独立数据发布者签署的字节，也不代表数据是正确的）。代理可以发现数据源、通过 x402 按次付费（以 Base 主网上的 USDC 结算），或订阅链上流（Arbitrum Sepolia 测试网）。每个付费的 x402 响应都携带一份 EIP-712 PayloadAttestation 收据（X-BYTE-Attestation 头），代理在采取行动前会先验证它。无需代币、无需 API 密钥、无需链下账户。

两条轨道——在设置 PRIVATE_KEY 之前请先阅读。

• x402 按次付费（byte_buy_data）：Base 主网（eip155:8453），真实 USDC。 付费数据源以真实资金结算——旗舰产品 Merchant Screen Oracle 每次判定收费 $0.10：对商户域名和支付地址进行签名的 ALLOW/WARN/BLOCK 检查，由对确切响应字节的签名 EIP-712 证明背书，在代理向其结算 x402 付款之前运行。它保证的是真实性和交付完整性，而非判定本身的正确性——并且是针对你提供的域名、地址和价格；它不会观察或约束你最终结算到的地址。请使用一个只持有你计划花费金额的专用钱包。

• 链上订阅/发布/查询层（BYTE Library 合约 + 索引器）：Arbitrum Sepolia 测试网（链 421614），MockUSDC。 该层的主网版本需等待外部安全审计通过。无论你在哪条轨道上付费，EIP-712 证明签名域都锚定在 421614。

一个 PRIVATE_KEY 即可服务两条轨道。切勿重复使用持有你无法承受损失资金的密钥。

快速开始

npx -y byte-mcp-server

将其接入你的 MCP 客户端（配置见下方 Claude Desktop），然后你的代理就可以：

• 发现数据源："列出 PayPerByte 目录" / "搜索天气相关的发布者"

• 在付款前对交易对手进行筛查（x402，无需设置）："在我结算之前筛查这个域名和支付地址" → Base 主网上 $0.10 真实 USDC，来自 Merchant Screen Oracle 的签名 ALLOW/WARN/BLOCK 判定，附带证明收据

• 先低成本试用："获取天气" / "今天有 M4 以上的地震吗？" → $0.005 / $0.003 真实 USDC，每个响应都附带相同的证明收据——这是在花费资金获取判定之前，体验"先验证再行动"最便宜的方式

• 订阅流（测试网）："帮我订阅地震数据源" → 自动批准 MockUSDC 用于 Arbitrum Sepolia 上的持续结算

• 查询事实预言机（测试网）：向已注册的事实预言机发布者提交签名的 EIP-712 问题，获取带引用的链上签名答案——当事实预言机发布者上线时（目前没有发布者在广播；该工具会超时，直到有发布者注册并广播）

实时目录位于 x402.payperbyte.io/feeds——涵盖天气、市场、代码、安全和知识领域的加密证明、来源可验证的数据源。

Related MCP server: CorteX402

行动前验证（ForeSeal）

用一条命令查看完整的"先验证再行动"循环——无需安装、无需注册、无需钱包：

npx @foreseal/demo

它在本地运行（不涉及真实 USDC），并在约一秒钟内展示代理对真实字节执行 ACT 以及对四种攻击执行 REFUSE——被篡改的字节、伪造的签名、缺失的收据、分叉的签名域。

同样的原语以两个包的形式提供，你可以直接集成到自己的技术栈中：

• Kit — @payperbyte/sdk：买方在行动前验证收据。

• Gate — @foreseal/gate：卖方在任何 x402 端点上加盖可验证的收据。

两种范式：订阅 vs. 购买

购买是零设置、按需付费，且已上线真实结算；订阅则在等待审计的测试网层上投递每次广播。根据访问模式选择。

购买判定（POST 预言机）

GET 数据源只需要一个 feed。任何 method 包含 POST 的数据源（实时列表：https://x402.payperbyte.io/feeds）都将查询作为 body 接收——byte_buy_data 会自动将调用从 GET 切换为 POST。判定预言机——返回签名 ALLOW/WARN/BLOCK 的数据源——包括 merchant-screen、address-reputation、sanctions-screen、pkg-verdict、reasoning-verdict：

// byte_buy_data tool call — screen a merchant/counterparty before settling
{
  "feed": "merchant-screen",
  "body": { "domain": "example.com", "address": "0x1234…abcd", "observed_price_atomic": "100000" }
}

付费响应返回签名判定以及对 X-BYTE-Attestation 收据的内联"先验证再行动"结果：

{
  "feed": "merchant-screen",
  "paid": true,
  "price": "$0.100000",
  "txHash": "0x…",
  "data": { "answer": { "verdict": "ALLOW", "reasons": ["…"] }, "attestation": { "…": "…" } },
  "verification": { "verified": true, "hashMatch": true, "signerMatch": true,
                    "reason": "receipt verified — bytes intact AND signed by the pinned gateway attester (safe to act)" }
}

仅在 verification.verified === true 时采取行动——收据证明来源和完整性，而非正确性。其他 POST 请求体：address-reputation {domain,address}、sanctions-screen {address|name}、pkg-verdict {ecosystem,package[,version]}、reasoning-verdict {subject}。对于 GET 数据源（天气、地震等），完全省略 body。

工具（共 15 个）

发现（只读，无需钱包）

订阅流（需要 PRIVATE_KEY）

按需购买（需要 PRIVATE_KEY）

配置

Claude Desktop

编辑 ~/.config/claude/claude_desktop_config.json（Linux）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "payperbyte": {
      "command": "npx",
      "args": ["-y", "byte-mcp-server"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "RPC_URL": "https://sepolia-rollup.arbitrum.io/rpc",
        "INDEXER_URL": "http://localhost:8080"
      }
    }
  }
}

PRIVATE_KEY 是可选的——只读工具无需它即可工作。添加它可以启用订阅、发布、购买和查询。

Claude Code

claude mcp add payperbyte -- npx -y byte-mcp-server

环境变量

网络

两条轨道，如实说明：

• x402 支付轨道（byte_buy_data）：Base 主网（eip155:8453）。 付费数据源通过 x402.payperbyte.io 的网关结算真实 USDC；每次付费请求的 200 响应都会返回一个针对确切响应字节的 X-BYTE-Attestation EIP-712 收据。

• 链上层（订阅、广播、事实预言机托管、索引器）：Arbitrum Sepolia（链 421614）。 BYTE Library 合约的主网部署受外部安全审计限制。EIP-712 PayloadAttestation 签名域固定在 421614 上，与支付轨道无关。

合约地址固定在随附配置中；npm 发布版附带开箱即用的默认值。没有代币。

开发

git clone https://github.com/0rkz/byte-mcp-server.git
cd byte-mcp-server
npm install
npm run build && npm start

许可证

MIT——请参阅 LICENSE。

入门套件

可选付费套件（39 美元）：买家端代理套件——一个购买并验证数据源的代理，附带即用型 Claude Desktop / Claude Code / Cursor 配置，并包含一次免费的 30 分钟就绪咨询。npm 包保持免费 MIT 许可——该套件出售的是组装好的配置。

链接

• payperbyte.io — PayPerByte 首页

• x402.payperbyte.io/feeds — 实时数据源目录

• Model Context Protocol — MCP 规范

• MCP TypeScript SDK