Graphql

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.