Thegraph MCP

🚀 TheGraph MCP Server

An AI agent server powered by blockchain indexed data, utilizing subgraph data from The Graph.

🚀 Quick Start

The TheGraph MCP Server is an AI agent server that leverages blockchain indexed data, specifically subgraph data from The Graph. It provides useful tools for querying subgraphs and obtaining relevant information.

✨ Features

1. Get Subgraph Schema

Retrieve the schema of a specified subgraph, providing the context required for the AI agent to generate GraphQL queries.

Parameters:

• subgraphId: Subgraph ID (e.g., "QmZBQcF...")
• asText: Output format flag
  • true: Return a human-readable GraphQL schema
  • false: Return a JSON schema (default)

2. Query Subgraph

Execute a GraphQL query on a specified subgraph. Although queries are typically generated automatically by the AI, you can also write them manually.

Parameters:

• subgraphId: Subgraph ID
• query: GraphQL query string

📦 Installation

1. Clone the Repository

git clone https://github.com/kukapay/thegraph-mcp.git

2. Client Configuration

{
  "mcpServers": {
    "thegraph-mcp": {
      "command": "uv",
      "args": ["--directory", "path/to/thegraph-mcp", "run", "main.py"],
      "env": {
        "THEGRAPH_API_KEY": "your_api_key_here"
      }
    }
  }
}

💻 Usage Examples

Example Prompts

Here are some natural language examples to trigger the tools:

Schema Query

• "Show the schema of subgraph QmZBQcF... in a readable format."
• "Please display the structure of subgraph QmZBQcF... in GraphQL format."
• "I need to understand the data model of subgraph QmZBQcF... Please help me obtain its schema."

Data Query

• "Find the top 5 tokens by trading volume in the past 24 hours from subgraph QmZBQcF..."
• "Show all pairs with liquidity over $1 million from subgraph QmZBQcF..."
• "Get the latest 10 swap events from subgraph QmZBQcF..., including token symbols and amounts."

Analysis Task

• "Analyze the trading volume of USDT pairs in the past week using subgraph QmZBQcF..."
• "Compare the liquidity of ETH and USDC pairs from subgraph QmZBQcF..."
• "Find abnormal trading patterns in the past 24 hours from subgraph QmZBQcF..."

Comprehensive Task

• "First, get the schema of subgraph QmZBQcF..., then help me write a query for high-value trades."
• "Check the schema of subgraph QmZBQcF... and tell me the fields available for querying token prices."
• "Use subgraph QmZBQcF... to analyze the market impact of large trades. First, understand the schema and then query relevant events."

📄 License

This project is licensed under the MIT License. For more details, please refer to the LICENSE file.