
GraphQL Schema Model Context Protocol Server
GraphQL Schema Model Context Protocol Server
·
A Model Context Protocol (MCP) server that exposes GraphQL schema information to Large Language Models (LLMs) like Claude. This server allows an LLM to explore and understand GraphQL schemas through a set of specialized tools.
Run the MCP server with a specific schema file:
# Use the default schema.graphqls in current directory
npx -y mcp-graphql-schema
# Use a specific schema file (relative path)
npx -y mcp-graphql-schema ../schema.shopify.2025-01.graphqls
# Use a specific schema file (absolute path)
npx -y mcp-graphql-schema /absolute/path/to/schema.graphqls
# Show help
npx -y mcp-graphql-schema --helpTo install GraphQL Schema for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @hannesj/mcp-graphql-schema --client claudeTo use this MCP server with Claude Desktop, edit your claude_desktop_config.json configuration file:
{
"mcpServers": {
"GraphQL Schema": {
"command": "npx",
"args": ["-y", "mcp-graphql-schema", "/ABSOLUTE/PATH/TO/schema.graphqls"]
}
}
}Location of the configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json$env:AppData\Claude\claude_desktop_config.jsonTo use this MCP server with Claude Code CLI, follow these steps:
Add the GraphQL Schema MCP server to Claude Code
# Basic syntax
claude mcp add graphql-schema npx -y mcp-graphql-schema
# Example with specific schema
claude mcp add shopify-graphql-schema npx -y mcp-graphql-schema ~/Projects/work/schema.shopify.2025-01.graphqlsVerify the MCP server is registered
# List all configured servers
claude mcp list
# Get details for your GraphQL schema server
claude mcp get graphql-schemaRemove the server if needed
claude mcp remove graphql-schemaUse the tool in Claude Code
Once configured, you can invoke the tool in your Claude Code session by asking questions about the GraphQL schema.
Tips:
-s or --scope flag with project (default) or global to specify where the configuration is storedThe server provides the following tools for LLMs to interact with GraphQL schemas:
list-query-fields: Lists all available root-level fields for GraphQL queriesget-query-field: Gets detailed definition for a specific query field in SDL formatlist-mutation-fields: Lists all available root-level fields for GraphQL mutationsget-mutation-field: Gets detailed definition for a specific mutation field in SDL formatlist-subscription-fields: Lists all available root-level fields for GraphQL subscriptions (if present in schema)get-subscription-field: Gets detailed definition for a specific subscription field (if present in schema)list-types: Lists all types defined in the GraphQL schema (excluding internal types)get-type: Gets detailed definition for a specific GraphQL type in SDL formatget-type-fields: Gets a simplified list of fields with their types for a specific GraphQL object typesearch-schema: Searches for types or fields in the schema by name pattern (case-insensitive regex)Example queries to try:
What query fields are available in this GraphQL schema?
Show me the details of the "user" query field.
What mutation operations can I perform in this schema?
List all types defined in this schema.
Show me the definition of the "Product" type.
List all fields of the "Order" type.
Search for types and fields related to "customer".Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add GraphQL Schema -- npx -y mcp-graphql-schema /ABSOLUTE/PATH/TO/schema.graphqls{
"mcpServers": {
"GraphQL Schema": {
"args": [
"-y",
"mcp-graphql-schema",
"/ABSOLUTE/PATH/TO/schema.graphqls"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"GraphQL Schema","args":["-y","mcp-graphql-schema","/ABSOLUTE/PATH/TO/schema.graphqls"],"command":"npx"}'[mcp_servers.GraphQL Schema]
command = "npx"
args = ["-y", "mcp-graphql-schema", "/ABSOLUTE/PATH/TO/schema.graphqls"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/mcp-graphql-schema to learn what the "Mcp Graphql Schema" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx -y mcp-graphql-schema
npx -y mcp-graphql-schema ../schema.shopify.2025-01.graphqls
npx -y mcp-graphql-schema /absolute/path/to/schema.graphqls
npx -y mcp-graphql-schema --help
npx -y @smithery/cli install @hannesj/mcp-graphql-schema --client claudeclaude mcp add graphql-schema npx -y mcp-graphql-schemaThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its npm package has not answered in our offline sandbox, which usually means it needs an API key or other configuration to start. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/mcp-graphql-schema)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "mcp-graphql-schema" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.