Mcp4gql 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)

Local serverstdioTypeScript

What is the Mcp4gql 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

What the server does

  • MCP Server: — Implements the MCP Server class from @modelcontextprotocol/sdk
  • Stdio Transport: — Communicates with clients via standard input/output
  • GraphQL Client: — Uses axios to 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, taking query, optional variables, and optional operationName as input

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
introspectGraphQLSchemaFetches the target GraphQL API schema using introspection.
executeGraphQLOperationExecutes arbitrary GraphQL queries or mutations against the target API, taking query, optional variables, and optional operationName as input.

How to install the Mcp4gql MCP Server

{
  "mcpServers": {
    "mcp4gql": {
      "command": "npx",
      "type": "stdio",
      "args": [
        "-y",
        "mcp4gql"
      ],
      "env": {
        "GRAPHQL_ENDPOINT": "YOUR_GRAPHQL_ENDPOINT_URL",
        "AUTH_TOKEN": "YOUR_AUTH_TOKEN"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GRAPHQL_ENDPOINTDeclared in the maintainer’s client configuration.Check documentation
AUTH_TOKENDeclared in the maintainer’s client configuration.Optional

Example prompts to try

  • “Use Mcp4gql to introspectGraphQLSchema.”
  • “Use Mcp4gql to executeGraphQLOperation.”
  • “Use Mcp4gql to GRAPHQL ENDPOINT.”

Frequently asked questions

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 Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.