How do I install OpenChainBench?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does OpenChainBench need an API key?

No required environment variable is listed on this record.

What transport does OpenChainBench use?

OpenChainBench is reached over HTTP.

When was OpenChainBench last checked?

Last checked 2026-11-09. Live, neutral benchmarks for public RPC latency, oracles, bridges, perp DEX, and prediction markets.

OpenChainBench MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://openchainbench.com/api/mcp/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.flotapponnier-openchainbench https://openchainbench.com/api/mcp/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.flotapponnier-openchainbench": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://openchainbench.com/api/mcp/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

OpenChainBench

Open, reproducible benchmarks for crypto infrastructure. Aggregators, bridges, RPCs, oracles, price feeds, prediction markets, perp DEXes, cross-chain messaging. Same metric, same conditions, every provider. Live at openchainbench.com.

OpenChainBench publishes one benchmark at a time, each shipping with the harness that produces its data. The goal is to make performance an observable property of crypto infra, measured in the open, by anyone who wants to add a provider or a metric.

Community-run, MIT-licensed harnesses + CC-BY-4.0 data, PRs from any party including the providers we benchmark.

At a glance

94 live benchmark specs across 8 categories (RPCs, Trading, Aggregators, Bridges, Blockchains, RWA, Explorers, NFT APIs)
50 self-contained Go harnesses, each shipping a /metrics Prometheus endpoint
32 curated question/answer pages · 23 "alternatives to X" landing pages
26 machine-readable API routes (citation, badges, MCP, feeds, per-format quotes)
One shared Prometheus, one materialization worker, CDN-fastpath snapshot store: cold reads in < 100 ms edge, no origin fan-out on hot paths

Quickstart

pnpm install
pnpm dev              # site at http://localhost:3000
pnpm validate         # bench spec Zod schema check (run before opening a PR)
pnpm typecheck        # tsc --noEmit

Adding a benchmark, writing a harness, or fixing a number: see CONTRIBUTING.md + the visual walkthrough at /contribute.

Machine-readable surfaces

Every benchmark is licensed CC-BY-4.0 and exposed through endpoints designed for citation by journalists, devs, and AI agents:

Endpoint	Audience	What it returns
`/llms.txt` · `/llms-full.txt`	LLM crawlers	Plain-text index (short) + full Markdown context (long) per the llmstxt.org convention.
`/api/citable`	Devs, agents	Flat JSON: every benchmark with current value, leader, headline sentence, citation URL, OG image URL.
`/api/stat/<slug>`	Devs, agents	Single benchmark: full rankings, sparkline (24h), methodology, paste-ready quote, attribution URL.
`/api/cite/<slug>/<format>`	Zotero, Mendeley, Perplexity	Citation in `bibtex`, `apa`, `ris`, or `txt` with the correct MIME type.
`/api/openapi.json`	LangChain, custom GPTs, generic clients	OpenAPI 3.1 schema describing every endpoint.
`/api/mcp/mcp`	MCP clients (Claude Desktop, Cursor, ChatGPT tools)	MCP server: `list_benchmarks`, `get_benchmark`, `query_prom` tools + `openchainbench://benchmark/{slug}` resource.
`/api/freshness`	Live UI, dashboards	`{slug → asOf ms}` map. Edge-cached 5 s.
`/api/llm-context`	LLM system prompts	Every benchmark with rankings + methodology in one Markdown blob.

Structured data on every bench page: Dataset + StatisticalReport + Observation + TechArticle + FAQPage + BreadcrumbList JSON-LD, plus a schema.org Dataset microdata graph layered on the visible "At a glance" infobox.

Journalist citation format (what /api/stat/<slug>.headlineSentence emits):

"Mobula leads head lag at 0.8s (p50, 24h) on Fastest onchain data provider.
Source: OpenChainBench (https://openchainbench.com/benchmarks/aggregator-head-lag)"

Site surfaces

Route	What lives there
`/`	Hero + Latest benchmarks table + Live dashboard
`/benchmarks` · `/benchmarks/[slug]`	Catalog grid + per-bench leaderboard with chart, ledger, chain/region filters, share cards, FAQ
`/benchmarks/[slug]/[chain]`	Chain-scoped bench view with per-chain explainer
`/products/[slug]`	The one page per product: every bench it appears in, top-1 counts, related products, and a view per category it belongs to (Trading app, Perpetuals, Prediction markets, Data API, Bridge, RPC, Hyperliquid) selectable by pill or URL hash
`/chains/[slug]`	Per-chain hub: live native price, TVL history, every bench that touches this chain grouped by category
`/compare/[a]-vs-[b]`	Head-to-head comparison across shared benches, canonical alphabetical order enforced at the edge
`/alternatives/[slug]`	"Alternatives to X" landing pages with live leaderboard from the referenced bench
`/answers/[slug]`	Q&A pages backed by a live bench, formatted for AI answer engines
`/hyperliquid`	HyperLiquid frontends cohort; each builder's dashboard (revenue, volume, first-active date) is the Hyperliquid view on its `/products/[slug]` page
`/perps` · ·

Architecture

┌─────────────────────────┐    ┌───────────────────┐    ┌──────────────────────┐
│  50 Go harnesses on     │    │  Shared Prometheus │    │ Materialization worker│
│  ocb-par-main (Paris)   │─── ▶│  (same VPS)        │───▶│ (same VPS, docker)   │
│  each exposes /metrics  │    │  federates a few   │    │ sweeps every 60s     │
└─────────────────────────┘    │  Railway regional  │    └──────┬───────────────┘
                                │  harnesses         │           │
                                └───────────────────┘           ▼
                                                    ┌─────────────────────────┐
                                                    │ Redis + CDN blob store   │
                                                    │ (SRH at kv.opencha…)     │
                                                    └──────────┬──────────────┘
                                                               │
                                                    ┌─────────────────────────┐
                                                    │ Vercel Fluid Compute:    │
                                                    │ pages read CDN blobs     │
                                                    │ first, SRH as fallback,  │
                                                    │ last-known-good on cold  │
                                                    └─────────────────────────┘

Harnesses + Prometheus + worker + Redis + SRH run on one VPS (ocb-par-main in Paris) via docker compose. A handful of multi-region harnesses (rpc-capabilities-us/eu/sgp, evm-quote-latency, aggregator-head-lag regional) stay on Railway and federate into the VPS Prom.
Worker publishes atomic snapshots every 60 s to Redis + CDN blobs at kv.openchainbench.com/aggregate/{latest,benches/<slug>,variants/<slug>/<sig>}.json. Site reads CDN first (~20 ms edge), falls back to SRH, then to the last-known-good snapshot key on cold cache.
Site is Next.js 16 App Router on Vercel Fluid Compute. Auto-deploy from main on every push (with sitemap smoke test + auto-rollback + bench-page warm-up); dev branch runs on staging preview.
Middleware (src/middleware.ts) handles lowercase 308 normalization, /compare/<b>-vs-<a> → canonical alphabetical, 410 Gone for removed benches, 301 for renamed ones, and cache-key normalization on read-only public APIs.
Live stream relay (WebSocket at wss://stream.openchainbench.com/ws) is a separate service run by the OpenChainBench maintainers because it holds upstream API keys; the browser talks to it directly, Vercel only serves the static shell.

Full walkthrough with diagrams + a "clone-and-run-it-yourself" section is in docs/architecture.md.

Repo layout

benchmarks/        94 YAML specs, one per public benchmark
harnesses/         50 Go harnesses, each self-contained + Dockerized
answers/           32 Q&A YAMLs backing /answers/<slug>
alternatives/      23 "alternatives to X" YAMLs backing /alternatives/<slug>
worker/            Materialization worker (sweeps Prom → publishes CDN + Redis blobs)
infrastructure/    Shared Prometheus config
src/               Next.js 16 site (App Router, ISR, Tailwind 4, TypeScript, Zod)
docs/              architecture.md, methodology, walkthrough.md
scripts/           Spec validators + prebuild manifest generators
.github/           CI: prod deploy, staging preview, sync dev from main

Contributing

Read CONTRIBUTING.md for the long-form guide. TL;DR:

Float an idea in Discussions
Open a 📊 Propose a benchmark issue with the metric + methodology
Write the harness (Go recommended, any language shipping /metrics works)
Host it (anywhere with HTTPS + public /metrics)
Open a PR against dev: spec YAML + harness ref + Prom scrape config
Review on the staging preview; merge to main when data lands

Editorial conventions

Same metric, same conditions. If two providers can't be measured identically, they don't share a bench.
Provider marketing does not shape published numbers. Public methodology + reproducible harness are the only source of truth.
Retirement over removal. Retired benches return 410 Gone with a link to the current catalog so previously-indexed URLs decay cleanly.
Freshness signals everywhere. Every citable surface carries dateModified + asOf so LLMs can tell fresh data from stale.
Draft benches never quote a number. If quorum drops, the page renders "awaiting samples" rather than a fabricated leader.

Community + license

Discussions: github.com/ChainBench/OpenChainBench/discussions
Twitter/X: @OpenChainBench
Wikidata: Q140172649
Zenodo DOI: 10.5281/zenodo.20800311
Hugging Face dataset mirror: OpenChainBench/benchmarks (daily parquet snapshots)

License: harness code MIT · dataset CC-BY-4.0 · attribution required. See LICENSE.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install OpenChainBench?

Does OpenChainBench need an API key?

What transport does OpenChainBench use?

When was OpenChainBench last checked?

Documentation

OpenChainBench

At a glance

Quickstart

Machine-readable surfaces

Site surfaces

Architecture

Repo layout

Contributing

Editorial conventions

Community + license