Servidor MCP PayPerByte

Un servidor de Protocolo de Contexto de Modelo que brinda a los agentes de IA acceso directo a PayPerByte — fuentes de datos con atestación criptográfica y procedencia verificable para agentes de IA (el recibo X-BYTE-Attestation demuestra la integridad de la entrega — estos son exactamente los bytes que PayPerByte sirvió y atestiguó bajo el dominio de la Biblioteca BYTE — no que un publicador de datos independiente los haya firmado, ni que los datos sean correctos). Los agentes descubren fuentes, pagan por llamada mediante x402 (liquidado en USDC en la red principal de Base), o se suscriben a flujos en cadena (red de pruebas de Arbitrum Sepolia). Cada respuesta x402 de pago incluye un recibo de PayloadAttestation EIP-712 (cabecera X-BYTE-Attestation) que el agente verifica antes de actuar. Sin tokens, sin claves de API, sin cuentas fuera de la cadena.

Dos vías: lea esto antes de configurar PRIVATE_KEY.

• Pago por llamada x402 (byte_buy_data): red principal de Base (eip155:8453), USDC REAL. Las fuentes de pago liquidan dinero real — el Oráculo de Pantalla de Comerciante insignia cuesta 0,10 $ por veredicto: una comprobación firmada PERMITIR/ADVERTIR/BLOQUEAR sobre el dominio y la dirección de pago de un comerciante, respaldada por una atestación EIP-712 firmada sobre los bytes exactos de la respuesta, que se ejecuta antes de que un agente liquide un pago x402 hacia ella. Autenticidad e integridad de la entrega, no una garantía de corrección sobre el veredicto en sí — y sobre el dominio, la dirección y el precio que usted proporcione; no observa ni restringe la dirección a la que finalmente liquide. Utilice una billetera dedicada que contenga únicamente lo que pretenda gastar.

• Capa de suscripción/publicación/consulta en cadena (contratos de la Biblioteca BYTE + indexador): red de pruebas de Arbitrum Sepolia (cadena 421614), MockUSDC. La red principal de esta capa está supeditada a una auditoría de seguridad externa. El dominio de firma de la atestación EIP-712 permanece anclado en 421614 independientemente de la vía por la que haya pagado.

Una sola PRIVATE_KEY sirve a ambas vías. No reutilice una clave que contenga fondos que no pueda permitirse gastar.

Inicio rápido

npx -y byte-mcp-server

Conéctelo a su cliente MCP (configuración de Claude Desktop más abajo) y su agente podrá:

• Descubrir fuentes: "Enumera el catálogo de PayPerByte" / "Busca publicadores de clima"

• Examinar a una contraparte antes de pagarle (x402, sin configuración): "Examina este dominio y dirección de pago antes de liquidar" → 0,10 $ en USDC real en la red principal de Base, veredicto firmado PERMITIR/ADVERTIR/BLOQUEAR del Oráculo de Pantalla de Comerciante con un recibo de atestación

• Probar primero a bajo costo: "Obtén el clima" / "¿Algún terremoto superior a M4 hoy?" → 0,005 $ / 0,003 $ en USDC real, el mismo recibo de atestación en cada respuesta — la forma más económica de ver el flujo de verificar-antes-de-actuar antes de gastar en un veredicto

• Suscribirse a un flujo (red de pruebas): "Suscríbeme a la fuente de terremotos" → aprueba automáticamente MockUSDC para la liquidación continua en Arbitrum Sepolia

• Consultar un oráculo de hechos (red de pruebas): publique una pregunta EIP-712 firmada a un publicador de oráculo de hechos registrado para obtener una respuesta firmada en cadena con citas — cuando un publicador de oráculo de hechos esté activo (ninguno transmite hoy; la herramienta agota el tiempo de espera hasta que uno se registre y transmita)

El catálogo en vivo está en x402.payperbyte.io/feeds — fuentes con atestación criptográfica y procedencia verificable en clima, mercados, código, seguridad y conocimiento.

Related MCP server: CorteX402

Verificar antes de actuar (ForeSeal)

Vea el ciclo completo de verificar-antes-de-actuar en un solo comando — sin instalación, sin registro, sin billetera:

npx @foreseal/demo

Se ejecuta localmente (sin USDC real) y muestra a un agente ACTUAR sobre bytes genuinos y RECHAZAR cuatro ataques — un byte manipulado, una firma falsificada, un recibo faltante, un dominio de firma bifurcado — en aproximadamente un segundo.

La misma primitiva se distribuye como dos paquetes que puede integrar en su propia pila:

• Kit — @payperbyte/sdk: el comprador verifica un recibo antes de actuar.

• Gate — @foreseal/gate: un vendedor sella un recibo verificable en cualquier endpoint x402.

Dos paradigmas: suscribirse vs. comprar

Comprar no requiere configuración, es de pago por uso y está activo con liquidación real; suscribirse entrega cada transmisión en la capa de red de pruebas sujeta a auditoría. Elija según el patrón de acceso.

Comprar un veredicto (oráculo POST)

Las fuentes de datos GET solo necesitan una feed. Cualquier fuente cuyo method incluya POST (lista en vivo: https://x402.payperbyte.io/feeds) toma la consulta como body — byte_buy_data cambia la llamada de GET a POST automáticamente. Los oráculos de veredicto — fuentes que devuelven un PERMITIR/ADVERTIR/BLOQUEAR firmado — son 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" }
}

La respuesta de pago devuelve el veredicto firmado y un resultado de verificar-antes-de-actuar en línea sobre el recibo 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)" }
}

Actúe solo cuando verification.verified === true — el recibo demuestra procedencia e integridad, no corrección. Otros cuerpos POST: address-reputation {domain,address}, sanctions-screen {address|name}, pkg-verdict {ecosystem,package[,version]}, reasoning-verdict {subject}. Omita body por completo para fuentes de datos GET (clima, terremotos, …).

Herramientas (15 en total)

Descubrimiento (solo lectura, sin billetera)

Suscribirse a un flujo (requiere PRIVATE_KEY)

Comprar bajo demanda (requiere PRIVATE_KEY)

Configuración

Claude Desktop

Edita ~/.config/claude/claude_desktop_config.json (Linux) o ~/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 es opcional — las herramientas de solo lectura funcionan sin ella. Añádela para habilitar suscripción, publicación, compra y consulta.

Claude Code

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

Variables de entorno

Red

Dos vías, declaradas con honestidad:

• Vía de pago x402 (byte_buy_data): Base mainnet (eip155:8453). Los feeds de pago liquidan USDC real a través del gateway en x402.payperbyte.io; cada 200 pagado devuelve un recibo EIP-712 X-BYTE-Attestation sobre los bytes exactos de la respuesta.

• Capa on-chain (suscripciones, transmisiones, escrow de fact-oracle, indexador): Arbitrum Sepolia (chain 421614). Mainnet para los contratos de BYTE Library está condicionada a una auditoría de seguridad externa. El dominio de firma EIP-712 PayloadAttestation está anclado en 421614 independientemente de la vía de pago.

Las direcciones de los contratos están fijadas en la configuración incluida; el release npm incluye valores predeterminados listos para usar. Sin token.

Desarrollo

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

Licencia

MIT — consulta LICENSE.

Kit de inicio

Kit de pago opcional ($39): el kit de agente del lado comprador — un agente que compra y verifica feeds, con configuración lista para usar de Claude Desktop / Claude Code / Cursor y una llamada de preparación gratuita de 30 minutos incluida. Los paquetes npm son y siguen siendo MIT gratuitos — el kit vende la configuración ensamblada.

Enlaces

• payperbyte.io — inicio de PayPerByte

• x402.payperbyte.io/feeds — catálogo de feeds en vivo

• Model Context Protocol — especificación MCP

• MCP TypeScript SDK