mcp-graphql
@blurrah
About mcp-graphql
Model Context Protocol server for GraphQL
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"mcp-graphql": {
"command": "npx",
"args": [
"mcp-graphql"
],
"env": {
"ENDPOINT": "http://localhost:3000/graphql"
}
}
}
}Tools
No tools detected
Fetch the live tool list by running this server in a temporary sandbox using the button above.
Overview
What is mcp-graphql?
mcp-graphql is a Model Context Protocol (MCP) server that enables LLMs to interact with GraphQL APIs. It provides schema introspection and query execution capabilities, allowing models to dynamically discover and use any GraphQL endpoint.
How to use mcp-graphql?
Set environment variables (ENDPOINT, HEADERS, ALLOW_MUTATIONS, NAME, SCHEMA) and run npx mcp-graphql. The server automatically introspects the schema and exposes tools for querying. It can be installed via Smithery or configured manually for Claude Desktop.
Key features of mcp-graphql
- Schema introspection via
introspect-schematool orgraphql-schemaresource - Execute GraphQL queries with the
query-graphqltool - Support for custom headers (e.g., authentication tokens)
- Option to provide a local or remote schema file instead of introspection
- Mutations disabled by default for security; enable with
ALLOW_MUTATIONS=true
Use cases of mcp-graphql
- LLM agents that need to query or modify data through a GraphQL API
- Dynamic discovery of GraphQL schema for building context-aware responses
- Testing or exploring GraphQL endpoints without writing custom code
FAQ from mcp-graphql
What does mcp-graphql do?
It acts as a bridge between LLMs (via the MCP protocol) and any GraphQL endpoint, enabling schema discovery and query execution.
How is mcp-graphql installed?
It can be installed automatically via Smithery (npx -y @smithery/cli install mcp-graphql --client claude) or manually by adding to Claude Desktop configuration with npx mcp-graphql and environment variables.
What dependencies does mcp-graphql require?
No special dependencies beyond Node.js; it runs via npx from the npm package.
How are authentication credentials handled?
Custom HTTP headers can be passed as a JSON string via the HEADERS environment variable, e.g., HEADERS='{"Authorization":"Bearer token123"}'.
Are GraphQL mutations allowed by default?
No, mutations are disabled by default as a security measure to prevent unintended database changes. Set ALLOW_MUTATIONS=true to enable them.
Frequently asked questions
What does mcp-graphql do?
It acts as a bridge between LLMs (via the MCP protocol) and any GraphQL endpoint, enabling schema discovery and query execution.
How is mcp-graphql installed?
It can be installed automatically via Smithery (`npx -y @smithery/cli install mcp-graphql --client claude`) or manually by adding to Claude Desktop configuration with `npx mcp-graphql` and environment variables.
What dependencies does mcp-graphql require?
No special dependencies beyond Node.js; it runs via `npx` from the npm package.
How are authentication credentials handled?
Custom HTTP headers can be passed as a JSON string via the `HEADERS` environment variable, e.g., `HEADERS='{"Authorization":"Bearer token123"}'`.
Are GraphQL mutations allowed by default?
No, mutations are disabled by default as a security measure to prevent unintended database changes. Set `ALLOW_MUTATIONS=true` to enable them.
Basic information
More Other MCP servers
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
ICSS
chokcoco不止于 CSS
Glasswarp
GlasswarpSee and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
Comments