OpenChainBench MCP server
2026년 11월 13일 커밋AI 클라이언트가 RPC 지연 시간, 브릿지, 오라클, DEX 등 암호화폐 인프라의 실시간 중립 벤치마크 데이터에 접근할 수 있도록 합니다.
다른 이름 ChainBench/OpenChainBench
- 스타
- 10
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- MIT
OpenChainBench MCP란?
AI 클라이언트가 RPC 지연 시간, 브릿지, 오라클, DEX 등 암호화폐 인프라의 실시간 중립 벤치마크 데이터에 접근할 수 있도록 합니다.
프로젝트 README에서 생성된 요약
OpenChainBench MCP server 정보
OpenChainBench는 다양한 암호화폐 인프라 구성 요소에 대한 실시간 중립 성능 데이터를 제공합니다. RPC 엔드포인트, 브릿지, 오라클, DEX 및 크로스체인 메시징 시스템의 메트릭을 추적합니다. 정적인 보고서 대신 Go harness를 사용하여 정기적으로 제공업체를 조사하므로 지연 시간이나 수수료와 같은 수치가 24시간 내내 재계산됩니다.
개발자와 AI 에이전트는 호스팅된 MCP server 또는 직접 HTTP 엔드포인트를 통해 이 데이터에 접근할 수 있습니다. 서버는 API key나 계정이 필요하지 않지만, 읽기 엔드포인트는 IP당 분당 60회로 제한됩니다. 특정 업체의 마케팅 주장 대신 검증 가능하고 기계가 읽을 수 있는 벤치마크가 필요한 사용자를 위해 설계되었습니다.
MCP 인터페이스를 통해 클라이언트는 list_benchmarks, get_benchmark, search_benchmarks, compare_providers, recommend_provider와 같은 특정 도구를 사용할 수 있습니다. 이 플랫폼은 모든 메트릭을 생성하는 데 사용된 정확한 방법론과 PromQL 쿼리를 공개하여 투명성을 강조합니다.
활용 사례
- 1인프라 성능 비교AI 에이전트가 모든 공유 벤치마크에 대해 두 가지 다른 제공업체를 평가하여 더 우수한 옵션을 찾을 수 있습니다.
- 2최적의 서비스 제공업체 식별개발자가 AI 클라이언트에게 현재 사용 가능한 가장 빠른 무료 Ethereum RPC 엔드포인트를 찾아달라고 요청할 수 있습니다.
- 3브릿지 비용 모니터링사용자가 시스템에 질의하여 USDC 이동 시 가장 낮은 수수료를 제공하는 브릿지가 무엇인지 확인할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
OpenChainBench MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 OpenChainBench MCP 설치
$ claude mcp add --transport http openchainbench https://openchainbench.com/api/mcp/mcpCursor에 OpenChainBench MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"openchainbench": {
"url": "https://openchainbench.com/api/mcp/mcp"
}
}
}VS Code에 OpenChainBench MCP 설치
.vscode/mcp.json
{
"servers": {
"openchainbench": {
"type": "http",
"url": "https://openchainbench.com/api/mcp/mcp"
}
}
}VS Code CLI에 OpenChainBench MCP 설치
$ code --add-mcp '{"name":"openchainbench","type":"http","url":"https://openchainbench.com/api/mcp/mcp"}'Codex에 OpenChainBench MCP 설치
$ codex mcp add openchainbench --url https://openchainbench.com/api/mcp/mcpCodex config.toml에 OpenChainBench MCP 설치
~/.codex/config.toml
[mcp_servers.openchainbench] url = "https://openchainbench.com/api/mcp/mcp"
Gemini CLI에 OpenChainBench MCP 설치
$ gemini mcp add -s user --transport http openchainbench https://openchainbench.com/api/mcp/mcpGemini settings.json에 OpenChainBench MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"openchainbench": {
"url": "https://openchainbench.com/api/mcp/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능chainbench/openchainbench is public and reachablegithub.com/chainbench/openchainbench ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-13github.com/chainbench/openchainbench ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 169 ms통과
README
GitHub에서 보기OpenChainBench
OpenChainBench measures crypto infrastructure the same way for every provider, publishes the number, and ships the code that produced it. RPC endpoints, data APIs, bridges, perp DEXes, prediction markets, oracles, cross-chain messaging. Live at openchainbench.com.
It answers questions like which free Ethereum RPC answers fastest, or which bridge charges least to move USDC, with figures recomputed around the clock rather than written down once.
Every benchmark ships with the harness that produces its data, under MIT, with the dataset under CC-BY-4.0, and pull requests are open to any party including the providers being measured. The card above is live, and GitHub caches it, so it can lag the page it links to.
What this is
- A public registry of benchmarks, one YAML spec per benchmark, each naming its metric, its methodology and the exact PromQL behind every figure it publishes.
- A set of self-contained Go harnesses that probe providers on a schedule and expose Prometheus metrics. One shared Prometheus scrapes them, one worker materializes snapshots, the site reads those snapshots.
- A citable data surface. Every benchmark figure is available as JSON, as Markdown, over RSS and through an MCP server. JSON responses carry an
asOftimestamp, a source URL and a licence; exported citations carry the page URL and the date you retrieved it.
What this is not
- Not a token, a fund, or an RPC vendor.
- Not editable by the measured. A provider may be shown the facts behind a report before it is published, and the staging site is public, so figures are visible before a release. Nobody outside the method can change a number.
- Not a single-vendor view. Providers that cannot be measured under identical conditions are split into separate benchmarks, or filtered to the same scope, and the spec says which.
Get the data in 30 seconds
pip install openchainbench
from openchainbench import OpenChainBench
with OpenChainBench() as ocb:
for b in ocb.list_benchmarks()[:5]:
print(b.slug, b.leader)
head_lag = ocb.get_benchmark("aggregator-head-lag")
print(head_lag.headline)
No key and no account. Read endpoints allow 60 requests a minute per IP, and the AI crawlers named in robots.txt are exempt. The same data over plain HTTP:
# every benchmark with its current value, leader and citation
curl https://openchainbench.com/api/citable
# one benchmark: rankings, 24h sparkline, methodology, paste-ready quote
curl https://openchainbench.com/api/stat/aggregator-head-lag
# a benchmark as Markdown instead of HTML, at the same URL
curl -H "Accept: text/markdown" https://openchainbench.com/benchmarks/bridge-fee
For an agent, point an MCP client at the hosted server:
{ "mcpServers": { "openchainbench": { "url": "https://openchainbench.com/api/mcp/mcp" } } }
It exposes list_benchmarks, get_benchmark, search_benchmarks, compare_providers, recommend_provider and list_answers, plus the openchainbench://benchmark/{slug} resource. Install notes are at /mcp.
One benchmark, end to end
A benchmark is a spec, a harness, and the surfaces generated from them. Take aggregator-head-lag, which measures how long a data API takes to emit a swap that is already on chain.
The spec (benchmarks/aggregator-head-lag.yml) declares the metric, the unit, whether higher is better, the written methodology, and one PromQL query per provider per percentile. No number on the page is typed by hand.
The harness (harnesses/aggregator-head-lag/) subscribes to chain events and to each provider's feed, races them per transaction, and exposes the result at /metrics.
The published shape, from GET /api/stat/aggregator-head-lag:
{
"slug": "aggregator-head-lag",
"metric": "Head lag",
"unit": "s",
"higherIsBetter": false,
"value": 0.240038, // example reading, 2026-10-25
"leader": { "name": "Codex", "slug": "codex", "value": 0.240038 },
// ms holds the raw series value in the benchmark's stored unit, which is
// not always milliseconds: on a percent benchmark it holds a percent.
"rankings": [ { "name": "Codex", "ms": { "p50": 240.038, "p90": 399.49 } } ],
"sparkline": [ /* 73 points, last 24h */ ],
"sampleSize": 184980,
"measured": 6,
"ranked": 6,
"asOf": "2026-10-25T19:26:11.573Z",
"freshness": { "ageHours": 0.2, "stale": false },
"headline": "...", // one sentence, ready to quote
"methodology": [ /* the written rules, same text as the page */ ],
"source": "https://github.com/ChainBench/OpenChainBench/tree/main/harnesses/aggregator-head-lag",
"license": "CC-BY-4.0"
}
headline is generated from the current reading, so it is correct whenever you fetch it and stale the moment it is pasted into a file. Quote it with its asOf. For a formal citation use /api/cite/<slug>/bib.
By the numbers
| In this repository | Count |
|---|---|
Benchmark spec files (benchmarks/*.yml) |
243 |
Harness directories (harnesses/*/, every one a Go module) |
73 |
Answer pages (answers/*.yml) |
49 |
Alternatives pages (alternatives/*.yml) |
21 |
Distinct categories (category: values across the specs) |
10 |
| Categories with a published benchmark | 8 |
Held on staging until a release condition is met (DEV_ONLY_BENCH_SLUGS) |
7 |
Retired, answering 410 Gone or redirecting to a successor (REMOVED_BENCH_SLUGS) |
38 |
243 specs, minus 7 held on staging, minus 2 retired benches that keep their spec, leaves 234 benchmarks that this commit publishes. Counts derived from the repository at 2026-11-06.
Published by category: RPCs 157, Trading 43, Aggregators 9, Bridges 9, Blockchains 8, RWA 6, NFT APIs 1, Wallets 1.
The badge at the top reads the live count from /api/citable, which is what production serves. The table is derived from the commit you are reading. The two agree once a change has been released, and differ while a benchmark is merged and waiting, so comparing them tells you something instead of requiring you to trust either.
Machine-readable surfaces
Every benchmark is CC-BY-4.0 and reachable without a key.
| Endpoint | What it returns |
|---|---|
/api/citable |
Every benchmark with its current value, leader, headline sentence, citation and asOf. Start here. |
/api/stat/<slug> |
One benchmark: rankings, 24h sparkline, methodology, quote, source, freshness. |
/api/series/<slug> |
Per-provider time series. ?range=24h. |
/api/compare/<a>/<b> |
Two providers across every benchmark they share. |
/api/cite/<slug>/<format> |
Citation as bib, ris, apa or txt, with the matching content type. |
/api/openapi.json |
OpenAPI 3.1 schema covering 11 of the read endpoints. |
/api/mcp/mcp |
MCP server over streamable HTTP. Six tools and one resource template. |
/api/llm-context |
Every benchmark with rankings and methodology as one Markdown document. |
/llms.txt · /llms-full.txt |
Index and full context per the llmstxt.org convention. llms-full.txt and /api/llm-context serve the same document. |
Accept: text/markdown |
Returns Markdown instead of HTML at the page's own URL, on /benchmarks/<slug>, /products/<slug>, /perps, /rwa and /capital. Browsers are unaffected because their Accept header includes text/html. |
/api/freshness |
{slug: asOf} in epoch milliseconds for every benchmark, plus the server's now. Cached 30 s. |
/api/og/<slug> |
The 1200x630 card with the current value, leader and sparkline, at a stable URL. |
/benchmarks/<slug>/share-card |
Export card in five templates (ranking, snapshot, headline, compare, leaderboard), with ?theme=dark. |
/api/badge/<bench>/<provider> |
Embeddable SVG with that provider's rank and figure. Add /snippet for paste-ready Markdown. |
/rss.xml · /feed.json |
RSS 2.0 and JSON Feed 1.1, one entry per live benchmark. |
/sitemap.xml · /robots.txt |
Every URL we publish. More than thirty AI and answer-engine crawlers are named and allowed explicitly. |
/contribute/ai-brief.md |
A brief written for coding agents contributing a benchmark. |
Each benchmark page also carries Dataset, StatisticalReport, Observation, TechArticle, FAQPage, DataDownload and BreadcrumbList JSON-LD.
Two mirrors are published outside this repo: a Hugging Face dataset with a daily parquet snapshot, and a Zenodo record under DOI 10.5281/zenodo.20800311.
Site surfaces
| Route family | What lives there |
|---|---|
/benchmarks, /benchmarks/<slug>, /benchmarks/<slug>/<chain> |
Catalogue, then one leaderboard per benchmark with chart, ledger, chain and region filters, share cards and FAQ. Chain-scoped views carry their own explainer. |
/products/<slug> |
One page per product: every benchmark it appears in, first-place counts, related products, and a view per category it belongs to. |
/chains/<slug> |
Per-chain hub: native price, TVL history, and every benchmark touching that chain grouped by category. |
/compare/<a>-vs-<b> |
Head to head across shared benchmarks. Alphabetical order is canonical and enforced with a redirect. |
/answers/<slug> · /alternatives/<slug> |
Question pages and "alternatives to X" pages, each backed by a live benchmark rather than by prose. |
/rpc · /perps · /prediction-markets · /hyperliquid · /capital |
Vertical hubs aggregating several benchmarks per topic. |
/methodology · /contribute · /mcp · /press · /badges · /about |
How it works, how to contribute, how to cite and embed. |
How it works
flowchart LR
H["Go harnesses<br/>each exposing /metrics"] --> P["Shared Prometheus"]
R["Regional harnesses<br/>US, EU, SGP"] -.federated.-> P
P --> W["Materialization worker<br/>sweeps and publishes snapshots"]
W --> B["Redis plus CDN blob store<br/>kv.openchainbench.com"]
B --> S["Next.js site on Vercel<br/>reads the blob, Redis as fallback"]
S --> A["JSON, Markdown, RSS, MCP,<br/>cards, badges, citations"]
- Harnesses run as containers on one VPS in Paris. A few that must measure from more than one place run on Railway and federate into the same Prometheus, because a latency number is meaningless without saying where it was measured from.
- The worker sweeps Prometheus on a timer and publishes atomic snapshots to Redis and to CDN blobs at
kv.openchainbench.com/aggregate/.... The site reads the blob first, falls back to Redis, and falls back again to the last known good snapshot rather than rendering an empty page. - The site is Next.js 16 on Vercel.
maindeploys to production automatically, with a warm-up pass, a sitemap indexability smoke test, an automatic rollback if that test fails, and an IndexNow ping once it passes.devdeploys to a staging preview. - Routing rules are in
src/middleware.tsandnext.config. A retired benchmark answers410 Gonewith a link to the catalogue, or redirects permanently where it has a successor. A renamed one redirects permanently to its new slug. And/compare/<b>-vs-<a>redirects to the canonical alphabetical order, so one comparison has one URL. - The live dashboard reads a WebSocket relay at
wss://stream.openchainbench.com/ws, which the maintainers run separately because it holds upstream API keys. The browser talks to it directly.
Depth, including a clone-and-run-it-yourself walkthrough, is in docs/architecture.md.
Repo layout
benchmarks/ one YAML spec per benchmark
harnesses/ one Go module per harness, each self-contained and Dockerized
answers/ Q&A specs backing /answers/<slug>
alternatives/ "alternatives to X" specs backing /alternatives/<slug>
packages/ python-client, published to PyPI as openchainbench
worker/ materialization worker: Prometheus to CDN and Redis snapshots
infrastructure/ shared Prometheus config
src/ the Next.js site, App Router, TypeScript, Tailwind, Zod
scripts/ spec validators, prebuild manifests, sitemap smoke test
docs/ architecture.md, methodology, walkthrough.md
public/ static assets served by the site
video/ the renderer behind the Export video button on every benchmark page
.github/ CI, production deploy, staging preview, dataset publishing
crm/ and outreach/ are internal tooling and not part of the published benchmark surface.
Contributing
Long form in CONTRIBUTING.md, visual walkthrough at /contribute, and a brief for coding agents at /contribute/ai-brief.md.
- Float the idea in Discussions.
- Open a
Propose a benchmarkissue with the metric and the methodology, before writing code. - Write the harness. Go is the convention, but anything that serves
/metricsover HTTPS works. - Host it anywhere with a stable HTTPS URL. You keep your keys and your budget; maintainers never see them.
- Open a PR against
devwith the spec, a link to the harness, and the Prometheus scrape config. - Review it on the staging preview. It reaches production once data has landed and the page reads correctly.
Local checks before you open it:
pnpm install
pnpm dev # http://localhost:3000
pnpm validate # every spec against the Zod schema
pnpm check # validate, typecheck, lint, test
How we decide what to publish
- Same metric, same conditions. Where providers cannot be measured identically they are split apart or filtered to a common scope, and the benchmark says so rather than comparing them anyway.
- Marketing does not shape a number. The published methodology and the harness are the only inputs.
- A benchmark earns its page. New ones are held on staging until a written condition is met, for example a full measurement window, an audit round, or a minimum number of providers. The conditions are in
src/lib/removed-benches.ts, one comment per benchmark, including the ones still waiting. - Retirement, not deletion. A retired benchmark answers
410 Goneand keeps its entry, or redirects to its successor where one exists, so an indexed URL decays honestly instead of disappearing. - No number without a timestamp. Every JSON surface carries
asOf, and/api/freshnessreturns the whole map as epoch milliseconds, so a reader can tell fresh from stale without asking us. - A draft never quotes a figure. If too few providers report, the page says it is awaiting samples instead of crowning a leader on thin data.
Cite this
@misc{openchainbench,
author = {OpenChainBench},
title = {OpenChainBench: live benchmarks for crypto infrastructure},
year = {2026},
doi = {10.5281/zenodo.20800311},
url = {https://openchainbench.com},
note = {Dataset licensed CC-BY-4.0}
}
For one benchmark, GET /api/cite/<slug>/bib returns the same shape for that page, and ris, apa and txt are also available.
The DOI resolves to the latest version of the dataset record, which is v1.0.1 published 2026-06-22. Cite it for the dataset, and cite a page with its asOf for a figure you read today.
Questions
Is the data free to use? Yes. The dataset is CC-BY-4.0, so quote it, chart it, or ship it in a product, with attribution to OpenChainBench and a link to the page you took it from. Harness code is MIT.
Can I add my own product? Yes, including if we already measure you. Providers can open PRs here. What a PR cannot do is change a number without changing the method that produced it, and a method change applies to every provider in that benchmark at once.
A figure about my product looks wrong. What now? Open a provider correction issue with the page, the figure and what you measured instead. Every benchmark value traces to a PromQL query in a spec and a harness in this repo, so a disagreement is usually resolvable by reading both.
How current is a number? Each benchmark carries its own asOf. /api/freshness returns the whole map in one request, and a page that has gone stale says so rather than showing an old figure as current.
Why does a benchmark exist in this repo but not on the site? Because it has not met its release condition yet. Those are listed with a reason in src/lib/removed-benches.ts, and the arithmetic in the numbers table above accounts for every one of them.
Do you measure providers who do not want to be measured? We measure endpoints any customer can reach under their published terms, free ones and paid ones, and the keyed benchmarks say which plan was used. A provider can ask for its methodology to be corrected and that is usually a good PR, but not for its result to be removed because the result is unflattering.
Community and licence
Discussions · @OpenChainBench · PyPI · Hugging Face · Zenodo · Wikidata
Harness and site code: MIT, see LICENSE. Dataset: CC-BY-4.0 with attribution required, published as the license field on every API response.
OpenChainBench MCP 질문
OpenChainBench MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http openchainbench https://openchainbench.com/api/mcp/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
OpenChainBench MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
OpenChainBench MCP server로 무엇을 할 수 있나요?
벤치마크 목록 조회, 특정 벤치마크 데이터 가져오기, 벤치마크 검색, 제공업체 비교, 제공업체 추천 및 답변 목록 조회 기능을 제공합니다.
데이터에 접근하려면 API key가 필요한가요?
아니요, 키 없이도 데이터에 접근할 수 있으며 읽기 엔드포인트는 IP당 분당 60회의 요청을 허용합니다.
벤치마크 데이터는 어떻게 생성되나요?
독립형 Go harness가 정해진 일정에 따라 제공업체를 조사하고 Prometheus metrics를 노출하여 데이터를 생성합니다.