bloxberg-mcp

An MCP (Model Context Protocol) server for the bloxberg blockchain — the permissioned Ethereum-based network operated by 50+ research institutions worldwide.

Connect any MCP-capable AI assistant (Claude Code, Claude Desktop, Cursor, …) to bloxberg: query chain state, explore transactions and contracts, and verify Research Object Certificates (W3C Verifiable Credentials anchored on-chain) — the first MCP server with native support for bloxberg's scientific-data certification stack.

Tools

Related MCP server: THORChain MCP Server

Networks

Setup

Requires Node.js ≥ 20.

git clone https://github.com/adi-ghag/bloxberg-mcp.git
cd bloxberg-mcp
npm install && npm run build

Claude Code:

claude mcp add bloxberg -- node /path/to/bloxberg-mcp/dist/index.js

Claude Desktop / generic MCP client (mcpServers config):

{
  "mcpServers": {
    "bloxberg": {
      "command": "node",
      "args": ["/path/to/bloxberg-mcp/dist/index.js"]
    }
  }
}

Then ask your assistant things like:

• "What's the latest block on bloxberg?"

• "Read name() from contract 0x787B…4C41 on the bloxberg L2 testnet"

• "Here's my research certificate JSON — verify it against the chain."

Example: verifying a Research Object Certificate

bloxberg anchors only the Merkle root of a certificate batch on-chain — an individual file hash is never on-chain by itself, so verification requires the full credential document. verify_certificate accepts the credential JSON (inline or by URL) and replays the whole pipeline: format validation → MerkleProof2019 proof replay → on-chain root comparison → issuer identity → status. The result lists every step with its pass/fail status.

Development

npm test           # unit tests (mocked network)
npm run test:live  # + integration tests against real bloxberg endpoints
npx tsx scripts/smoke.mts   # manual end-to-end smoke test

Limitations (v1)

• Read-only by design: no transaction signing or sending — the server never touches keys.

• verify_certificate supports credentials anchored on bloxberg L1 (what the published verifier engine knows). Verification of L2-testnet-anchored credentials is experimental and may fail chain lookup.

• Explorer tools use the Blockscout v1 API (the v2 REST API is disabled on bloxberg's Blockscout instances).

License

MIT © Aditya Ghag