MCP GraphQL Tools
GraphQL MCP server for AI assistants
What is MCP GraphQL Tools?
MCP GraphQL Tools is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to graphql mcp server for ai assistants
GraphQL MCP server for AI assistants
This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- GraphQL MCP server for AI assistants
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-graphql-toolsConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP GraphQL Tools
MCP GraphQL Tools is a lightweight MCP server that exposes two powerful tools for AI assistants: graphql_query for executing queries and mutations against any GraphQL endpoint, and graphql_introspect for exploring a schema. It supports custom headers, variables, per-request timeouts, and mutation control, making it practical for working with GitHub's API, Shopify, or any internal GraphQL service.
Prerequisites
- Node.js 16+ and npx available
- A GraphQL endpoint URL (local or remote)
- Any required authentication tokens or API keys for your GraphQL service
- Claude Desktop or another MCP-compatible client
Test the server with npx
Run the server directly via npx to confirm it starts correctly. Pass your target GraphQL endpoint with the --endpoint flag.
npx -y mcp-graphql-tools --endpoint https://api.github.com/graphqlConfigure Claude Desktop
Add the MCP server entry to your Claude Desktop config. The --endpoint flag sets the default endpoint; individual tool calls can override it per-request.
Pass authentication headers
For authenticated GraphQL APIs like GitHub, pass headers as a JSON string using the --headers flag. For GitHub, this is your Personal Access Token with the appropriate scopes.
Introspect the schema
Ask Claude to call graphql_introspect on your endpoint to explore the available types, queries, and mutations before writing queries.
Execute queries and analyze results
Ask Claude to use graphql_query with a natural language description of what data you need. Claude will construct the GraphQL query, execute it, and interpret the results.
MCP GraphQL Tools Examples
Client configuration
Claude Desktop config connecting to the GitHub GraphQL API with a personal access token in the headers.
{
"mcpServers": {
"graphql": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-tools",
"--endpoint=https://api.github.com/graphql",
"--headers={\"Authorization\":\"Bearer YOUR_GITHUB_TOKEN\"}"
]
}
}
}Prompts to try
Example prompts for interacting with GraphQL APIs through Claude.
- "Introspect the GitHub GraphQL schema and show me what queries are available"
- "Query my GitHub profile: login, name, and the 5 most recent repository names"
- "Find all open pull requests in the facebook/react repository with their titles and authors"
- "What fields does the Repository type have in this GraphQL schema?"Troubleshooting MCP GraphQL Tools
Queries return 401 Unauthorized from GitHub API
GitHub's GraphQL API requires authentication for all requests. Pass your Personal Access Token via --headers='{"Authorization":"Bearer YOUR_TOKEN"}' in the args array. The token needs at least the public_repo scope.
Complex queries fail with complexity threshold exceeded
The server has a default maxComplexity of 100. For deeply nested queries, increase the limit by adding --maxComplexity=500 to the args array in your config, or simplify the query by requesting fewer nested fields.
Mutations are blocked even with correct syntax
The graphql_query tool has an allowMutations parameter that defaults to false. When asking Claude to execute a mutation, instruct it explicitly to enable mutations for that call, or configure a default that permits them.
Frequently Asked Questions about MCP GraphQL Tools
What is MCP GraphQL Tools?
MCP GraphQL Tools is a Model Context Protocol (MCP) server that graphql mcp server for ai assistants It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP GraphQL Tools?
Follow the installation instructions on the MCP GraphQL Tools GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP GraphQL Tools?
MCP GraphQL Tools works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP GraphQL Tools free to use?
Yes, MCP GraphQL Tools is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP GraphQL Tools Alternatives โ Similar APIs Servers
Looking for alternatives to MCP GraphQL Tools? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
โ 43.4k๐ฆ The API and AI Gateway
API Mega List
โ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHubโperiod. ๐ช
Fetch
โ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
โ 2.1kSelf-Hosted API Management for Builders
Korean Law
โ 1.8k๊ตญ๊ฐ๋ฒ๋ น์ ๋ณดMCP v4.0 | ๋ฒ์ ์ฒ 41๊ฐ API โ 17๊ฐ MCP ๋๊ตฌ. ๋ฒ๋ นยทํ๋กยท์กฐ๋ก ๊ฒ์ + LLM ํ๊ฐ ๋ฐฉ์ง ์ธ์ฉ๊ฒ์ฆ + ์กฐ๋ฌธ ์ํฅ ๊ทธ๋ํ(impact_map) + ์์ ๋น๊ต ์๋ diff(time_travel) + ์๋ฏผ 5๋จ๊ณ ์คํ ๊ฐ์ด๋(action_plan) | 41 Korean legal APIs โ 17 MCP tools
RuleGo
โ 1.5kโ๏ธRuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP GraphQL Tools in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP GraphQL Tools?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.