Subgraph Registry Mcp
Pre-indexed metadata for 15,000+ subgraphs on The Graph Network, giving agents domain classification, protocol type detection, and reliability scores without the usual 3-4 discovery tool calls. Exposes four MCP tools: search by domain/network/protocol, get natural language recommendations, fetch full subgraph detail, and list registry stats. Each result includes both legacy query URLs and x402 payment endpoints that accept $0.01 USDC on Base per query with no API key. Reliability scores combine query fees, volume, curation signal, and indexer allocations into a single 0-1 metric. Useful when building agents that need to query blockchain data through The Graph but don't want to crawl schemas and infer structure from scratch every time.
- tools
- 16
- transport
- STDIO
- last updated
- May 2, 2026
Tools
16 toolsPublic tool metadata for what this MCP can expose to an agent.
search_subgraphsFilter by domain, network, protocol type, entity, or keyword. Ranked by matched terms, reliability and real query_volume_30d.
Filter by domain, network, protocol type, entity, or keyword. Ranked by matched terms, reliability and real query_volume_30d.
No parameter schema in public metadata yet.
recommend_subgraphNatural language goal to best subgraphs (includes schema_stable_days)
Natural language goal to best subgraphs (includes schema_stable_days)
No parameter schema in public metadata yet.
semantic_search_subgraphsVector-similarity search over precomputed embeddings (sentence-transformers/all-MiniLM-L6-v2, 384-dim).
Vector-similarity search over precomputed embeddings (sentence-transformers/all-MiniLM-L6-v2, 384-dim).
No parameter schema in public metadata yet.
get_subgraph_detailFull classification for a specific subgraph (includes schema_changed_at and crawled contract_addresses)
Full classification for a specific subgraph (includes schema_changed_at and crawled contract_addresses)
No parameter schema in public metadata yet.
list_registry_statsRegistry overview (domains, networks, counts)
Registry overview (domains, networks, counts)
No parameter schema in public metadata yet.
get_schema_changesChronological schema-fingerprint history for a subgraph (one row per detected change).
Chronological schema-fingerprint history for a subgraph (one row per detected change).
No parameter schema in public metadata yet.
execute_query_by_subgraph_idPOST GraphQL to The Graph gateway. Same routing as official (subgraphs/id vs deployments/id). Requires THE_GRAPH_STUDIO_API_KEY (or GATEWAY_API_KEY).
POST GraphQL to The Graph gateway. Same routing as official (subgraphs/id vs deployments/id). Requires THE_GRAPH_STUDIO_API_KEY (or GATEWAY_API_KEY).
No parameter schema in public metadata yet.
execute_query_by_deployment_idPOST GraphQL to The Graph gateway. Same routing as official (subgraphs/id vs deployments/id). Requires THE_GRAPH_STUDIO_API_KEY (or GATEWAY_API_KEY).
POST GraphQL to The Graph gateway. Same routing as official (subgraphs/id vs deployments/id). Requires THE_GRAPH_STUDIO_API_KEY (or GATEWAY_API_KEY).
No parameter schema in public metadata yet.
execute_query_by_ipfs_hashPOST GraphQL to The Graph gateway. Same routing as official (subgraphs/id vs deployments/id). Requires THE_GRAPH_STUDIO_API_KEY (or GATEWAY_API_KEY).
POST GraphQL to The Graph gateway. Same routing as official (subgraphs/id vs deployments/id). Requires THE_GRAPH_STUDIO_API_KEY (or GATEWAY_API_KEY).
No parameter schema in public metadata yet.
execute_queryConvenience superset accepting id OR deployment_id OR ipfs_hash.
Convenience superset accepting id OR deployment_id OR ipfs_hash.
No parameter schema in public metadata yet.
get_schema_by_subgraph_idLocal registry_schema (entities, example_query, fingerprint) with no network when the subgraph is in the corpus; live __schema introspection only when a Studio key is set.
Local registry_schema (entities, example_query, fingerprint) with no network when the subgraph is in the corpus; live __schema introspection only when a Studio key is set.
No parameter schema in public metadata yet.
get_schema_by_deployment_idLocal registry_schema (entities, example_query, fingerprint) with no network when the subgraph is in the corpus; live __schema introspection only when a Studio key is set.
Local registry_schema (entities, example_query, fingerprint) with no network when the subgraph is in the corpus; live __schema introspection only when a Studio key is set.
No parameter schema in public metadata yet.
get_schema_by_ipfs_hashLocal registry_schema (entities, example_query, fingerprint) with no network when the subgraph is in the corpus; live __schema introspection only when a Studio key is set.
Local registry_schema (entities, example_query, fingerprint) with no network when the subgraph is in the corpus; live __schema introspection only when a Studio key is set.
No parameter schema in public metadata yet.
get_schemaConvenience superset for schema lookup.
Convenience superset for schema lookup.
No parameter schema in public metadata yet.
get_top_subgraph_deploymentsTop 3 from crawled manifests, ranked by reliability then real 30-day volume for a contract_address and chain.
Top 3 from crawled manifests, ranked by reliability then real 30-day volume for a contract_address and chain.
No parameter schema in public metadata yet.
get_deployment_30day_query_countsReal registry query_volume_30d for ipfs_hashes; unknown hashes return not_in_registry rather than a fake 0.
Real registry query_volume_30d for ipfs_hashes; unknown hashes return not_in_registry rather than a fake 0.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
Subgraph Registry
Discover published subgraphs on The Graph Network by chain, protocol, entity or contract, then prepare a bounded GraphQL starter.
The bundled snapshot contains 15,452 classified subgraph records. It is not a live directory of every subgraph: Studio-only deployments, dynamic contracts and later updates may be absent. Availability must be checked separately from ranking.
Start here: agents and MCP users
Share the canonical SKILL.md for the complete agent workflow.
-
Connect a pinned, published release (Node 20 is CI-tested):
{"mcpServers":{"subgraph-registry":{"command":"npx","args":["-y","subgraph-registry-mcp@0.13.2"]}}}
Details
- Repository
- github.com/paulieb14/subgraph-registry
- Package
subgraph-registry-mcp- Transport
- STDIO
- Registry
- MCP registry, active