MCP Graphql Schema MCP Server

Model Context Protocol server for GraphQL schemas

Local serverstdio

What is the MCP Graphql Schema MCP server?

Model Context Protocol server for GraphQL schemas. Exposed over MCP by the mcp graphql schema mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

What it actually does

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.

  • Load any GraphQL schema file specified via command line argument
  • Explore query, mutation, and subscription fields
  • Look up detailed type definitions
  • Search for types and fields using pattern matching
  • Get simplified field information including types and arguments
  • Filter out internal GraphQL types for cleaner results

Adding it to your client

The server ships on npm as mcp-graphql-schema, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Its toolset

Everything the assistant can do here goes through one of these:

  • list-query-fields — Lists all available root-level fields for GraphQL queries
  • get-query-field — Gets detailed definition for a specific query field in SDL format
  • list-mutation-fields — Lists all available root-level fields for GraphQL mutations
  • get-mutation-field — Gets detailed definition for a specific mutation field in SDL format
  • list-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 format
  • get-type-fields — Gets a simplified list of fields with their types for a specific GraphQL object type
  • search-schema — Searches for types or fields in the schema by name pattern (case-insensitive regex)

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch MCP Graphql Schema.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mcp graphql schema mcp server does with a few real requests.

When to reach for it

This sits in the payments and commerce group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. MCP Graphql Schema's toolset — list-query-fields, get-query-field, list-mutation-fields and 7 more — is a fair guide to whether it matches your workflow. It is maintained by hannesj; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
list-query-fieldsLists all available root-level fields for GraphQL queries
get-query-fieldGets detailed definition for a specific query field in SDL format
list-mutation-fieldsLists all available root-level fields for GraphQL mutations
get-mutation-fieldGets detailed definition for a specific mutation field in SDL format
list-subscription-fieldsLists all available root-level fields for GraphQL subscriptions (if present in schema)
get-subscription-fieldGets detailed definition for a specific subscription field (if present in schema)
list-typesLists all types defined in the GraphQL schema (excluding internal types)
get-typeGets detailed definition for a specific GraphQL type in SDL format
get-type-fieldsGets a simplified list of fields with their types for a specific GraphQL object type
search-schemaSearches for types or fields in the schema by name pattern (case-insensitive regex)

How to install the MCP Graphql Schema MCP server

{
  "mcpServers": {
    "graphql-schema": {
      "command": "npx",
      "args": ["-y", "mcp-graphql-schema"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use MCP Graphql Schema to list-query-fields.
  • Use MCP Graphql Schema to get-query-field.
  • Use MCP Graphql Schema to list-mutation-fields.

Frequently asked questions

It connects MCP Graphql Schema to MCP-compatible AI assistants such as Claude and Cursor, exposing 10 tools (list-query-fields, get-query-field, list-mutation-fields, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Graphql Schema directly.