MCP Graphql

@blurrah

Repository

Basic information

About MCP Graphql

Model Context Protocol server for GraphQL

#ai #mcp #llm #mcp-server #modelcontextprotocol

MCP Graphql config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-graphql": {
      "command": "npx",
      "args": [
        "mcp-graphql"
      ],
      "env": {
        "ENDPOINT": "http://localhost:3000/graphql"
      }
    }
  }
}

MCP Graphql tools

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.

Query a GraphQL endpoint with the given query and variables

Overview

What is mcp-graphql?

mcp-graphql is a Model Context Protocol (MCP) server that enables LLMs to interact with GraphQL APIs. It provides schema introspection and query execution capabilities, allowing models to dynamically discover and use any GraphQL endpoint.

How to use mcp-graphql?

Set environment variables (ENDPOINT, HEADERS, ALLOW_MUTATIONS, NAME, SCHEMA) and run npx mcp-graphql. The server automatically introspects the schema and exposes tools for querying. It can be installed via Smithery or configured manually for Claude Desktop.

Key features of mcp-graphql

Schema introspection via introspect-schema tool or graphql-schema resource
Execute GraphQL queries with the query-graphql tool
Support for custom headers (e.g., authentication tokens)
Option to provide a local or remote schema file instead of introspection
Mutations disabled by default for security; enable with ALLOW_MUTATIONS=true

Use cases of mcp-graphql

LLM agents that need to query or modify data through a GraphQL API
Dynamic discovery of GraphQL schema for building context-aware responses
Testing or exploring GraphQL endpoints without writing custom code

Frequently asked questions

What does mcp-graphql do?

It acts as a bridge between LLMs (via the MCP protocol) and any GraphQL endpoint, enabling schema discovery and query execution.

How is mcp-graphql installed?

It can be installed automatically via Smithery (`npx -y @smithery/cli install mcp-graphql --client claude`) or manually by adding to Claude Desktop configuration with `npx mcp-graphql` and environment variables.

What dependencies does mcp-graphql require?

No special dependencies beyond Node.js; it runs via `npx` from the npm package.

How are authentication credentials handled?

Custom HTTP headers can be passed as a JSON string via the `HEADERS` environment variable, e.g., `HEADERS='{"Authorization":"Bearer token123"}'`.

Are GraphQL mutations allowed by default?

No, mutations are disabled by default as a security measure to prevent unintended database changes. Set `ALLOW_MUTATIONS=true` to enable them.

Comments

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

ICSS

chokcoco

不止于 CSS

20.7K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w