Byte Protocol MCP Server

An MCP (Model Context Protocol) server that gives AI agents direct access to the Byte Protocol data marketplace on Arbitrum Sepolia.

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants (like Claude) use external tools. This server exposes Byte Protocol's on-chain operations as MCP tools, so an AI agent can discover data publishers, check reputation scores, subscribe to feeds, and publish data -- all through natural language.

Tools

This server exposes 10 tools across read and write operations:

Read-only (no wallet required)

Write (require PRIVATE_KEY)

Installation

git clone https://github.com/byte-protocol/mcp-server.git
cd mcp-server
npm install
npm run build

Configuration

Claude Desktop

Add this to your Claude Desktop config (~/.config/claude/claude_desktop_config.json on Linux, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "byte-protocol": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "RPC_URL": "https://sepolia-rollup.arbitrum.io/rpc",
        "INDEXER_URL": "http://localhost:8080"
      }
    }
  }
}

To enable write operations (subscribe, publish, faucet), add your private key:

{
  "mcpServers": {
    "byte-protocol": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "RPC_URL": "https://sepolia-rollup.arbitrum.io/rpc",
        "INDEXER_URL": "http://localhost:8080"
      }
    }
  }
}

Claude Code

claude mcp add byte-protocol node /path/to/mcp-server/dist/index.js

Environment Variables

Usage

Once connected, your AI agent can do things like:

"Search for weather data publishers with a PQS score above 5000"

"What are the network stats for Byte Protocol?"

"Check the balance of 0xABC...123 on the testnet"

"Subscribe me to publisher 0xDEF...456"

"Register as a publisher for the topic eth-price with a 50 PPB stake"

"Get me some testnet tokens from the faucet"

Development

npm run dev    # Watch mode -- recompiles on changes
npm run build  # One-time build
npm start      # Run the server

Network

This server connects to Arbitrum Sepolia (chain ID 421614) by default. All contract addresses are for the testnet deployment.

License

MIT -- see LICENSE.

Links

• Byte Protocol
• [Model Context Protocol](https://modelcontext

... View full README on GitHub