MCP.so
Sign In

GraphQL MCP Server

@ctkadvisors

About GraphQL MCP Server

MCP server for dynamic graphql

Config

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

{
  "mcpServers": {
    "graphql-mcp": {
      "command": "node",
      "args": [
        "dist/graphql-mcp-server.js"
      ]
    }
  }
}

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 GraphQL MCP Server?

A strongly-typed TypeScript Model Context Protocol (MCP) server that provides seamless access to any GraphQL API through Claude AI.

How to use GraphQL MCP Server?

Install via npm (npm install -g graphql-mcp and run graphql-mcp-server) or clone the repository, install dependencies, build with TypeScript, and run. Integrate with Claude Desktop by adding the server to the MCP configuration file with environment variables such as GRAPHQL_API_ENDPOINT, GRAPHQL_API_KEY, ENABLE_MUTATIONS, WHITELISTED_QUERIES, and WHITELISTED_MUTATIONS.

Key features of GraphQL MCP Server

  • Strongly typed with TypeScript for code quality and type safety
  • Dynamic integration with any GraphQL API via automatic tool generation
  • Schema introspection that discovers all GraphQL operations as tools
  • Full mutation support with proper handling and optional whitelisting
  • Query and mutation whitelisting for controlled access
  • Proper handling of complex GraphQL types, input objects, and variables
  • MCP standard compliant for seamless Claude Desktop integration
  • Smart query generation with efficient field selection

Use cases of GraphQL MCP Server

  • Querying data from any GraphQL API through natural language in Claude Desktop
  • Performing GraphQL mutations (e.g., creating users, updating profiles) with proper parameter handling
  • Exposing only specific GraphQL operations to Claude for security or performance reasons
  • Enabling or disabling mutations globally to control write access to backend systems

FAQ from GraphQL MCP Server

What GraphQL APIs can I connect to?

Any GraphQL API endpoint is supported; the server defaults to the Countries API if no endpoint is specified.

Do I need a runtime or dependencies beyond Node.js?

Yes, Node.js 18 or later and TypeScript 5.x or later are required. Claude Desktop with MCP support is needed for integration.

How do I control which operations are exposed to Claude?

You can whitelist queries and mutations using the WHITELISTED_QUERIES and WHITELISTED_MUTATIONS environment variables, and enable/disable all mutations via ENABLE_MUTATIONS.

How is authentication handled?

Authentication is optional; you can provide an API key via the GRAPHQL_API_KEY environment variable.

What transport does the server use?

The server communicates via standard input/output (stdio) as configured for Claude Desktop MCP servers.

Frequently asked questions

What GraphQL APIs can I connect to?

Any GraphQL API endpoint is supported; the server defaults to the Countries API if no endpoint is specified.

Do I need a runtime or dependencies beyond Node.js?

Yes, Node.js 18 or later and TypeScript 5.x or later are required. Claude Desktop with MCP support is needed for integration.

How do I control which operations are exposed to Claude?

You can whitelist queries and mutations using the `WHITELISTED_QUERIES` and `WHITELISTED_MUTATIONS` environment variables, and enable/disable all mutations via `ENABLE_MUTATIONS`.

How is authentication handled?

Authentication is optional; you can provide an API key via the `GRAPHQL_API_KEY` environment variable.

What transport does the server use?

The server communicates via standard input/output (stdio) as configured for Claude Desktop MCP servers.

Comments

Basic information

Category

Other

License

View license

Transports

stdio

Author

ctkadvisors

More Other MCP servers