GraphQL Toolkit
About
Enables LLMs to interact with GraphQL APIs through schema introspection and query execution, with security measures like disabled mutations and support for authentication headers.
Details
- Repository
- kailashGN/graphql-mcp-toolkit
Explore
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
GraphQL ToolkitCommand (node, npx, python, etc.)npxArguments-
Argument 1
mcp-graphql -
Argument 2
--endpoint -
Argument 3
http://localhost:3000/graphql
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run mcp-graphql with the correct endpoint, it will automatically try to introspect your queries.
npx mcp-graphql --endpoint http://localhost:3000/graphql
To install GraphQL MCP Toolkit for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-graphql --client claude
It can be manually installed to Claude:
{
"mcpServers": {
"mcp-graphql": {
"command": "npx",
"args": ["mcp-graphql", "--endpoint", "http://localhost:3000/graphql"]
}
}
}
introspect-schema
Retrieves the GraphQL schema. Use this first if you don't have access to the schema as a resource. It utilizes either the local schema file or an introspection query.
query-graphql
Executes GraphQL queries against the endpoint. By default, mutations are disabled unless the `--enable-mutations` flag is specified.
The server provides two main tools:
1. introspect-schema: This tool retrieves the GraphQL schema. Use this first if you don't have access to the schema as a resource.
This uses either the local schema file or an introspection query.
2. query-graphql: Execute GraphQL queries against the endpoint. By default, mutations are disabled unless --enable-mutations is specified.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"graphql toolkit": {
"env": {},
"args": [
"mcp-graphql",
"--endpoint",
"http://localhost:3000/graphql"
],
"command": "npx"
}
}
}Linux
{
"env": [],
"args": [
"mcp-graphql",
"--endpoint",
"http://localhost:3000/graphql"
],
"command": "npx"
}Macos
{
"env": [],
"args": [
"mcp-graphql",
"--endpoint",
"http://localhost:3000/graphql"
],
"command": "npx"
}Windows
{
"env": [],
"args": [
"/c",
"npx",
"mcp-graphql",
"--endpoint",
"http://localhost:3000/graphql"
],
"command": "cmd"
}mcp-graphql
A Model Context Protocol server that enables LLMs to interact with GraphQL APIs. This implementation provides schema introspection and query execution capabilities, allowing models to discover and use GraphQL APIs dynamically.
Usage
Run mcp-graphql with the correct endpoint, it will automatically try to introspect your queries.
Command Line Arguments
| Argument | Description | Default |
| -------------------- | ------------------------------------------------ | ------------------------------- |
| --endpoint | GraphQL endpoint URL | http://localhost:4000/graphql |
| --headers | JSON string containing headers for requests | {} |
| --enable-mutations | Enable mutation operations (disabled by default) | false |
| --name | Name of the MCP server | mcp-graphql |
| --schema | Path to a local GraphQL schema file (optional) | - |
Examples
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
