GraphQL MCP Server
Allows interaction with GraphQL endpoints, providing tools to execute queries, retrieve schema information through introspection, and optionally run mutations when enabled.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GraphQL MCP Server introspect the schema to see what queries are available"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Graphql MCP Server
An model context protocol adapted to running and list graphql queries
Environment Variable | Description | Default |
| GraphQL endpoint URL |
|
| JSON string containing headers for requests |
|
| Enable mutation operations (disabled by default) |
|
Resources
schema: exposes the GraphQL Schema to easy use by the IA
Related MCP server: mcp-graphql
Available Tools
introspect: This tool retrieves the GraphQL schema. used to index or get a new funciton by the LLM
query: Execute GraphQL queries.
Installation
Installing Manually
start with installing the dependencies
npm iafter run the build of the package
npm run buildIt can be manually installed to cursor:
{
"mcpServers": {
"gql-mcp-server": {
"command": "npx",
"args": ["mcp-graphql"],
"env": {
"ENDPOINT": "https://localhost",
"HEADERS": "{\"x-api-key\":\"apikey\"}"
}
}
}
}You can also test the mpc using the MPC inspector
npx -y @modelcontextprotocol/inspector node dist/index.js inspectAvailable Tools
3 toolsinspectC
Inspect this server
Inputs: __ignore__.
introspectA
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.
Inputs: __ignore__.
queryC
Query a GraphQL endpoint with the given query and variables
Inputs: query (required), variables.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have distinct primary purposes: inspect for server metadata, introspect for schema discovery, and query for executing operations. However, inspect and introspect could be slightly confused as both provide information about the server, though their specific focuses differ enough for agents to distinguish them with careful reading of descriptions.
All tool names follow a consistent, simple verb-based pattern (inspect, introspect, query) without any mixing of conventions like camelCase or snake_case. The naming is straightforward and predictable across the set.
With only 3 tools, this server feels minimal for a GraphQL domain, which typically involves operations like mutations and subscriptions beyond just queries. While it covers basic introspection and querying, the count is borderline thin for a full-featured GraphQL interface.
The tool set is significantly incomplete for GraphQL operations. It lacks mutation tools for data modification and subscription tools for real-time updates, which are core parts of the GraphQL specification. This gap will likely cause agent failures when trying to perform common GraphQL workflows beyond read-only queries.
Maintenance
Related MCP Connectors
The Grafbase MCP server sits in front of a GraphQL API and exposes an MCP protocol-compliant interface that allows AI agents and LLMs to explore and query GraphQL APIs using natural language. It provides tools to search schemas, introspect types and fields, and execute GraphQL queries while minimizing context bloat by returning only relevant schema subsets, with built-in support for authentication, authorization, and configurable access control.
A Model Context Protocol server for Wix AI tools
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
Related MCP Servers
- AlicenseCqualityDmaintenanceA TypeScript server that provides Claude AI with seamless access to any GraphQL API through the Model Context Protocol.610 npm12MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.995 npm3MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables LLMs to interact with GraphQL APIs by providing schema introspection and query execution capabilities.11 npmMIT
- FlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI agents to dynamically interact with Hasura GraphQL endpoints through natural language, supporting schema discovery, data querying/manipulation, and aggregations.924-