TheGraph MCP Server

1# TheGraph MCP Server
2 
3An MCP server that powers AI agents with indexed blockchain data from [The Graph](https://thegraph.com/).
4 
5<a href="https://glama.ai/mcp/servers/@kukapay/thegraph-mcp">
6  <img width="380" height="200" src="https://glama.ai/mcp/servers/@kukapay/thegraph-mcp/badge" alt="TheGraph Server MCP server" />
7</a>
8 
9![GitHub License](https://img.shields.io/github/license/kukapay/thegraph-mcp) 
10![GitHub Last Commit](https://img.shields.io/github/last-commit/kukapay/thegraph-mcp) 
11![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
12 
13## Available Tools
14 
15### 1. getSubgraphSchema
16Fetches the schema of a specified subgraph, providing AI agents with the context needed to generate GraphQL queries. 
17 
18**Parameters:**
19- `subgraphId`: The subgraph ID (e.g., "QmZBQcF...")
20- `asText`: Output format flag
21  - `true`: Returns human-readable GraphQL schema
22  - `false`: Returns JSON schema (default)
23 
24### 2. querySubgraph
25Executes GraphQL queries against a specified subgraph. While queries are typically generated by AI, you can also manually craft your own.
26 
27**Parameters:**
28- `subgraphId`: The subgraph ID
29- `query`: GraphQL query string
30 
31 
32## Installation
33 
341. **Clone the Repository**
35    ```bash
36    git clone https://github.com/kukapay/thegraph-mcp.git
37    ```
382. **Client Configuration**
39    ```json
40    {
41      "mcpServers": {
42        "thegraph-mcp": {
43          "command": "uv",
44          "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
45          "env": {
46            "THEGRAPH_API_KEY": "your_api_key_here"
47          }
48        }
49      }
50    }
51    ```
52 
53## Example Prompts
54 
55Here are some natural language prompts to trigger the tools:
56 
57### Schema Queries
58- "Show me the schema for subgraph QmZBQcF... in a readable format"
59- "What's the structure of the QmZBQcF... subgraph? Please display it in GraphQL format"
60- "I need to understand the data model of subgraph QmZBQcF..., can you fetch its schema?"
61 
62### Data Queries
63- "Find the top 5 tokens by trading volume in the last 24 hours from subgraph QmZBQcF..."
64- "Show me all pairs with liquidity greater than 1 million USD in subgraph QmZBQcF..."
65- "Get the latest 10 swap events from the QmZBQcF... subgraph, including token symbols and amounts"
66 
67### Analysis Tasks
68- "Analyze the trading volume of USDT pairs in the last week using subgraph QmZBQcF..."
69- "Compare the liquidity of ETH and USDC pairs in subgraph QmZBQcF..."
70- "Find unusual trading patterns in the last 24 hours from subgraph QmZBQcF..."
71 
72### Combined Tasks
73- "First get the schema of QmZBQcF..., then help me write a query to find high-value transactions"
74- "Check the schema of QmZBQcF... and tell me what fields are available for querying token prices"
75- "Using subgraph QmZBQcF..., analyze the market impact of large trades by first understanding the schema and then querying relevant events"
76 
77## License
78This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.