mcp-graphql

Name: mcp-graphql
Author: blurrah

@blurrah

Repository

About mcp-graphql

Model Context Protocol server for GraphQL

#ai #mcp #llm #mcp-server #modelcontextprotocol

Basic information

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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-schema tool or graphql-schema resource
Execute GraphQL queries with the query-graphql tool
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.