metagraphed — Bittensor subnet operational registry MCP Server
io.github.JSONbored/metagraphed
Live operational registry for Bittensor subnets: APIs, schemas, health, and 200+ MCP tools for chain exploration and integration.
What this kind of tool is for
- Automate a build, test, or deployment step you repeat by hand.
- Review or refactor code in an existing repository without leaving your agent.
- Bridge an internal service or CLI into the agent toolset.
How to compare servers like this
- Scope of control:
- Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
- Environment fit:
- Match the runtime it expects (Node, Python, a container) to what you actually run.
- Maintenance signal:
- Check the last-commit date — dev tooling that lags upstream breaks first.
- Config surface:
- Prefer tools whose environment-variable or config keys are documented plainly.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the metagraphed — Bittensor subnet operational registry MCP server?
Metagraphed is an open registry and block explorer for Bittensor that provides machine-readable data on all 128 subnets, their public APIs, endpoint health, and schemas. It exposes 200+ MCP tools for AI agents to discover subnets, check health, integrate with APIs, analyze economics, query chain state, and trace wallet activity across the network.
Metagraphed fills a critical gap in Bittensor's developer experience by offering a curated, probe-derived registry of every subnet's operational status, public interfaces, and integration details. Rather than self-reported data, all health metrics are derived from 15-minute probing cycles. It's designed for integration developers and AI agents, accessible via MCP tools, REST, GraphQL, and typed clients (npm/PyPI), with no authentication required for read-only access.
How to install metagraphed — Bittensor subnet operational registry
Copy-paste configuration for popular MCP clients.
{
"mcpServers": {
"metagraphed": {
"url": "https://api.metagraph.sh/mcp"
}
}
}Tools & capabilities
Tools this server exposes to the agent.
search_subnets— Search and discover subnets by name, capability, or semantic query.find_subnets_by_capability— Find subnets that provide a specific capability or service.find_subnet_for_task— Identify the best subnet for a given task or use case.get_subnet_health— Check the current health status of a subnet and its endpoints.get_self_health— Retrieve the health status of the Metagraphed service itself.list_endpoints— List all available endpoints for a subnet.get_best_rpc_endpoint— Get the best-performing RPC endpoint for a subnet.list_subnet_apis— List all public APIs published by a subnet.get_api_schema— Retrieve the OpenAPI or other schema for a subnet's API.how_do_i_call— Get guidance on how to call a subnet's API with examples.verify_integration— Verify that an integration with a subnet is working correctly.get_subnet_economics— Retrieve economic data: emission, alpha, yield for a subnet.get_subnet_trajectory— Analyze how a subnet's economics are trending over time.get_subnet_yield— Get yield information for a subnet.compare_subnets— Compare economic and operational metrics across multiple subnets.get_block— Retrieve chain block data directly from the Bittensor chain.list_extrinsics— List extrinsics (transactions) on the Bittensor chain.get_subnet_metagraph— Get the metagraph (validator/miner structure) for a subnet.get_neuron— Retrieve detailed information about a specific neuron.get_account— Get account information and portfolio data for a wallet.
Use cases
- Discover which Bittensor subnets have public APIs available and check their current health status.
- Integrate with a subnet's API by retrieving its OpenAPI schema and learning how to call it.
- Analyze subnet economics, emission rates, and yield to compare investment opportunities.
- Trace a wallet's activity and portfolio across all Bittensor subnets.
- Query raw chain state, blocks, and extrinsics directly from the Bittensor blockchain.
metagraphed — Bittensor subnet operational registry MCP server FAQ
Metagraphed is an open registry and block explorer for Bittensor that provides machine-readable data on all 128 subnets, their APIs, health status, and schemas. It's not an official OpenTensor project but a community-built integration layer for developers and AI agents.
Yes, Metagraphed is free and open-source (AGPL-3.0). The API is public and read-only, with no authentication required.
Add the MCP server with URL `https://api.metagraph.sh/mcp` and transport `streamable-http`. For Claude CLI: `claude mcp add --transport http metagraphed https://api.metagraph.sh/mcp`. For Cursor or other clients, add it to your MCP configuration with the same URL.
Metagraphed provides subnet discovery, endpoint health (probe-derived every 15 minutes), API schemas, economics (emission, yield, alpha), chain state, wallet activity, and metagraph structure. All health data is probe-derived, not self-reported.
No. Metagraphed is read-only and public. No API key, account, or authentication is required.
You can access it via MCP tools (for AI agents), REST API, GraphQL, typed clients (npm or PyPI), or the web UI at metagraph.sh.
README (reference)
Source of truth, from the repository.
<a href="https://metagraph.sh"><img src="https://raw.githubusercontent.com/JSONbored/metagraphed/main/public/brand/banner-readme-mint.png" alt="Metagraphed — Bittensor subnet operational layer · data hub · API" width="820"></a>
Every subnet, metagraphed.
The open registry and block explorer for Bittensor. All 128 subnets, the APIs and schemas each one publishes, whether those endpoints answered our last probe, and how to call them — as REST, GraphQL, MCP tools and CSV.
Bittensor didn't ship with a map, so we drew one. Every health figure here is probe-derived on a 15-minute cycle; none of it is self-reported.
Website · API · OpenAPI · GraphQL · MCP · Agent docs · Agent workflows · Feeds · npm · PyPI
</div>What it is
The native Bittensor metagraph tells you what's happening at the protocol layer. Metagraphed adds the builder-facing layer it lacks: a chain-direct block explorer (its own Rust indexer, no third-party RPC dependency), a registry of every subnet's public interfaces, endpoint health, and machine-readable schemas, and an agent toolkit — 200+ MCP tools, paste-ready OpenAI/Anthropic specs, a drop-in skill — built for integration developers, often reached through their AI agents. A live read-only RPC/WSS proxy and non-custodial, wallet-signed staking/delegation round it out.
Not an official OpenTensor/Bittensor project · not a replacement for the native metagraph · not an alpha/price dashboard · not custodial — staking and delegation are wallet-signed client-side; keys and credentials never touch our backend.
The web UI lives at metagraph.sh. The API is served from https://api.metagraph.sh (REST under /api/v1, artifacts under /metagraph).
Quickstart
Three ways to use Metagraphed. Pick one.
🤖 AI agent (MCP)
Agent-native, public, read-only, Streamable-HTTP. 200+ tools to explore the chain, discover a subnet, check if it's up, read its economics and metagraph, trace what a wallet does across the network, and learn how to call it.
claude mcp add --transport http metagraphed https://api.metagraph.sh/mcp
<details>
<summary><b>Other clients</b> — Cursor, VS Code, Windsurf, Zed, ChatGPT, or anything speaking MCP</summary>
Add an MCP server with url https://api.metagraph.sh/mcp and transport streamable-http. No API key, no account, read-only.
{
"mcpServers": {
"metagraphed": {
"type": "streamable-http",
"url": "https://api.metagraph.sh/mcp"
}
}
}
</details>
Ask it things like:
"Which Bittensor subnets have a public API I can call today?" "Is SN64 healthy, and what does its OpenAPI spec look like?" "What changed on subnet 38 last week?" "Which validator should I look at for subnet 19, and what's their take?"
What the tools cover:
| tools | answers | |
|---|---|---|
| 🔍 Discover | search_subnets · semantic_search · find_subnets_by_capability · find_subnet_for_task | which subnet does the thing I need |
| 🩺 Health | get_subnet_health · get_self_health · list_endpoints · get_best_rpc_endpoint | is it up, and which endpoint should I hit |
| 🔌 Integrate | list_subnet_apis · get_api_schema · how_do_i_call · verify_integration | what do I send it, and did it work |
| 📈 Economics | get_subnet_economics · get_subnet_trajectory · get_subnet_yield · compare_subnets | emission, alpha, yield, and how it's trending |
| ⛓️ Chain | get_block · list_extrinsics · get_subnet_metagraph · get_neuron | raw chain state, chain-direct |
| 👛 Wallets | get_account · get_account_events · get_account_subnets · get_account_portfolio | what one account does across the network |
| 💬 Grounded Q&A | ask | a cited answer over the whole registry |
<sub>All tools remain available through a four-tool discovery catalog. The server card links the complete capabilities; common-tool and full-catalog profiles are also available.</sub>
For a tighter chat-context budget, configure the endpoint as
https://api.metagraph.sh/mcp?search_page_size=1 (or 2). search_tools then returns at most
one (or two) complete definitions per page, instead of the default three. Follow next_cursor
with the same query to reach every match. Smaller pages trade additional discovery calls for
less context per response; they do not shrink individual schemas or tool results. Exact-name
search returns just the requested definition. The default catalog remains four tools, and
/mcp/core and /mcp?catalog=full retain their existing listings and capabilities.
📦 Typed client
Generated from the OpenAPI contract, published with provenance.
npm i @jsonbored/metagraphed # JS/TS
pip install metagraphed # Python
🌐 REST
Stable JSON envelope { ok, data, meta, error }. OpenAPI at /metagraph/openapi.json.
curl https://api.metagraph.sh/api/v1/subnets
🔮 GraphQL
Shape one request across the registry — a subnet with its health, surfaces, endpoints, and economics, a provider with its subnets, or the economic opportunity boards. POST to /api/v1/graphql; GET returns the SDL and introspection is enabled.
curl -X POST https://api.metagraph.sh/api/v1/graphql \
-H 'content-type: application/json' \
-d '{"query":"{ subnet(netuid: 7) { name health { status } surfaces { kind url } economics { emission_share } } }"}'
For agents
| Resource | URL |
|---|---|
| Copyable agent prompt | /agent.md |
| Agent workflows | /agent-workflows.md |
| Machine index | /llms.txt |
| GraphQL | /api/v1/graphql — POST a shaped query (subnet + health + surfaces + endpoints + economics, provider + subnets, opportunity boards); GET returns the SDL |
| Drop-in skill | /skills/bittensor/SKILL.md — or gh skill install JSONbored/metagraphed bittensor |
| Resources index | /metagraph/agent-resources.json |
| Content feeds | /api/v1/feeds/registry — registry changes + incidents, as RSS / Atom / JSON Feed; /api/v1/feeds/gaps for ranked coverage gaps (per-subnet at /api/v1/feeds/subnets/{netuid}) |
| Embeddable badge |  — SVG (also /providers/{slug}/badge.svg); ?metric=uptime for reliability, ?metric=completeness for coverage score, plus ?style=flat-square and ?label=… |
This repo
Cloudflare Worker API + Node build scripts. Schema-first: JSON Schema is the canonical contract → OpenAPI → types/clients. Artifacts are deterministic JSON; data refreshes on a schedule to R2/KV.
docs/ product + operating notes (start here)
registry/ subnet overlays, candidates, community submissions
schemas/ canonical JSON Schema components
scripts/ validation, generation, probe, safety
workers/ Cloudflare Worker API routes
public/metagraph/ compact generated artifacts + contracts
generated/ generated TypeScript types + client
Deeper docs: docs/api-stability.md (the /api/v1 contract), docs/curation-playbook.md.
Contributing
Open the repo in a devcontainer-aware tool (VS Code, GitHub Codespaces, the devcontainer CLI) for a zero-setup environment — Node 22 + Playwright's Chromium preinstalled. Issues are labeled good first issue and help wanted — start there.
- Schema-first edits require
npm run build(regeneratesopenapi.json+ types). - Community submissions are PR-first: add a surface to exactly one
registry/subnets/<slug>.jsonfile (vianpm run surface:add; usenpm run subnet:newfirst when that subnet has no file yet), no generated artifacts.
See CONTRIBUTING.md and docs/curation-playbook.md.
Subnet catalog
<!-- BEGIN:REGISTRY-CATALOG -->128 curated subnets — 117 with a site, 46 with docs, 116 with a public repo. Live health, search, and the full list (every active subnet, not just the curated ones) at metagraph.sh; per-subnet JSON at https://api.metagraph.sh/api/v1/subnets/{netuid}. Root (SN0) is base-layer chain infrastructure, listed separately below, not counted as a subnet.
Focus areas: compute 9 · data 7 · defi 6 · inference 6 · language-models 4 · prediction-markets 4 · computer-vision 3 · finance 3 · dashboard 2 · data-artifact 2 · decentralized-training 2 · depin 2
- root
SN0—chain-rpc· site · docs · repo - Apex
SN1· site · docs · repo - DSperse
SN2—verifiable-oracleszkml· site · docs · repo - Templar
SN3—decentralized-trainingtournament· site · docs · repo - Targon
SN4· site · docs · repo - Hone
SN5· site · repo - Numinous
SN6—forecastingopenapisubnet-api· site · docs · repo - Allways
SN7—bitcoindefisubnet-api· site · docs · repo - Vanta
SN8· site · repo - iota
SN9· site · repo - Swap
SN10· site · docs · repo - TrajectoryRL
SN11· site · docs · repo - Compute Horde
SN12—computedashboard· site · repo - Data Universe
SN13—datamcp· site · docs · repo - Cacheon
SN14—inference· site · docs · repo - ORO
SN15· site · docs · repo - BitAds
SN16· repo - 404—GEN
SN17—3d-generation· site · repo - Zeus
SN18—weather-forecasting· site · docs · repo - blockmachine
SN19· site · docs · repo - GroundLayer
SN20—capital-markets· site - AdTAO
SN21—advertising· site · repo - Desearch
SN22—searchsocial-data· site · docs · repo - Trishool
SN23—subnet-api-observed· site · repo - Quasar
SN24—language-modelsmodel-artifacts· site · docs · repo - Mainframe
SN25—compute· site · repo - Perturb
SN26—adversarial-robustnesscomputer-vision· site · docs · repo - NI Compute
SN27—computedashboard - gm
SN28—llm-inferencemarketplacetee· site · repo - Coldint
SN29—datadistributed-training· site · docs · repo - Endure Network
SN30—defirisk-intelligence· site · docs - Recall
SN31—ragretrieval - ItsAI
SN32· site · repo - ReadyAI
SN33—conversation-datadata· site · docs · repo - BitMind
SN34—deepfake-detection· site · docs · repo - OxMarkets
SN35—defi· site · repo - Leoma
SN36· site · repo - Aurelius
SN37—alignment· site · repo - ChronoLLM
SN38—language-models· site · docs · repo - Basilica
SN39—compute· site · repo - Ralph
SN40—distributed-traininglanguage-models· site · docs · repo - Almanac
SN41—prediction-markets· site · repo - Gopher
SN42—datatee· site · docs · repo - Graphite
SN43—optimizationresearch· site · repo - Score
SN44—computer-vision· site · repo - AlphaRidge.ai
SN45—market-intelligencesentiment-analysis· site · repo - Zipcode
SN46—real-estate· site · repo - EvolAI
SN47—data· site · repo - Quantum Compute
SN48—computequantum· site · repo - Nepher Robotics
SN49—roboticstournament· site · docs · repo - Synth
SN50—finance· site · repo - lium.io
SN51—compute· site · repo - Dojo
SN52—tensorplex· site · docs · repo - engy
SN53—inferencellm-servingverified-compute· site · repo - Yanez MIID
SN54—compliancesynthetic-data· site · repo - NIOME
SN55—genomicssynthetic-data· site · repo - Gradients
SN56—ai-trainingoperational-interface· site · docs · repo - Sparket
SN57—prediction-marketssports· site · repo - Handshake58
SN58—ai-marketplacepayments· site · docs · repo - Babelbit
SN59—language· site · repo - Bitsec
SN60—security· site · repo - RedTeam
SN61—cybersecurity· site · docs · repo - Ridges
SN62—agents· site · repo - Enigma
SN63—quantum· site · repo - Chutes
SN64—computeinference· site · docs · repo - TAO Private Network
SN65—networking· site · repo - ninja
SN66—software-engineeringworkflow· site · docs · repo - Harnyx
SN67· site · repo - NOVA
SN68· site · repo - ain
SN69· site · repo - NexisGen
SN70· site · repo - Leadpoet
SN71· site · repo - StreetVision by NATIX
SN72—computer-visiondatadepin· site · docs · repo - MetaHash
SN73—defiotctreasury - Gittensor
SN74—developer-toolsrepositories· site · docs · repo - Hippius
SN75—depinstorage· site · docs · repo - Byzantium
SN76· site · repo - Liquidity
SN77—defi· site · repo - Vocence
SN78· site · repo - MVTRX
SN79· site · docs · repo - dogelayer
SN80· repo - Grail
SN81—decentralized-training· docs · repo - Compelle
SN82· site · repo - CliqueAI
SN83· site · repo - ansuz
SN84—chip-designhardware· site · docs · repo - Vidaio
SN85· site · repo - Subnet 86
SN86 - Luminar Network
SN87—video-intelligencevision· site · docs · repo - Investing
SN88—data-artifactfinance· site · repo - InfiniteHash
SN89· site · docs · repo - DegenBrain
SN90—prediction-marketsverification· site - Bitstarter #1
SN91· site · repo - Tensorclaw
SN92—inferencestale-source-restored· site · repo - Bitcast
SN93· site · repo - Bitsota
SN94· site · repo - Actual
SN95—inferencemodel-registry· site - Verathos
SN96—inferencelanguage-models· site · docs · repo - Albedo
SN97· site · repo - ForeverMoney
SN98—finance· site · repo - Thirty Spokes
SN99· site - Plaτform
SN100—ai-research· site · docs · repo - eni
SN101· site · repo - ConnitoAI
SN102· site · repo - Djinn
SN103· site · repo - Masx.ai
SN104—no-public-project-surface - Beam
SN105· site · repo - Nodexo
SN106—computegpu· site · docs · repo - Minos
SN107· site · repo - TalkHead
SN108· site · repo - Academia
SN109—data-artifact· repo - Green Compute
SN110—model-directory· site · docs · repo - oneoneone
SN111—dataugc· site · repo - minotaur
SN112· site · repo - TensorUSD
SN113—stablecoin· site · docs · repo - SOMA
SN114—mcp· site · repo - HashiChain
SN115· repo - TaoLend
SN116—defilending· site - Glyph
SN117· site · repo - Ditto
SN118—agent-memory· site · docs · repo - Satori
SN119—virtual-world - Affine
SN120· site · repo - sundae_bar
SN121· site · repo - Bitrecs
SN122—recommendations· site · docs · repo - MANTIS
SN123—sdk· site · repo - Swarm
SN124—robotics· site · repo - 8 Ball
SN125—prediction-markets· site · docs · repo - Poker44
SN126—security· site · repo - Astrid
SN127—trading-strategies· site · repo - ByteLeap
SN128—compute· site · repo
<sub>Auto-generated from the curated overlays in registry/subnets/ by scripts/generate-registry-readme-section.ts — enrich a subnet (one PR) and it appears here. Not the live list; browse + monitor everything at metagraph.sh.</sub>
Related
- Frontend —
apps/ui/in this repo (folded in from the standalonemetagraphed-uirepo via monorepo consolidation): the web app at metagraph.sh — block explorer, subnet directory, and a non-custodial staking/delegation flow (/delegate). Vite + React 19 + TanStack Start, deployed as its own independent Cloudflare Worker. Holds no subnet data — it renders what this backend serves.
License
The backend (Cloudflare Worker + build pipeline) is AGPL-3.0. The
published client SDKs are permissively licensed so you can embed them freely —
packages/client (npm) and python/ (PyPI) are
Apache-2.0.
© 2026 JSONbored
Related MCP servers
Search 1,300+ curated Claude agents, MCP servers, skills, and tools directly from your AI client.

Connect After Effects to AI clients via local MCP endpoint with ExtendScript and native AEGP execution.

io.github.JXUE0/opencut-controller
Professional MCP server for video editing automation with OpenCut.

Moxie Docs
Living docs and MCP context for GitHub repos — conventions, gaps, and source-cited pages on merge.

corpusAI Cloud Pricing
Cloud, GPU and LLM token prices with index fixings. Pay per call over x402 or with a prepaid key.

Polish company registers: KRS extracts, Biała Lista VAT and bank account checks, ID validation.
