# PayPerByte

> PayPerByte is a verified, provenance-first data layer for AI agents. Agents discover and pay-per-call (or subscribe) for first-party data feeds and oracles — address-reputation, sanctions screening, package and reasoning verdicts, exchange positioning + liquidation streams, threat-intel, runtime end-of-life, weather, earthquakes, and a cited evidence-pack oracle. Pay-per-call is keyless x402 USDC settled on Base mainnet (a wallet signs an EIP-3009 `transferWithAuthorization`; no API key, no signup, no token). Every paid response carries a signed EIP-712 `PayloadAttestation` (returned in the `X-BYTE-Attestation` receipt header) so an agent can verify the exact bytes and the signer before acting on them — verify-before-act.

## Status

> Pay-per-call settles in USDC on Base mainnet (`eip155:8453`); the x402 gateway at x402.payperbyte.io is live and an unpaid request returns HTTP 402. The EIP-712 `PayloadAttestation` signing domain (literal name `BYTE Library`) is anchored on Arbitrum (chainId `421614`) regardless of the settlement rail — a fixed signing namespace, with a mainnet attestation anchor pending an external security audit. No token. No external-user, revenue, or traction claims are made here — the loop is dogfooded; external adoption is the open question, stated honestly.

## Start here

- [Address Reputation Oracle (flagship)](https://x402.payperbyte.io/feeds/address-reputation): `POST` a `(domain, address, amount, chain)` and get a signed ALLOW/WARN/BLOCK go/no-go verdict before releasing USDC — $0.10/verdict, x402 on Base mainnet. Unpaid requests return the full HTTP 402 challenge.
- [Quickstart](https://www.payperbyte.io/docs/quickstart): Two paths to first byte in five minutes — MCP-in-Claude, or raw x402 HTTP. No API key, no signup.
- [llms-full.txt](https://www.payperbyte.io/llms-full.txt): The full plain-text brief for agents — capabilities, the verify-before-act wedge, the complete feed catalog, the buy/subscribe/verify flow, and integrity framing.
- [How it works](https://www.payperbyte.io/how-it-works): The per-call pricing model, EIP-712 attestation, and the subscribe-vs-buy decision.

## For AI agents (MCP)

- [byte-mcp-server on npm](https://www.npmjs.com/package/byte-mcp-server): `npx byte-mcp-server` — 15 MCP tools (machine id `io.github.0rkz/byte-protocol`). Read-only discovery tools need no wallet.
- [Hosted MCP endpoint](https://mcp.payperbyte.io/mcp): Streamable-HTTP MCP server for remote agents.
- [SKILL.md](https://www.payperbyte.io/SKILL.md): Claude Agent Skill capability file — when to reach for PayPerByte and how to run the verify-before-act + buy/subscribe flow.

## For agents (x402 HTTP)

- [x402 gateway feed catalog](https://x402.payperbyte.io/feeds): Live catalog with per-feed price, expected payload size, provenance, and disclaimer category. Free, ungated.
- [OpenAPI 3.1 contract](https://x402.payperbyte.io/openapi.json): The canonical machine-readable contract. Every paid operation declares its x402 payment scheme, input/output schemas, and price.
- [x402 resource manifest](https://x402.payperbyte.io/.well-known/x402.json): x402 discovery manifest — all payable resources with per-feed price + accepts + provenance, settled on Base mainnet (`eip155:8453`). Alias: `/x402-manifest`.
- [Agent card (A2A)](https://x402.payperbyte.io/.well-known/agent.json): Agent-discovery card listing every feed as a callable skill, the x402 payment surface, and the `X-BYTE-Attestation` receipt block.

## Discovery & marketplace

- [Discovery API](https://api.payperbyte.io/discover): Publisher catalog with on-chain quality signals and pricing.

## Docs

- [Getting Started](https://www.payperbyte.io/docs/quickstart): Install the SDK or MCP server, subscribe or buy, and verify a payload.
- [Pricing](https://www.payperbyte.io/pricing): Per call, no account — flat $0.10 for the verdict oracles (address-reputation, sanctions-screen, pkg-verdict, reasoning-verdict, evidence-pack), $0.03 for the market snapshots, and per-byte metering for the breadth feeds ($0.005/KB, $0.001 floor; cheapest live feed today $0.003/call). Per-feed prices are fixed in the manifest.
- [Network](https://www.payperbyte.io/network): Live protocol state and the publisher roster.

## Source

- [byte-mcp-server (GitHub)](https://github.com/0rkz/byte-mcp-server): The MCP server source.