MCP GraphQL Schema
A MCP server that exposes GraphQL schema information to LLMs like Claude. This server allows an LLM to explore and understand large GraphQL schemas through a set of specialized tools, without needing to load the whole schema into the context
What is MCP GraphQL Schema?
MCP GraphQL Schema is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server that exposes graphql schema information to llms like claude. this server allows an llm to explore and understand large graphql schemas through a set of specialized tools, without needing to...
A MCP server that exposes GraphQL schema information to LLMs like Claude. This server allows an LLM to explore and understand large GraphQL schemas through a set of specialized tools, without needing to load the whole schema into the context
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A MCP server that exposes GraphQL schema information to LLMs
Use Cases
Maintainer
Works with
Installation
NPM
npx -y mcp-graphql-schemaManual Installation
npx -y mcp-graphql-schemaConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP GraphQL Schema
mcp-graphql-schema is an MCP server that makes large GraphQL schemas navigable by AI assistants without stuffing the entire schema into the context window. It exposes a suite of tools for listing query fields, mutation fields, subscription fields, types, and their field definitions, plus a regex-powered search across the whole schema. Developers working on complex GraphQL APIs can ask Claude to explore the schema, find the right type, and draft queries — all without copy-pasting schema SDL into the chat.
Prerequisites
- Node.js 18 or later installed
- npx available (ships with Node.js)
- A GraphQL schema file in SDL format (.graphqls or .graphql) on disk
- An MCP client such as Claude Desktop or the Claude Code CLI
Obtain your GraphQL schema file
Export your schema as SDL from your GraphQL server. Most servers expose an introspection endpoint you can dump with a tool like graphql-inspector or rover.
# Example using graphql-inspector
npx graphql-inspector introspect http://localhost:4000/graphql --write schema.graphqlsTest the server locally
Run the MCP server directly with npx, passing the absolute path to your schema file as the first argument.
npx -y mcp-graphql-schema /absolute/path/to/schema.graphqlsConfigure Claude Desktop
Add the server to your Claude Desktop configuration file. The schema file path is passed as an argument — use the absolute path.
{
"mcpServers": {
"graphql-schema": {
"command": "npx",
"args": ["-y", "mcp-graphql-schema", "/absolute/path/to/schema.graphqls"]
}
}
}Configure via Claude Code CLI (alternative)
If you use the Claude Code CLI instead of Claude Desktop, register the server with the mcp add command.
claude mcp add graphql-schema npx -y mcp-graphql-schema ~/path/to/schema.graphqlsRestart Claude Desktop and verify
Fully quit and relaunch Claude Desktop. Open a new chat and ask Claude to list the available query fields — it should return results from your schema.
MCP GraphQL Schema Examples
Client configuration
Claude Desktop config for exploring a GraphQL schema stored at /projects/myapp/schema.graphqls.
{
"mcpServers": {
"graphql-schema": {
"command": "npx",
"args": ["-y", "mcp-graphql-schema", "/projects/myapp/schema.graphqls"]
}
}
}Prompts to try
Example questions you can ask Claude once the GraphQL schema server is connected.
- "List all available query fields in this GraphQL schema"
- "Show me the fields on the User type"
- "What mutations are available and what arguments do they take?"
- "Search the schema for anything related to 'payment'"
- "Draft a GraphQL query to fetch a user's profile and their recent orders"Troubleshooting MCP GraphQL Schema
Server exits immediately with 'cannot find schema file'
The path argument must be an absolute path to the .graphqls or .graphql file. Relative paths are not resolved from the MCP server's working directory. Double-check with 'ls /absolute/path/to/schema.graphqls'.
Schema file parses but some types are missing
Ensure the schema file is a complete SDL dump including all types, not just the root query/mutation/subscription types. Re-export from your GraphQL server using introspection to get the full schema.
npx takes a long time to start on first run
npx downloads the package on the first invocation. Subsequent starts are faster. You can pre-install globally with 'npm install -g mcp-graphql-schema' and then use 'mcp-graphql-schema' as the command instead of npx.
Frequently Asked Questions about MCP GraphQL Schema
What is MCP GraphQL Schema?
MCP GraphQL Schema is a Model Context Protocol (MCP) server that mcp server that exposes graphql schema information to llms like claude. this server allows an llm to explore and understand large graphql schemas through a set of specialized tools, without needing to load the whole schema into the context It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP GraphQL Schema?
Install via npm with the command: npx -y mcp-graphql-schema. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with MCP GraphQL Schema?
MCP GraphQL Schema works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP GraphQL Schema free to use?
Yes, MCP GraphQL Schema is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
MCP GraphQL Schema Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCP GraphQL Schema? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP GraphQL Schema 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 Schema?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.