### Every subnet, metagraphed.
Bittensor didn't ship with a map, so we drew one. For every subnet: **what does it expose** (public APIs, docs, schemas), **is it healthy**, and **how do I call it** — machine-readable and agent-native from the ground up.
[](https://metagraph.sh)
[](https://api.metagraph.sh/mcp)
[](https://registry.modelcontextprotocol.io/v0/servers?search=metagraphed)
[](https://mcp.so/server/metagraphed---bittensor-subnet-registry/JSONbored)
[](https://smithery.ai/servers/metagraphed/metagraphed)
[](https://www.npmjs.com/package/@jsonbored/metagraphed)
[](https://pypi.org/project/metagraphed/)
[](./LICENSE)
[](https://gittensor.io/miners/repository?name=JSONbored/metagraphed)
**[Website](https://metagraph.sh)** · [API](https://api.metagraph.sh) · [OpenAPI](https://api.metagraph.sh/metagraph/openapi.json) · [GraphQL](https://api.metagraph.sh/api/v1/graphql) · [MCP](https://api.metagraph.sh/mcp) · [Agent docs](https://api.metagraph.sh/llms.txt) · [Agent workflows](https://api.metagraph.sh/agent-workflows.md) · [Feeds](https://api.metagraph.sh/api/v1/feeds/registry) · [npm](https://www.npmjs.com/package/@jsonbored/metagraphed) · [PyPI](https://pypi.org/project/metagraphed/)
Gittensor contributor impact — refreshed weekly by [`.github/workflows/gittensor-impact.yml`](.github/workflows/gittensor-impact.yml)
---
## 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](https://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.
```bash
claude mcp add --transport http metagraphed https://api.metagraph.sh/mcp
```
> Cursor / other clients: add an MCP server with url `https://api.metagraph.sh/mcp`, transport `streamable-http`.
>
> Tools: `search_subnets` · `list_subnets` · `find_subnets_by_capability` · `get_subnet` · `get_subnet_health` · `get_subnet_economics` · `get_subnet_trajectory` · `get_subnet_metagraph` · `list_subnet_validators` · `get_neuron` · `get_account` · `get_account_events` · `get_account_subnets` · `list_subnet_apis` · `get_api_schema` · `get_fixture` · `get_agent_catalog` · `get_best_rpc_endpoint` · `registry_summary` · `list_enrichment_targets` · `find_subnet_opportunities` · `semantic_search` · `ask` · `find_subnet_for_task` · `how_do_i_call` · `verify_integration`
#### 📦 Typed client
Generated from the OpenAPI contract, published with provenance.
```bash
npm i @jsonbored/metagraphed # JS/TS
pip install metagraphed # Python
```
#### 🌐 REST
Stable JSON envelope `{ ok, data, meta, error }`. OpenAPI at [`/metagraph/openapi.json`](https://api.metagraph.sh/metagraph/openapi.json).
```bash
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`](https://api.metagraph.sh/api/v1/graphql); `GET` returns the SDL and introspection is enabled.
```bash
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`](https://api.metagraph.sh/agent.md) |
| Agent workflows | [`/agent-workflows.md`](https://api.metagraph.sh/agent-workflows.md) |
| Machine index | [`/llms.txt`](https://api.metagraph.sh/llms.txt) |
| GraphQL | [`/api/v1/graphql`](https://api.metagraph.sh/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`](https://api.metagraph.sh/skills/bittensor/SKILL.md) — or `gh skill install JSONbored/metagraphed bittensor` |
| Resources index | [`/metagraph/agent-resources.json`](https://api.metagraph.sh/metagraph/agent-resources.json) |
| Content feeds | [`/api/v1/feeds/registry`](https://api.metagraph.sh/api/v1/feeds/registry) — registry changes + incidents, as RSS / Atom / JSON Feed; [`/api/v1/feeds/gaps`](https://api.metagraph.sh/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.
```text
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`](docs/api-stability.md) (the `/api/v1` contract), [`docs/curation-playbook.md`](docs/curation-playbook.md).
## Contributing
Open the repo in a [devcontainer](.devcontainer/devcontainer.json)-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` (regenerates `openapi.json` + types).
- **Community submissions** are PR-first: add a surface to exactly one `registry/subnets/