mcp-graphql

Graphql MCP Server

mcp-graphql connects LLM clients to GraphQL APIs for schema discovery and query execution. It serves developers integrating GraphQL access into MCP workflows, with mutations disabled unless explicitly enabled.

Server facts

mcp-graphql

Project

Author
blurrah
License
MIT

Tech

Runtime / language
node
Transports
stdio
Remote available
No
Authentication
Not specified

Activity

GitHub stars
408
Last commit
Data as of

Tags

  • ai
  • llm
  • mcp
  • mcp server
  • modelcontextprotocol

Overview

GraphQL schema discovery comes before query execution in mcp-graphql’s tool workflow. An LLM client can inspect the API through the graphql-schema resource or request schema information with introspect-schema when that resource is not already available. Schema information can come from endpoint introspection, a local file, or a file hosted at a URL. With that context, query-graphql sends queries and their variables to the configured GraphQL endpoint. This gives developers a way to expose GraphQL APIs to model-driven clients through MCP.

Configuration uses environment variables for the endpoint, request headers, server name, optional schema source, and mutation setting. HEADERS accepts a JSON string, while SCHEMA selects a file path or URL as an alternative to introspection. Mutation operations remain disabled by default; enabling them requires setting ALLOW_MUTATIONS to true. The project documents both manual Claude configuration and installation for Claude Desktop through Smithery. It runs on Node, communicates over stdio, and uses the MIT license.

mcp-graphql setup notes

  • mcp-graphql records stdio only; confirm a network transport upstream before planning remote access.

Related MCP servers