0rkz/byte-mcp-server

Smithery listing ·
A Model Context Protocol server that gives AI agents direct access to **PayPerByte** — cryptographically attested, provenance-verifiable data feeds for AI agents (the X-BYTE-Attestation receipt proves delivery-integrity — these are exactly the bytes PayPerByte served and attested under the BYTE Library domain — not that an independent data publisher signed them, and not that the data is correct). Agents discover feeds, pay-per-call via x402 (settled in **USDC on Base mainnet**), or subscribe to on-chain streams (Arbitrum Sepolia testnet). Every paid x402 response carries an EIP-712 PayloadAttestation receipt (X-BYTE-Attestation header) the agent verifies before acting. No tokens, no API keys, no off-chain accounts.
> **Two rails — read this before setting PRIVATE_KEY.**
>
> - **x402 pay-per-call (byte_buy_data): Base mainnet (eip155:8453), REAL USDC.** Paid feeds settle real money — every price is quoted in the 402 challenge and listed per feed at https://x402.payperbyte.io/feeds. Example: the Merchant Screen Oracle returns a signed ALLOW/WARN/BLOCK check on a merchant's domain and payout address, backed by a signed EIP-712 attestation over the exact response bytes, run before an agent settles an x402 payment to it. Authenticity and delivery-integrity, not a correctness guarantee on the verdict itself — and on the domain, address and price you supply; it does not observe or constrain the address you ultimately settle to. Use a dedicated wallet holding only what you intend to spend.
> - **On-chain subscribe/publish/query layer (BYTE Library contracts + indexer): Arbitrum Sepolia testnet (chain 421614), MockUSDC.** Mainnet for this layer is gated on an external security audit. The EIP-712 attestation signing domain stays anchored at 421614 regardless of which rail you paid on.
>
> One PRIVATE_KEY serves both rails. Never reuse a key holding funds you can't afford to spend.
Quick start
Wire it into your MCP client (Claude Desktop config below), then your agent can:
- **Discover** feeds: *"List the PayPerByte catalog"* / *"Search publishers for weather"*
- **Screen a counterparty before you pay it** (x402, no setup): *"Screen this domain and payout address before I settle"* → real USDC on Base mainnet at the price the 402 challenge quotes, signed ALLOW/WARN/BLOCK verdict from the Merchant Screen Oracle with an attestation receipt
- **Try it cheap first**: *"Get the weather"* / *"Any earthquakes over M4 today?"* → real USDC at each feed's listed price (https://x402.payperbyte.io/feeds), same attestation receipt on every response — a low-cost way to see verify-before-act work before spending on a verdict
- **Subscribe** to a stream (testnet): *"Subscribe me to the earthquakes feed"* → auto-approves MockUSDC for ongoing settlement on Arbitrum Sepolia
- **Query a fact-oracle** (testnet): post a signed EIP-712 question to a registered fact-oracle publisher for an on-chain signed answer with citations — *when a fact-oracle publisher is live (none is broadcasting today; the tool times out until one registers and broadcasts)*
The live catalog is at **x402.payperbyte.io/feeds** — cryptographically attested, provenance-verifiable feeds across weather, markets, code, security, and knowledge.
Verify before acting (ForeSeal)
See the whole verify-before-act loop in one command — no install, no signup, no wallet:
It runs locally (no real USDC) and shows an agent **ACT** on genuine bytes and **REFUSE** four attacks — a tampered byte, a forged signature, a missing receipt, a forked signing domain — in about a second.
The same primitive ships as two packages you can drop into your own stack:
- **Kit** — @payperbyte/sdk: the buyer verifies a receipt before acting.
- **Gate** — @foreseal/gate: a seller stamps a verifiable receipt on any x402 endpoint.