The Graph

liveCryptoDeveloper

GraphQL queries against indexed blockchain subgraphs (Uniswap, Aave, ENS, NFTs, etc.). Requires your own The Graph API key (_apiKey) — free 100k queries/mo after Graph Studio signup.

2tools
0msauth
free tier50 calls/day
🔑Authentication

BYO only. The Graph requires an API key from Graph Studio (free 100k queries/month). Pass it as _apiKey on the gateway URL.

Config with credentials

Get an API key →

Tools

query_subgraphrequired: subgraph_id, query

Run a GraphQL query against a subgraph on The Graph network. subgraph_id is the deployment hash (starts with "Qm…" or the new "0x…" subgraph ID from thegraph.com/explorer). Returns the GraphQL `data`

Parameters
NameTypeDescription
subgraph_idreqstringSubgraph deployment ID
queryreqstringGraphQL query string
variablesoptobjectOptional variables object
▶Try it
introspect_schemarequired: subgraph_id

Fetch a subgraph's GraphQL schema via standard introspection. Returns types, fields, and arguments so an agent can build queries without external docs. Requires your own The Graph API key, passed as _

Parameters
NameTypeDescription
subgraph_idreqstringSubgraph deployment ID
▶Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/the-graph/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/the-graph/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"query_subgraph","arguments":{"subgraph_id": "example", "query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("query_subgraph", {"subgraph_id":"example","query":"example"});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("graphql queries against indexed blockchain subgraphs (uniswap, aave, ens, nfts, etc");