{"id":122487,"date":"2025-12-23T06:17:35","date_gmt":"2025-12-23T06:17:35","guid":{"rendered":"https:\/\/mycryptomania.com\/?p=122487"},"modified":"2025-12-23T06:17:35","modified_gmt":"2025-12-23T06:17:35","slug":"talk-to-15000-subgraphs-setting-up-subgraph-mcp-in-cursor-or-claude-desktop","status":"publish","type":"post","link":"https:\/\/mycryptomania.com\/?p=122487","title":{"rendered":"Talk to 15,000+ Subgraphs: Setting Up Subgraph MCP in Cursor or Claude Desktop"},"content":{"rendered":"

If you\u2019ve ever wanted to ask blockchain data questions in plain English <\/em>without worrying about GraphQL syntax, query limits, or which subgraph to use, know Subgraph MCP is the missing\u00a0piece.<\/p>\n

In this guide, you\u2019ll learn how\u00a0to:<\/p>\n

Get an API key from The Graph MarketplaceConfigure Subgraph MCP in Cursor<\/strong> or Claude\u00a0Desktop<\/strong>Understand how this unlocks ~15,000 subgraphs for natural\u2011language querying<\/p>\n

No custom queries. No rate\u2011limit anxiety. Just ask questions.<\/p>\n

What is Subgraph\u00a0MCP?<\/h3>\n

Subgraph MCP<\/a> (Model Context Protocol) lets large language models (LLMs) reason about and query subgraphs on your\u00a0behalf<\/em>.<\/p>\n

Instead of writing GraphQL yourself, you:<\/p>\n

Ask a question in natural\u00a0languageThe LLM selects the best subgraph or you can ask it to use a subgraph based on deployment IDIt generates and runs the query. It reads the schema to know what content each subgraph\u00a0has.You get structured results\u00a0back<\/p>\n

All powered by The Graph\u2019s decentralized data\u00a0layer.<\/p>\n

Why Subgraph MCP\u00a0Matters<\/h3>\n

Without MCP:<\/p>\n

You must know which subgraph<\/strong> to use. This requires a lot of filtering and searching.You must write correct GraphQL\u00a0query.<\/strong>You must manage API limits and\u00a0errors.<\/strong><\/p>\n

With Subgraph\u00a0MCP:<\/p>\n

One API key gives access to ~15,000 subgraphs<\/strong>The LLM chooses the right schema automaticallyQueries are handled safely and efficientlyYou focus on questions<\/em>, not infrastructure<\/p>\n

This is what makes \u201cchatting with blockchain data\u201d actually practical.<\/p>\n

Step 1: Get an API Key from The Graph Marketplace<\/h3>\n

Subgraph MCP uses an API\u00a0key.<\/p>\n

1. Create an API Key with The\u00a0Graph<\/h3>\n

https:\/\/medium.com\/media\/376d9fbba1e2db2c1dafd44cc9b99c05\/href<\/a><\/p>\n

\u26a0\ufe0f Treat this like a password. Anyone with this token can query on your\u00a0behalf.<\/p>\n

Step 2: Download\u00a0Cursor<\/h3>\n

Graph Docs<\/strong><\/p>\n

https:\/\/thegraph.com\/docs\/en\/ai-suite\/subgraph-mcp\/cursor\/<\/a><\/p>\n

Cursor Quickstart docs<\/strong><\/p>\n

https:\/\/cursor.com\/docs\/get-started\/quickstart<\/a><\/p>\n

Step 3. Configure Subgraph MCP in\u00a0Cursor<\/h3>\n

Head to settings:<\/p>\n

Click on Tools and\u00a0MCPs:<\/p>\n

Cursor supports MCP via a simple JSON\u00a0config.<\/h4>\n

Paste the following JSON and replace Bearer GATEWAY_API_Key<\/p>\n

*use your API Key from\u00a0above<\/p>\n

{
“mcpServers”: {
“subgraph”: {
“command”: “npx”,
“args”: [“mcp-remote”, “–header”, “Authorization:${AUTH_HEADER}”, “https:\/\/subgraphs.mcp.thegraph.com\/sse”],
“env”: {
“AUTH_HEADER”: “Bearer GATEWAY_API_KEY”
}
}
}
}<\/p>\n

Step 4. Save and Restart\u00a0Cursor<\/h3>\n

Once enabled, Cursor can\u00a0now:<\/p>\n

Discover subgraph\u00a0schemasGenerate queries automaticallyExecute them\u00a0securely<\/p>\n

Configure Subgraph MCP in Claude\u00a0Desktop<\/h3>\n

Claude Desktop uses the same MCP concept with a local config\u00a0file.<\/p>\n

Graph Docs for\u00a0Claude<\/strong><\/p>\n

https:\/\/thegraph.com\/docs\/en\/ai-suite\/subgraph-mcp\/claude\/<\/a><\/p>\n

1. Install Claude\u00a0Desktop<\/h3>\n

https:\/\/medium.com\/media\/05df3b28f86791fefa297db1aeb48254\/href<\/a><\/p>\n

2. Add the Subgraph MCP\u00a0Server<\/h3>\n

Paste the following JSON and replace Bearer GATEWAY_API_Key<\/p>\n

*use your API Key from\u00a0above<\/p>\n

{
“mcpServers”: {
“subgraph”: {
“command”: “npx”,
“args”: [“mcp-remote”, “–header”, “Authorization:${AUTH_HEADER}”, “https:\/\/subgraphs.mcp.thegraph.com\/sse”],
“env”: {
“AUTH_HEADER”: “Bearer GATEWAY_API_KEY”
}
}
}
}https:\/\/medium.com\/media\/5d8398ebce74de2ba11bd7f9c4c976b5\/href<\/a><\/p>\n

3. Restart Claude\u00a0Desktop<\/h3>\n

Claude will now be able\u00a0to:<\/p>\n

Inspect thousands of subgraph\u00a0schemasChoose the correct one automaticallyRun queries safely on your\u00a0behalfhttps:\/\/medium.com\/media\/aa414b5222748ce81b82969ed63e520c\/href<\/a><\/p>\n

What You Can Ask Once It\u2019s Set\u00a0Up<\/h3>\n

After setup, you can ask questions like:<\/p>\n

\u201cWhat was Uniswap v3 volume on Base yesterday?\u201d\u201cShow me the top token holders for this\u00a0ERC\u201120.\u201d\u201cHow many users interacted with this contract last\u00a0week?\u201d\u201cWhat\u2019s the TVL change for this protocol over 30\u00a0days?\u201d<\/p>\n

You don\u2019t need\u00a0to:<\/p>\n

Know the subgraph\u00a0nameKnow the deployment ID (it does help to point AI to deployment ID).Write queries<\/p>\n

The LLM handles all of\u00a0it.<\/p>\n

Final Thoughts<\/h3>\n

Subgraph MCP turns The Graph into a conversational data\u00a0layer.<\/p>\n

With a single question:<\/p>\n

You unlock ~15,000 subgraphsYou eliminate boilerplate queriesYou let LLMs do what they\u2019re good at: reasoning<\/p>\n

If you\u2019re building dashboards, bots, research tools, or just exploring on\u2011chain data this is the fastest path from question<\/em> to\u00a0answer<\/em>.<\/p>\n

Talk to 15,000+ Subgraphs: Setting Up Subgraph MCP in Cursor or Claude Desktop<\/a> was originally published in Coinmonks<\/a> on Medium, where people are continuing the conversation by highlighting and responding to this story.<\/p>","protected":false},"excerpt":{"rendered":"

If you\u2019ve ever wanted to ask blockchain data questions in plain English without worrying about GraphQL syntax, query limits, or which subgraph to use, know Subgraph MCP is the missing\u00a0piece. In this guide, you\u2019ll learn how\u00a0to: Get an API key from The Graph MarketplaceConfigure Subgraph MCP in Cursor or Claude\u00a0DesktopUnderstand how this unlocks ~15,000 subgraphs […]<\/p>\n","protected":false},"author":0,"featured_media":122488,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-122487","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-interesting"],"_links":{"self":[{"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/posts\/122487"}],"collection":[{"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=122487"}],"version-history":[{"count":0,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/posts\/122487\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=\/wp\/v2\/media\/122488"}],"wp:attachment":[{"href":"https:\/\/mycryptomania.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=122487"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=122487"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mycryptomania.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=122487"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}