PayPerByte MCP Server

AI 에이전트에게 PayPerByte 데이터 피드에 대한 직접 액세스를 제공하는 Model Context Protocol 서버입니다. 암호학적으로 증명되고 출처 검증이 가능한 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 메인넷에서 실제 USDC $0.10, Merchant Screen Oracle의 서명된 ALLOW/WARN/BLOCK 판정과 증명 영수증 포함

• 저렴하게 먼저 시도: "날씨 가져오기" / "오늘 M4 이상 지진 있나요?" → 실제 USDC $0.005 / $0.003, 모든 응답에 동일한 증명 영수증 포함 — 판정에 비용을 지출하기 전에 검증-후-조치가 작동하는 것을 확인하는 가장 저렴한 방법

• 스트림 구독(테스트넷): "지진 피드 구독" → Arbitrum Sepolia에서 지속 결제를 위한 MockUSDC 자동 승인

• 팩트 오라클 조회(테스트넷): 등록된 팩트 오라클 게시자에게 서명된 EIP-712 질문을 게시하여 인용문이 포함된 온체인 서명 답변 수신 — 팩트 오라클 게시자가 활성화된 경우(현재 방송 중인 게시자가 없음; 게시자가 등록하고 방송할 때까지 도구는 시간 초과됨)

실시간 카탈로그는 x402.payperbyte.io/feeds 에 있습니다 — 날씨, 시장, 코드, 보안, 지식 분야의 암호학적으로 증명되고 출처 검증이 가능한 피드입니다.

Related MCP server: CorteX402

조치 전 검증(ForeSeal)

설치, 가입, 지갑 없이 하나의 명령으로 전체 검증-후-조치 루프를 확인하세요:

npx @foreseal/demo

로컬에서 실행되며(실제 USDC 없음) 에이전트가 진짜 바이트에 대해 ACT하고 네 가지 공격(변조된 바이트, 위조된 서명, 누락된 영수증, 포크된 서명 도메인)에 대해 REFUSE하는 것을 약 1초 만에 보여줍니다.

동일한 프리미티브가 자체 스택에 통합할 수 있는 두 개의 패키지로 제공됩니다:

• 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 필요)

온디맨드 구매(requires 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

환경 변수

네트워크

두 가지 레일을 명확히 설명합니다:

• 결제 레일(byte_buy_data): Base 메인넷(eip155:8453). 유료 피드는 x402.payperbyte.io 게이트웨이를 통해 실제 USDC로 결제됩니다. 유료 200회마다 정확한 응답 바이트에 대한 EIP-712 영수증 X-BYTE-Attestation이 반환됩니다.

• 온체인 레이어(구독, 브로드캐스트, 사실-오라클 에스크로, 인덱서): Arbitrum Sepolia(체인 421614). PayPerByte 라이브러리 계약의 메인넷 배포는 외부 보안 감사 조건부로 진행됩니다. 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 스펙

• TypeScript SDK — MCP TypeScript SDK