Skip to main content
Glama
GraphQL MCP Server

GraphQL MCP Server

by FabrWill

Graphql MCP Server

An model context protocol adapted to running and list graphql queries

Environment Variable

Description

Default

ENDPOINT

GraphQL endpoint URL

http://localhost:4000/graphql

HEADERS

JSON string containing headers for requests

{}

ALLOW_MUTATIONS

Enable mutation operations (disabled by default)

false

Resources

  • schema: exposes the GraphQL Schema to easy use by the IA

Related MCP server: mcp-graphql

Available Tools

  1. introspect: This tool retrieves the GraphQL schema. used to index or get a new funciton by the LLM

  2. query: Execute GraphQL queries.

Installation

Installing Manually

start with installing the dependencies

npm i

after run the build of the package

npm run build

It can be manually installed to cursor:

{
  "mcpServers": {
    "gql-mcp-server": {
      "command": "npx",
      "args": ["mcp-graphql"],
      "env": {
          "ENDPOINT": "https://localhost",
          "HEADERS": "{\"x-api-key\":\"apikey\"}"
      }
    }
  }
}

You can also test the mpc using the MPC inspector

npx -y @modelcontextprotocol/inspector node dist/index.js inspect

Available Tools

3 tools
inspectC

Inspect this server

Inputs: __ignore__.

introspectA

Introspect the GraphQL schema, use this tool before doing a query to get the schema information if you do not have it available as a resource already.

Inputs: __ignore__.

queryC

Query a GraphQL endpoint with the given query and variables

Inputs: query (required), variables.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 3 tools

    Disambiguation4/5

    The three tools have distinct primary purposes: inspect for server metadata, introspect for schema discovery, and query for executing operations. However, inspect and introspect could be slightly confused as both provide information about the server, though their specific focuses differ enough for agents to distinguish them with careful reading of descriptions.

    Naming Consistency5/5

    All tool names follow a consistent, simple verb-based pattern (inspect, introspect, query) without any mixing of conventions like camelCase or snake_case. The naming is straightforward and predictable across the set.

    Tool Count3/5

    With only 3 tools, this server feels minimal for a GraphQL domain, which typically involves operations like mutations and subscriptions beyond just queries. While it covers basic introspection and querying, the count is borderline thin for a full-featured GraphQL interface.

    Completeness2/5

    The tool set is significantly incomplete for GraphQL operations. It lacks mutation tools for data modification and subscription tools for real-time updates, which are core parts of the GraphQL specification. This gap will likely cause agent failures when trying to perform common GraphQL workflows beyond read-only queries.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.
      995 npm
      3
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI agents to dynamically interact with Hasura GraphQL endpoints through natural language, supporting schema discovery, data querying/manipulation, and aggregations.
      9
      24
      -