mcp4gql

mcp4gql is an MCP server that acts as a bridge, allowing MCP clients to interact directly with any target GraphQL API. Built with Node.js and TypeScript, it implements the Model Context Protocol using standard input and output (stdio) transport and makes remote HTTP calls via Axios. Software engineers, API developers, and technical teams use mcp4gql to inspect remote schemas and execute queries without leaving their AI-driven development workflows. The server exposes tools to retrieve the remote API schema through GraphQL introspection and execute arbitrary GraphQL queries or mutations against the target service. It supports authentication via a configurable bearer token, enabling AI assistants to explore complex data graphs, build queries against documented types, and retrieve live data directly from endpoints inside environments like Cursor and Claude Desktop.

Category: Developer Tools & Code Intelligence

Tags: api-bridge, graphql, introspection, query

Visit mcp4gql

How to install and configure mcp4gql

1. Ensure Node.js is installed on your machine. 2. Open your client's configuration file (e.g., Cursor MCP settings or Claude Desktop's claude_desktop_config.json). 3. Add mcp4gql to the mcpServers object: json { "mcpServers": { "mcp4gql": { "command": "npx", "args": ["-y", "mcp4gql"], "env": { "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL", "AUTH_TOKEN": "YOUR_OPTIONAL_AUTH_TOKEN" } } } } 4. Replace YOUR_GRAPHQL_ENDPOINT_URL with your target GraphQL API address and supply a token for AUTH_TOKEN if authentication is required. 5. Save the configuration and restart your MCP client.

What you can do with mcp4gql

• Introspecting a remote GraphQL schema to let AI assistants discover available types, queries, mutations, and fields automatically. - Executing arbitrary GraphQL queries from Claude or Cursor to inspect live application data during active debugging sessions. - Running GraphQL mutations with parameterized variables to modify backend resources directly from an AI programming interface. - Verifying GraphQL endpoint behavior and testing experimental queries without switching to external tools like Postman or GraphiQL.

Key facts

• https://github.com/jorgeraad/mcp4gql
• Developer Tools & Code Intelligence, Other & General Purpose
• api-bridge, graphql, introspection, query

Part of MCP Servers

What can mcp4gql do?

mcp4gql enables MCP-compatible AI assistants to interact with GraphQL endpoints. It provides tools to introspect GraphQL schemas and execute arbitrary operations, including queries and mutations with optional variables and operation names, returning the results directly to the AI client.

Which MCP clients work with mcp4gql?

mcp4gql works with any MCP client that supports standard input and output transport mechanisms. This includes desktop environments like Claude Desktop as well as developer code editors like Cursor.

How do I install mcp4gql?

You do not need to install it separately if you configure your client to run it via npx. Add mcp4gql to your client MCP configuration using npx with the -y flag and the mcp4gql package name, along with the required environment variables.

What environment variables are required for mcp4gql?

mcp4gql requires GRAPHQL_ENDPOINT pointing to your target GraphQL service URL. It also supports an optional AUTH_TOKEN environment variable, which attaches a Bearer token authorization header to outgoing API requests.