# blurrah/mcp-graphql [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/blurrah/mcp-graphql  
**GitHub Stars:** 407  
**npm Downloads (last month):** 8079  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/blurrah-mcp-graphql

## Description
Model Context Protocol server for GraphQL

## Tools
Capabilities this server exposes over MCP:

- **introspect-schema** — This tool retrieves the GraphQL schema. Use this first if you don't have access to the schema as a resource.
- **query-graphql** — Execute GraphQL queries against the endpoint. By default, mutations are disabled unless `ALLOW_MUTATIONS` is set to `true`.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-graphql": {
    "command": "npx",
    "args": ["-y","mcp-graphql"]
  }
}
```

## Documentation

## What blurrah/mcp-graphql does

The blurrah/mcp-graphql MCP server connects an MCP client to a GraphQL API. It provides schema discovery and query execution so a model can learn the available types and fields before constructing requests. The server is intended for generic GraphQL access rather than an API-specific set of fixed tools.

A `graphql-schema` resource is also exposed to clients. Its contents can come from a local schema file, a schema file available at a URL, or an introspection request sent to the configured GraphQL endpoint.

## How it works

The blurrah/mcp-graphql MCP server uses the configured `ENDPOINT` value as the target for GraphQL requests. The `introspect-schema` tool retrieves the schema when the client does not already have it as a resource. The `query-graphql` tool then sends GraphQL queries to the same endpoint.

Request headers are supplied as a JSON string through `HEADERS`. This can be used for API-specific headers such as an authorization header, although the README does not define a particular authentication provider or token format. A schema can be supplied independently with `SCHEMA`, using either a local path or a URL, instead of relying solely on endpoint introspection.

## Setup and configuration

Run the package with the target endpoint supplied through environment variables. The endpoint defaults to `http://localhost:4000/graphql`, while headers default to an empty JSON object. `NAME` changes the MCP server name and defaults to `mcp-graphql`.

Relevant configuration includes:

- `ENDPOINT`: GraphQL service URL.
- `HEADERS`: JSON-encoded request headers.
- `SCHEMA`: Local schema path or remote schema URL.
- `ALLOW_MUTATIONS`: Set to `true` to permit mutation operations; it is `false` by default.
- `NAME`: MCP server name.

The README shows installation through `npx mcp-graphql` and a Claude Desktop configuration using the same package. For noninteractive execution, use the package runner with its confirmation flag.

## Tools and capabilities

The blurrah/mcp-graphql MCP server exposes two tools:

- `introspect-schema` obtains the GraphQL schema from the configured schema source or through an introspection query.
- `query-graphql` executes GraphQL queries against the endpoint.

The schema is additionally available through the `graphql-schema` resource. This gives clients a way to read schema information without invoking the introspection tool when the resource is already available.

## Limitations and notes

Mutations are blocked unless `ALLOW_MUTATIONS=true` is configured. This default reduces the risk of an agent changing data in the connected service, but enabling mutations should be evaluated carefully for production use.

The server offers broad GraphQL access rather than restricting clients to selected fields or operations. The README recommends creating a more specific MCP implementation when clients need tightly controlled queries or variables. The provided material does not document subscriptions, a built-in authentication mechanism, or provider-specific GraphQL features.

## Getting started with this blurrah/mcp-graphql MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/blurrah-mcp-graphql/readme_