blurrah avatar

MCP GraphQL Server

blurrah/mcp-graphql

Mcp Graphql enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities. The server offers two main tools: introspect-schema for retrieving GraphQL schemas from local files, URLs, or introspection queries, and query-graphql for executing GraphQL queries against a specified endpoint. It solves the problem of allowing language models to dynamically discover and use GraphQL APIs without hardcoded knowledge of their structure.

GitHub stars
385
tools
2
last updated
Mar 8, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

introspect-schemaThis tool retrieves the GraphQL schema. Use this first if you don't have access to the schema as a resource.

This tool retrieves the GraphQL schema. Use this first if you don't have access to the schema as a resource.

No parameter schema in public metadata yet.

query-graphqlExecute GraphQL queries against the endpoint. By default, mutations are disabled unless `ALLOW_MUTATIONS` is set to `true`.

Execute GraphQL queries against the endpoint. By default, mutations are disabled unless `ALLOW_MUTATIONS` is set to `true`.

No parameter schema in public metadata yet.

Sponsors

Readme

mcp-graphql

smithery badge

A Model Context Protocol server that enables LLMs to interact with GraphQL APIs. This implementation provides schema introspection and query execution capabilities, allowing models to discover and use GraphQL APIs dynamically.

mcp-graphql MCP server

Usage

Run mcp-graphql with the correct endpoint, it will automatically try to introspect your queries.

Environment Variables (Breaking change in 1.0.0)

Note: As of version 1.0.0, command line arguments have been replaced with environment variables.


View the full README on GitHub

Details

Repository
github.com/blurrah/mcp-graphql