list-query-fieldsLABSCO SUMMARY
A large schema becomes something the model can look things up in.
Shopify-sized SDL does not fit in a context window, and pasting a fragment leaves the model inventing fields. Listing first and fetching one field at a time keeps the lookups small enough to stay accurate.
What it is
A server that loads one GraphQL schema file and exposes it as navigable structure. Queries, mutations and subscriptions can be listed or fetched one field at a time; types can be looked up whole or by their fields; and everything is searchable by pattern. Internal GraphQL types are filtered out.
What you get
- Every query, mutation and subscription field, listed
- One field at a time in detail, with its type and arguments
- Every type in the schema, and any single type's definition
- A type's fields on their own, when the full definition is more than you need
- Pattern search across types and fields, for when you know part of a name
- Internal GraphQL introspection types filtered out of results
Requirements
A GraphQL schema file — the server takes its path as a command line argument and defaults to schema.graphqls in the working directory. Runs through npx with no install and no key. It reads a file, so it never touches your live API.
Setup effort
One command — npx -y mcp-graphql-schema
USE CASES
01
Finding the operation you need in an unfamiliar API
List the query fields, then pull the one that looks right with its arguments and return type.
02
Writing a mutation correctly the first time
Read the mutation's own definition and the input type behind it before drafting the call.
03
Chasing a name you only half remember
Search the schema by pattern and jump straight to the type that matches.
04
Checking what a type actually carries
Take just its fields, rather than the whole definition, when you only need to know what is selectable.
05
Seeing whether the API pushes updates
List the subscription fields and read the one you would subscribe to.
06
Auditing what a schema exposes for writes
List the mutation fields in one pass to see the full write surface.
10 tools
Listed in project docs. Your client may show a different list.
get-query-fieldlist-mutation-fieldsget-mutation-fieldlist-subscription-fieldsget-subscription-fieldlist-typesget-typeget-type-fieldssearch-schemaBEFORE YOU INSTALL
What to know first
Tools you get
10 tools named in the project's documentation.
Requires
npx on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y mcp-graphql-schemaMCP Clients
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"GraphQL Schema": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-schema",
"<YOUR_PATH_TO_SCHEMA>"
]
}
}
}<YOUR_PATH_TO_SCHEMA> is the full path of the GraphQL schema file you want Claude to explore.
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add graphql-schema -- npx -y mcp-graphql-schema <YOUR_PATH_TO_SCHEMA><YOUR_PATH_TO_SCHEMA> is the full path of the GraphQL schema file you want Claude to explore.
