MCP.so
Sign In

GraphQL MCP Server

@ctkadvisors

Basic information

Category

Other

License

View license

Transports

stdio

Author

ctkadvisors

About GraphQL MCP Server

MCP server for dynamic graphql

GraphQL MCP Server config

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

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

GraphQL MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

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`.

4

How is authentication handled?

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

5

What transport does the server use?

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

Comments

More Other MCP servers