mcp4gql
This server allows MCP clients to interact with a target GraphQL API via Model Context Protocol (MCP).
Fetch GraphQL Schema: Use
introspectGraphQLSchemato retrieve the schema of the target API in JSON formatExecute Queries/Mutations: Use
executeGraphQLOperationto send arbitrary GraphQL queries or mutations with optional variables and operation nameAuthentication Support: Optional bearer token authentication for secure API access
MCP Integration: Seamlessly connect MCP clients (like Cursor or Claude Desktop) to the server
Uses Axios to send requests to GraphQL endpoints, allowing for authenticated API interactions with configurable authorization tokens.
Acts as a bridge to any GraphQL API, providing tools to introspect schemas and execute arbitrary queries or mutations against the target GraphQL endpoint.
Built on Node.js to implement the Model Context Protocol server functionality, enabling GraphQL API interactions through standard I/O.
Implemented in TypeScript, providing type-safe interactions with GraphQL APIs through the MCP interface.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp4gql show me the schema for our user management API"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp4gql - GraphQL MCP Server

This project is a Node.js/TypeScript server that implements the Model Context Protocol (MCP). It acts as a bridge, allowing MCP clients (like Cursor) to interact with a target GraphQL API.
Features
MCP Server: Implements the MCP
Serverclass from@modelcontextprotocol/sdk.Stdio Transport: Communicates with clients via standard input/output.
GraphQL Client: Uses
axiosto send requests to the configured GraphQL endpoint.Generic GraphQL Tools: Exposes the following tools to MCP clients:
introspectGraphQLSchema: Fetches the target GraphQL API schema using introspection.executeGraphQLOperation: Executes arbitrary GraphQL queries or mutations against the target API, takingquery, optionalvariables, and optionaloperationNameas input.
Related MCP server: mcp-graphql
Configuration
The server requires the following environment variables:
GRAPHQL_ENDPOINT: The URL of the target GraphQL API.AUTH_TOKEN: A bearer token for an optionalAuthorization: Bearer <token>header for authenticating with the GraphQL API.
Client Configuration
To allow clients like Cursor or Claude Desktop to use the tools provided by this server, you need to configure them to run the npx command.
Cursor
Go to Cursor MCP Settings (Cursor > Settings > Cursor Settings > MCP)
Go to + Add new global MCP server
Add the following to your Cursor MCP configuration:
{ "mcpServers": { "mcp4gql": { "command": "npx", "type": "stdio", "args": ["-y", "mcp4gql"], "env": { "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL", "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN" } } } }
Claude Desktop
Open Claude Desktop settings (Claude > Settings).
Go to Developer > Edit Config.
Add to the config:
{ "mcpServers": { "mcp4gql": { "command": "npx", "args": ["-y", "mcp4gql"], "env": { "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL", "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN" } } } }
Once configured, the MCP client should be able to list and call the introspectGraphQLSchema and executeGraphQLOperation tools provided by this server when relevant. Remember to set the required environment variables (GRAPHQL_ENDPOINT and optionally AUTH_TOKEN) in the configuration so the server can connect to your API.
Available Tools
2 toolsexecuteGraphQLOperationA
Executes an arbitrary GraphQL query or mutation against the target API. Use introspectGraphQLSchema first to understand the available operations.
Inputs: query (required), variables, operationName.
introspectGraphQLSchemaB
Fetches the schema of the target GraphQL API using introspection. Returns the schema in JSON format.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: introspectGraphQLSchema fetches the schema, while executeGraphQLOperation executes queries/mutations. There is no overlap or ambiguity between them, making it easy for an agent to select the correct tool.
Both tools follow a verb_noun pattern (introspectGraphQLSchema, executeGraphQLOperation), but they use camelCase instead of snake_case. This is a minor deviation from a common convention, but the pattern is consistent and readable across the set.
With only 2 tools, the server feels thin for a GraphQL client purpose. While the tools cover introspection and execution, typical GraphQL interactions might benefit from additional utilities like schema validation or query building, making this count borderline too few.
The tools cover core GraphQL operations (introspection and execution), but there are notable gaps. For example, there are no tools for schema exploration, query validation, or handling subscriptions, which could limit an agent's ability to fully interact with a GraphQL API.
Maintenance
Related MCP Connectors
The Grafbase MCP server sits in front of a GraphQL API and exposes an MCP protocol-compliant interface that allows AI agents and LLMs to explore and query GraphQL APIs using natural language. It provides tools to search schemas, introspect types and fields, and execute GraphQL queries while minimizing context bloat by returning only relevant schema subsets, with built-in support for authentication, authorization, and configurable access control.
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA MCP server that exposes GraphQL schema information to LLMs like Claude. This server allows an LLM to explore and understand large GraphQL schemas through a set of specialized tools, without needing to load the whole schema into the context46MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.3MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.MIT
- FlicenseNot gradedqualityDmaintenanceThis MCP server exposes approved GraphQL operations from an Apollo GraphQL API as AI-accessible tools. It sits between MCP clients and the GraphQL API, translating tool calls into GraphQL queries and returning results in MCP format.-