An MCP server that powers AI agents with indexed blockchain data from The Graph.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"thegraph-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# TheGraph MCP Server An MCP server that powers AI agents with indexed blockchain data from [The Graph](https://thegraph.com/).    ## Available Tools ### 1. getSubgraphSchema Fetches the schema of a specified subgraph, providing AI agents with the context needed to generate GraphQL queries. **Parameters:** - `subgraphId`: The subgraph ID (e.g., "QmZBQcF...") - `asText`: Output format flag - `true`: Returns human-readable GraphQL schema - `false`: Returns JSON schema (default) ### 2. querySubgraph Executes GraphQL queries against a specified subgraph. While queries are typically generated by AI, you can also manually craft your own. **Parameters:** - `subgraphId`: The subgraph ID - `query`: GraphQL query string ## Installation 1. **Clone the Repository** ```bash git clone https://github.com/kukapay/thegraph-mcp.git ``` 2. **Client Configuration** ```json { "mcpServers": { "thegraph-mcp": { "command": "uv", "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"], "env": { "THEGRAPH_API_KEY": "your_api_key_here" } } } } ``` ## Example Prompts Here are some natural language prompts to trigger the tools: ### Schema Queries - "Show me the schema for subgraph QmZBQcF... in a readable format" - "What's the structure of the QmZBQcF... subgraph? Please display it in GraphQL format" - "I need to understand the data model of subgraph QmZBQcF..., can you fetch its schema?" ### Data Queries - "Find the top 5 tokens by trading volume in the last 24 hours from subgraph QmZBQcF..." - "Show me all pairs with liquidity greater than 1 million USD in subgraph QmZBQcF…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.