{ "amount_usd": 0.01, "asset": "USDC", "asset_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base", "network": "eip155:8453", "pay_to": "0x79DC34E41B2b591078d3dE222C43EcaaBD52FcCB", "scheme": "exact", "asset_transfer_method": "eip3009" } ``` Client libraries: [`@graphprotocol/client-x402`](https://www.npmjs.com/package/@graphprotocol/client-x402), `x402-fetch`, or any generic x402 wrapper. --- ## Registry at a Glance

Subgraphs by Domain

Subgraphs by Network

Subgraphs by Protocol Type

Reliability Distribution

> Charts auto-generated from `registry.db` on each sync. See [`python/generate_docs.py`](python/generate_docs.py). --- ## Browse by Category ### Domains Explore subgraphs by use case — each file lists the top 25 subgraphs ranked by reliability score. | Domain | Count | File | |--------|-------|------| | [DeFi](docs/domains/defi.md) | 11,218 | Swaps, pools, lending, vaults, yield | | [NFTs](docs/domains/nfts.md) | 857 | Collections, marketplaces, sales | | [Infrastructure](docs/domains/infrastructure.md) | 581 | Indexers, oracles, registries | | [DAO](docs/domains/dao.md) | 429 | Governance, proposals, voting | | [Identity](docs/domains/identity.md) | 401 | ENS, name services, resolvers | | [Analytics](docs/domains/analytics.md) | 327 | Snapshots, metrics, historical data | | [Gaming](docs/domains/gaming.md) | 247 | Players, quests, items, worlds | | [Social](docs/domains/social.md) | 74 | Profiles, posts, follows | Full index: [`docs/DOMAINS.md`](docs/DOMAINS.md) ### Networks Explore subgraphs by blockchain — each file lists the top 25 subgraphs on that chain. | Network | Count | File | |---------|-------|------| | [Ethereum](docs/networks/mainnet.md) | 2,377 | Largest ecosystem | | [Base](docs/networks/base.md) | 1,728 | Fast-growing L2 | | [BSC](docs/networks/bsc.md) | 1,582 | BNB Chain | | [Arbitrum](docs/networks/arbitrum-one.md) | 1,376 | Leading L2 | | [Polygon](docs/networks/matic.md) | 1,266 | Polygon PoS | | [Optimism](docs/networks/optimism.md) | 568 | OP Stack L2 | | [Avalanche](docs/networks/avalanche.md) | 440 | C-Chain | Full index: [`docs/NETWORKS.md`](docs/NETWORKS.md) ### Protocol Types | Type | Count | Description | |------|-------|-------------| | DEX | 4,176 | Uniswap, Sushi, Curve, Balancer, PancakeSwap | | Lending | 1,424 | Aave, Compound, Morpho, Spark, Silo | | Staking | 867 | Lido, Rocket Pool, EigenLayer, Graph Network | | Bridge | 771 | Hop, Stargate, Across, Wormhole, LayerZero | | NFT Marketplace | 436 | OpenSea, Blur, Rarible, Foundation | | Governance | 416 | Snapshot, Tally, Compound Governor | | Yield Aggregator | 387 | Yearn, Beefy, Harvest, Convex | | Perpetuals | 266 | GMX, Gains, dYdX, Hyperliquid | | Name Service | 223 | ENS, Space ID, Unstoppable Domains | | Options | 179 | Premia, Dopex, Lyra, Hegic | --- ## Reliability Score Each subgraph gets a composite reliability score (0-1) based on four on-chain signals: | Signal | Weight | What it measures | |--------|--------|------------------| | **Query Fees** | 30% | GRT fees earned from actual usage | | **Query Volume** | 30% | 30-day query count | | **Curation Signal** | 20% | GRT tokens curated by the community | | **Indexer Allocation** | 20% | GRT allocated to this subgraph by indexers | All values are log-scaled and capped at 1.0. A 0.5 penalty is applied if the subgraph has been denied/deprecated. **Score tiers:** High (0.7+) = strong signal, real usage | Medium (0.3-0.7) = functional, some activity | Low (<0.3) = minimal signal or test deployment --- ## MCP Server The registry is available as an MCP server with **dual transport** — stdio for local clients and SSE/HTTP for remote agents. > The shipped server is the Node implementation in [`src/index.js`](src/index.js); that's what `npx subgraph-registry-mcp` runs and what's published to npm. A Python equivalent in [`python/mcp_server.py`](python/mcp_server.py) is kept for local development against the same SQLite database — bug fixes and new tools should land in the Node version first. **6 tools:** - **search_subgraphs** — filter by domain, network, protocol type, entity, or keyword - **recommend_subgraph** — natural language goal to best subgraphs (includes `schema_stable_days`) - **get_subgraph_detail** — full classification for a specific subgraph (includes `schema_changed_at`) - **list_registry_stats** — registry overview (domains, networks, counts) - **semantic_search_subgraphs** — vector-similarity search over precomputed embeddings (sentence-transformers/all-MiniLM-L6-v2, 384-dim). Use for fuzzy/paraphrased goals where literal keyword match would miss. - **get_schema_changes** — chronological schema-fingerprint history for a subgraph (one row per detected change). Helps agents prefer mature subgraphs whose data contract has been stable. ### Install ```bash # Claude Code claude mcp add subgraph-registry -- npx subgraph-registry-mcp # Claude Desktop { "mcpServers": { "subgraph-registry": { "command": "npx", "args": ["subgraph-registry-mcp"] } } } # Remote agents (SSE) npx subgraph-registry-mcp --http-only # Then connect to http://localhost:3848/sse ``` The server auto-downloads the pre-built registry (8MB SQLite) from GitHub on first run. --- ## Well-Known JSON-LD Manifest Stable, machine-readable per-subgraph manifest that other crawlers and agent frameworks can index without going through MCP. Served by the Node MCP HTTP transport: ``` GET /.well-known/subgraph/{id}.jsonld Full per-subgraph manifest (JSON-LD) GET /subgraphs/{id}.jsonld Alias (same payload) GET /.well-known/subgraph-index.jsonld Discovery list — top 100 by reliability with @id links ``` Each manifest includes classification, parsed entities, contract addresses (from the indexed `dataSources`), endpoints (x402 + API-key), a per-subgraph starter query generated from the actual schema, pricing, and metadata. The `@context` + `@type` make the shape auto-discoverable. ```bash # Start the HTTP transport npx subgraph-registry-mcp --http-only # Fetch the manifest for Uniswap V3 Mainnet curl http://localhost:3848/.well-known/subgraph/5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV.jsonld ``` --- ## Semantic Search Every subgraph has a precomputed 384-dim embedding from `sentence-transformers/all-MiniLM-L6-v2`, built from its display name, description, canonical entities, top schema entity names, and protocol metadata. At MCP-tool-call time the Node server embeds the query string with the same model (via [@xenova/transformers](https://github.com/xenova/transformers.js), quantized ONNX bundled in the npm package — no first-call download) and ranks rows by cosine similarity. ```js const { subgraphs } = await mcp.call("semantic_search_subgraphs", { query: "lending positions near liquidation on a Layer 2", limit: 5, }); // subgraphs[i].semantic_score is cosine similarity in [0, 1]; >0.5 ~= strong match. ``` Use it when: - The goal is paraphrased or use-case-shaped (`search_subgraphs` is keyword-only). - You're exploring "what data exists for X?" rather than fetching a specific protocol's subgraph. Same model is shared between Python crawl-time (`fastembed`) and JS runtime (`@xenova/transformers`) — vectors are bitwise-comparable so cosine math gives consistent rankings across runtimes. Embeddings add ~22 MB to `registry.db` (14k × 384 × 4 bytes); model bundle adds ~23 MB to the npm package. --- ## Schema Evolution Each crawl computes a `schema_fingerprint` (MD5 of sorted `entity:field_count` pairs) per subgraph. Whenever the fingerprint changes from the previous sync, an immutable row is written to `schema_history`. The table is append-only and survives full DB rebuilds. ```js const history = await mcp.call("get_schema_changes", { subgraph_id: "5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV", }); // { // total_changes: 3, // stable_days: 47.2, // changed_within_24h: false, // changed_within_7d: false, // changes: [ // { fingerprint: "abc123...", prev_fingerprint: "def456...", detected_at: 1717... }, // ... // ] // }

Subgraph Registry MCP

Installation