introspect-schema
Introspect the GraphQL schema, use this tool before doing a query to get the schema information if you do not have it available as a resource already.
LABSCO SUMMARY
An unfamiliar API becomes queryable in two calls.
The order carries the value: introspect-schema first so the types and fields are known, then query-graphql with the document and its variables. There are no per-operation tools and no query builder — one call sends whatever you pass — so the schema is what constrains the model, and whatever guards the endpoint sits outside this server.
What it is
Two tools over one GraphQL endpoint — schema introspection, and query execution.
What you get
- Full schema introspection, meant to run before the first query when the schema is not already loaded as a resource
- Queries executed against the endpoint with their variables passed alongside
Requirements
A GraphQL endpoint the server can reach, and a Node runtime. The server itself takes no credentials.
Setup effort
One command — npx -y mcp-graphql
USE CASES
01
Exploring an API you were handed only a URL for
Introspect the schema first so the types, fields and arguments are known, then send a query built against what came back rather than against a guess.
02
Confirming a schema change reached the deployed endpoint
Introspection answers from the endpoint itself, so a field that is missing there is missing in the deployment, whatever the branch says.
03
Pulling one record while you are debugging something else
A single query with its variables, without opening a client or writing a fetch — useful when the question is what the API returns for this ID, right now.
2 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
query-graphql
Query a GraphQL endpoint with the given query and variables
BEFORE YOU INSTALL
What to know first
Tools you get
2 tools when we connected.
Requires
npx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 2 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"mcp-graphql": {
"command": "npx",
"args": [
"-y",
"mcp-graphql"
]
}
}
}npx
TERMINAL
npx -y mcp-graphql
