Graphql
Description
# 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…
About
# 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 -…
Details
- Author
- saewoohan
- Downloads
- 368
- Categories
- Other, API
Jump to
- Execute GraphQL queries with optional variables and headers
- Retrieve and explore GraphQL schema information
- Configurable default endpoint, timeout, and query complexity limit
- Supports custom HTTP headers per request
- Allows or blocks mutation operations via allowMutations flag
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
GraphqlCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Configure the server in Claude Desktop using the NPX command with optional arguments for endpoint, headers, timeout, and max complexity. Once running, invoke the graphql_query tool to run queries or graphql_introspect to explore schema.
graphql_query
Execute GraphQL queries using either a specified endpoint or the default endpoint configured during installation
graphql_introspect
Introspect a GraphQL schema from an endpoint with configurable headers
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"graphql": {
"graphql": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-tools",
"--endpoint=https://api.github.com/graphql",
"--headers={\"Authorization\":\"Bearer YOUR_GITHUB_TOKEN\"}",
"--timeout=30000",
"--maxComplexity=100"
]
}
}
}
}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"
]
}
}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.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
