mcpField
G
Graphql

Graphql

Local
github.com/saewoohanDeveloper Tools8Updated 82w ago
Repository

About Graphql

Graphql is an MCP server that lets AI assistants interact with GraphQL APIs. It provides query execution and schema introspection, with configurable request details and optional mutation permission.

Key features

  1. 01Execute GraphQL queries
  2. 02Pass variables, headers, and endpoint
  3. 03Inspect GraphQL schemas
  4. 04Optionally allow mutations

Use cases

  1. 01Query data from a GraphQL API
  2. 02Explore available schema types and fields

MCP support

It exposes query execution and schema introspection as tools for MCP clients.

#graphql#api#mcp-tools

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "graphql-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-tools"
      ]
    }
  }
}
Run commandnpx -y mcp-graphql-tools

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-graphql-tools

Tools

2

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
endpointstringNoGraphQL endpoint URL (can be omitted to use default)
querystringYesGraphQL query to execute
variablesobjectNoVariables to use with the query (JSON object)
headersobjectNoAdditional headers to include in the request (will be merged with default headers)
timeoutnumberNoRequest timeout in milliseconds

Details

From the project README

GraphQL MCP Tools

A Model Context Protocol (MCP) server implementation that provides GraphQL API interaction capabilities. This server enables AI assistants to interact with GraphQL APIs through a set of standardized tools.

Components

Tools

  • graphql_query

    • Execute GraphQL queries against any endpoint
    • Input:
      • query (string): The GraphQL query to execute
      • variables (object, optional): Variables for the query
      • endpoint (string, optional): GraphQL endpoint URL
      • headers (object, optional): HTTP headers for the request
      • timeout (number, optional): Request timeout in milliseconds
      • allowMutations (boolean, optional): Whether to allow mutation operations

  • graphql_introspect

    • Retrieve and explore GraphQL schema information
    • Input:
      • endpoint (string, optional): GraphQL endpoint URL
      • headers (object, optional): HTTP headers for the request
      • includeDeprecated (boolean, optional): Whether to include deprecated types/fields

Usage with Claude Desktop

NPX
{
  "mcpServers": {
    "graphql": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-tools",
        "--endpoint=https://api.github.com/graphql",
        "--headers={\"Authorization\":\"Bearer YOUR_GITHUB_TOKEN\"}",
        "--timeout=30000",
        "--maxComplexity=100"
      ]
    }
  }
}

Configuration Options

The server accepts the following command-line arguments:

  • --endpoint (-e): Default GraphQL endpoint URL (default: http://localhost:4000/graphql)
  • --headers (-H): Default headers for all requests as JSON string
  • --timeout (-t): Default request timeout in milliseconds (default: 30000)
  • --maxComplexity (-m): Maximum allowed query complexity (default: 100)

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.