Graphql

@saewoohan

About Graphql

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "graphql": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-tools",
        "--endpoint=https://api.github.com/graphql",
        "--headers={\"Authorization\":\"Bearer YOUR_GITHUB_TOKEN\"}",
        "--timeout=30000",
        "--maxComplexity=100"
      ]
    }
  }
}

Tools

Execute GraphQL queries using either a specified endpoint or the default endpoint configured during installation

Introspect a GraphQL schema from an endpoint with configurable headers

Overview

What is Graphql?

Graphql is a Model Context Protocol (MCP) server that enables AI assistants to execute GraphQL queries and retrieve schema information from any GraphQL endpoint. It is designed for developers and AI systems that need to interact with GraphQL APIs through standardized tools.

How to use Graphql?

Configure the server in Claude Desktop using the NPX command with optional arguments for endpoint, headers, timeout, and max complexity. Once running, invoke the graphql_query tool to run queries or graphql_introspect to explore schema.

Key features of Graphql

Execute GraphQL queries with optional variables and headers
Retrieve and explore GraphQL schema information
Configurable default endpoint, timeout, and query complexity limit
Supports custom HTTP headers per request
Allows or blocks mutation operations via allowMutations flag

Use cases of Graphql

Let an AI assistant query a GraphQL API on behalf of a user
Explore and document GraphQL schema structure automatically
Safely limit query complexity to prevent resource exhaustion

FAQ from Graphql

What commands does Graphql provide?

Two tools: graphql_query for executing queries and mutations, and graphql_introspect for retrieving schema information.

How do I configure Graphql for Claude Desktop?

Add a "graphql" entry under mcpServers in your Claude Desktop configuration, using npx -y mcp-graphql-tools and any desired command-line flags (e.g., --endpoint, --headers, --timeout, --maxComplexity).

What configuration options are available?

Command-line flags: --endpoint (default http://localhost:4000/graphql), --headers (JSON string), --timeout (default 30000 ms), and --maxComplexity (default 100).

What license is Graphql under?

This MCP server is licensed under the MIT License.

Frequently asked questions

What commands does Graphql provide?

Two tools: `graphql_query` for executing queries and mutations, and `graphql_introspect` for retrieving schema information.

How do I configure Graphql for Claude Desktop?

Add a `"graphql"` entry under `mcpServers` in your Claude Desktop configuration, using `npx -y mcp-graphql-tools` and any desired command-line flags (e.g., `--endpoint`, `--headers`, `--timeout`, `--maxComplexity`).

What configuration options are available?

Command-line flags: `--endpoint` (default http://localhost:4000/graphql), `--headers` (JSON string), `--timeout` (default 30000 ms), and `--maxComplexity` (default 100).