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
The schema is discovered, so you do not have to describe the API first.
Introspect, then query: the assistant learns the types on its own and writes against them rather than against your summary of them. Writes stay behind a launch flag, so read-only is the default state rather than something you set up.
What it is
An MCP server for GraphQL APIs. It introspects the endpoint you pass on --endpoint, or reads a local schema file, exposes that schema as a resource named graphql-schema, and executes queries against the service.
What you get
- The endpoint schema retrieved, by introspection or from a local .graphql file
- Queries executed against the endpoint, with results returned
- The schema also available to the client as a resource
- Custom headers passed at launch, so authenticated APIs work
- Mutations available only when the server is started with --enable-mutations
Requirements
Node with npx, and the endpoint URL — it falls back to a local GraphQL endpoint when you do not give one. Any authorization token goes in the headers option at launch, as a JSON string.
Setup effort
One command — npx -y @kailashg101/graphql-mcp-toolkit
USE CASES
01
Exploring an API nobody documented
Introspect the endpoint and read the types back, which is faster than asking whoever built it.
02
Getting an answer out of a GraphQL service
Read the schema, then run the query the question needs against the live endpoint.
03
Querying an endpoint that needs a token
Pass the authorization header at launch and query as an authenticated caller.
04
Working from a schema file while the service is down
Load the local .graphql file for schema questions, and query when the endpoint comes back.
05
Making a change through the API
Run a mutation, which requires the server to have been started with --enable-mutations.
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": {
"graphql-mcp-toolkit": {
"command": "npx",
"args": [
"-y",
"@kailashg101/graphql-mcp-toolkit"
]
}
}
}npx
TERMINAL
npx -y @kailashg101/graphql-mcp-toolkit
