Byte MCP Server

by 0rkzio.github.0rkz/byte-protocolv0.13.0

Per-byte data marketplace on Arbitrum (PayPerByte): discover publishers, check on-chain quality scores, subscribe and pay per request in USDC via x402.

1Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active26d ago

Install Byte MCP server

claude mcp add byte -e PRIVATE_KEY='<private-key>' -- npx -y byte-mcp-server

{
  "mcpServers": {
    "byte": {
      "command": "npx",
      "args": [
        "-y",
        "byte-mcp-server"
      ],
      "env": {
        "PRIVATE_KEY": "<private-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "byte": {
      "command": "npx",
      "args": [
        "-y",
        "byte-mcp-server"
      ],
      "env": {
        "PRIVATE_KEY": "<private-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "byte": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "byte-mcp-server"
      ],
      "env": {
        "PRIVATE_KEY": "<private-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "byte": {
      "command": "npx",
      "args": [
        "-y",
        "byte-mcp-server"
      ],
      "env": {
        "PRIVATE_KEY": "<private-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PRIVATE_KEY	—	yes	Ethereum private key for write/buy tools (subscribe, unsubscribe, publish, buy_data). buy_data spends real Base-mainnet USDC — use a dedicated wallet. Not required for read-only tools.
RPC_URL	—	—	RPC for the on-chain library + EIP-712 attestation layer (Arbitrum Sepolia, eip155:421614). The x402 buy rail settles USDC on Base mainnet and needs no RPC here. Defaults to Arbitrum Sepolia public RPC.
BYTE_GATEWAY_ATTESTER	—	—	Gateway attester address byte_buy_data pins receipts against. Defaults to the current PayPerByte gateway attester (rotated 2026-08-19; previous default 0x77c86a...C472 is retired). Override only if the gateway discloses a rotation you need ahead of a package update - see /.well-known/agent.json receipt.attester and receipt.retiredAttesters.

Remote endpoints

streamable-httphttps://mcp.payperbyte.io/mcp

Freshness

Active — last maintenance signal 26d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-13 · 26d ago · GitHub
Latest release
2026-06-04 · 4mo ago · GitHub · v0.11.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-13 · 27d ago · official registry · v0.13.0

FAQ

›How do I install the Byte MCP server in Claude Code?

Run: claude mcp add byte -e PRIVATE_KEY='<private-key>' -- npx -y byte-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Byte require an API key?

Yes. It expects PRIVATE_KEY, of which 1 is a secret.

›Can I use Byte as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Byte in the official MCP registry?

Yes, as io.github.0rkz/byte-protocol.