{
  "markdown": "# Subgraph MCP Skills\n\n> **Give your AI agents access to 15,000+ blockchain subgraphs through natural language**\n\nThis repository provides comprehensive documentation and skills for integrating [The Graph's](https://thegraph.com/) Subgraph MCP (Model Context Protocol) into AI agents. Query blockchain data conversationally without writing GraphQL.\n\n## What is Subgraph MCP?\n\nSubgraph MCP is an open-source implementation of [Anthropic's Model Context Protocol](https://modelcontextprotocol.io/) that connects AI assistants to The Graph's decentralized data network. It enables:\n\n- **Schema Discovery** - Access GraphQL schemas for any subgraph on The Graph Network\n- **Query Execution** - Run GraphQL queries on any subgraph deployment\n- **Subgraph Search** - Find subgraphs by keyword or contract address\n- **Usage Analytics** - Retrieve 30-day query volumes for deployments\n- **Natural Language** - Ask questions about blockchain data without writing GraphQL\n\n## Quick Start\n\n### Need Help? Let an AI Agent Set It Up!\n\nIf you're not sure how to configure MCP, just ask your AI assistant:\n\n```\n\"Help me set up Subgraph MCP\"\n```\n\nThe agent can walk you through the entire setup process interactively, including getting your API key and configuring your client. See [Agent-Assisted Setup](docs/agent-setup.md) for how this works.\n\n### Manual Setup\n\n#### 1. Get Your API Key\n\n1. Go to [Subgraph Studio](https://thegraph.com/studio/)\n2. Connect your wallet (MetaMask, Coinbase Wallet, WalletConnect, or Safe)\n3. Navigate to **API Keys** tab\n4. Click **Create API Key**\n5. Name your key and save it securely\n\n> See [Getting API Keys](docs/getting-api-keys.md) for detailed instructions.\n\n#### 2. Configure Your AI Client\n\nChoose your AI client and follow the setup guide:\n\n| Client | Guide | Config File |\n|--------|-------|-------------|\n| Claude Desktop | [Setup Guide](docs/claude-desktop.md) | `claude_desktop_config.json` |\n| Claude Code (CLI) | [Setup Guide](docs/claude-code.md) | `~/.claude/settings.json` |\n| Cursor | [Setup Guide](docs/cursor.md) | `~/.cursor/mcp.json` |\n| Cline | [Setup Guide](docs/cline.md) | `cline_mcp_settings.json` |\n| OpenClaw | [Setup Guide](docs/openclaw.md) | `~/.openclaw/openclaw.json` |\n\n#### 3. Basic Configuration\n\nAdd this to your MCP config file (replace `YOUR_API_KEY`):\n\n```json\n{\n  \"mcpServers\": {\n    \"subgraph\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"--header\",\n        \"Authorization:${AUTH_HEADER}\",\n        \"https://subgraphs.mcp.thegraph.com/sse\"\n      ],\n      \"env\": {\n        \"AUTH_HEADER\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n## Subgraph MCP Server\n\n**Endpoint:** `https://subgraphs.mcp.thegraph.com/sse`\n\n**Authentication:** Gateway API Key from [Subgraph Studio](https://thegraph.com/studio/)\n\n**Access:** 15,000+ subgraphs covering DeFi, NFTs, DAOs, governance, and more\n\n### Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_schema` | Retrieve GraphQL schema by deployment ID, Subgraph ID, or IPFS hash |\n| `execute_query` | Run GraphQL queries against any subgraph deployment |\n| `search_subgraphs` | Find subgraphs by keyword or contract address |\n| `get_subgraph_info` | Get metadata and deployment details |\n| `get_query_volume` | Retrieve 30-day query statistics |\n\n## Querying Subgraphs\n\n### You Don't Need to Know Deployment IDs!\n\nJust describe what you want in natural language:\n\n```\n\"Find Uniswap subgraphs and show me the top pools\"\n\"Search for lending protocol subgraphs\"\n\"What subgraphs track ENS domains?\"\n```\n\nThe AI will search The Graph Network and find the right subgraph for you.\n\n### Or Use Specific Deployment IDs (Optional)\n\nFor precise control, you can specify a deployment ID:\n\n```\n\"Query subgraph 5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV for top 10 pools\"\n```\n\nSee [Popular Subgraphs](docs/popular-subgraphs.md) for common deployment IDs.\n\n### Example Queries\n\n```\n\"What are the top Uniswap V3 pools by volume?\"\n\n\"Show me the GraphQL schema for the ENS subgraph\"\n\n\"Find subgraphs related to Aave lending protocol\"\n\n\"What's the 30-day query volume for the Compound subgraph?\"\n\n\"Search for subgraphs that index contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984\"\n```\n\nSee [Example Queries](examples/queries.md) for 100+ more examples.\n\n## AI Agent Skills\n\nThis repo includes skill definitions for integrating subgraph capabilities into AI agent frameworks:\n\n- [Subgraph Skills](skills/subgraph-skills.md) - Core skill definitions and prompts\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [Agent-Assisted Setup](docs/agent-setup.md) | Let an AI agent configure MCP for you |\n| [Getting API Keys](docs/getting-api-keys.md) | How to obtain and manage API keys |\n| [Popular Subgraphs](docs/popular-subgraphs.md) | Common subgraph deployment IDs |\n| [Claude Desktop Setup](docs/claude-desktop.md) | Configure Claude Desktop app |\n| [Claude Code Setup](docs/claude-code.md) | Configure Claude Code CLI |\n| [Cursor Setup](docs/cursor.md) | Configure Cursor IDE |\n| [Cline Setup](docs/cline.md) | Configure Cline extension |\n| [OpenClaw Setup](docs/openclaw.md) | Configure OpenClaw multi-channel assistant |\n| [Troubleshooting](docs/troubleshooting.md) | Common issues and solutions |\n\n## Prerequisites\n\n- **Node.js 18+** installed and in your PATH (Node 22+ for OpenClaw)\n- **npx** or **bunx** available\n- **Wallet** for signing into Subgraph Studio (MetaMask, etc.)\n- **AI Client** - Claude Desktop, Claude Code, Cursor, Cline, or OpenClaw\n\n## Security Best Practices\n\n- Store API keys in environment variables, never hardcode\n- Use domain restrictions in Subgraph Studio\n- Set spending limits on API keys\n- Regenerate keys if compromised\n\n## Resources\n\n- [The Graph Documentation](https://thegraph.com/docs/)\n- [AI Suite Introduction](https://thegraph.com/docs/en/ai-suite/ai-introduction/)\n- [Subgraph MCP Source Code](https://github.com/graphops/subgraph-mcp)\n- [Subgraph Studio](https://thegraph.com/studio/)\n- [Graph Explorer](https://thegraph.com/explorer/)\n- [MCP Protocol Spec](https://modelcontextprotocol.io/)\n- [OpenClaw](https://github.com/openclaw/openclaw)\n\n## Contributing\n\nContributions welcome! Please open an issue or PR.\n\n## License\n\nMIT\n",
  "bytes": 6232,
  "sha": "aa86d2371350d308d2db00fb5d6bf1cb518385a3db6c931effa6cca35549baa1",
  "repo_slug": "paulieb14/subgraph-mcp-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_paulieb14_subgraph_mcp_skills_subgraph_m_5cceed47/readme"
}