GraphQL Schema MCP Server

What does “GraphQL Schema” MCP Server do?

The GraphQL Schema Model Context Protocol (MCP) Server is a specialized tool that enables AI assistants, such as Claude, to interact with and understand GraphQL schemas. By exposing schema details through a suite of dedicated tools, it allows large language models to explore query, mutation, and subscription fields, look up type definitions, and perform pattern-matching searches across the schema. This enhances development workflows by enabling LLMs to answer detailed questions about APIs, assist in API integration, and automate documentation or code generation tasks related to GraphQL-based systems. The server can load any GraphQL schema file specified at launch, providing a flexible foundation for schema analysis, code exploration, and developer assistance.

List of Prompts

No explicit prompt templates are mentioned in the repository documentation or code.

List of Resources

No explicit resources (as per MCP standard) are listed in the documentation or code.

List of Tools

• list-query-fields: Lists all available root-level fields for GraphQL queries.
• get-query-field: Gets detailed definition for a specific query field in SDL (Schema Definition Language) format.
• list-mutation-fields: Lists all available root-level fields for GraphQL mutations.
• get-mutation-field: Gets detailed definition for a specific mutation field in SDL format.
• list-subscription-fields: Lists all available root-level fields for GraphQL subscriptions (if present in schema).
• get-subscription-field: Gets detailed definition for a specific subscription field (if present in schema).
• list-types: Lists all types defined in the GraphQL schema (excluding internal types).
• get-type: Gets detailed definition for a specific GraphQL type in SDL format.
• get-type-fields: Gets a simplified list of fields with their types for a specific GraphQL object type.
• search-schema: Searches for types or fields in the schema by name pattern (case-insensitive regex).

Use Cases of this MCP Server

• GraphQL API Exploration: Enables developers and LLMs to quickly discover available queries, mutations, and subscriptions in a GraphQL API, accelerating onboarding and documentation efforts.
• Schema Documentation Assistance: Automates the extraction of type definitions and field details, supporting the generation or updating of API documentation.
• Codebase Integration: Allows LLMs to answer questions about data models and available operations, supporting code generation, testing, or refactoring tasks that interact with GraphQL APIs.
• API Integration Planning: Facilitates intelligent suggestions on how to interact with APIs by surfacing field types, arguments, and available operations programmatically.
• Schema Search and Analysis: Makes it possible to find types and fields matching specific patterns, aiding in schema audits, migrations, or understanding large and complex APIs.

How to set it up

Windsurf

No explicit Windsurf setup instructions are provided in the repository.

Claude

1. Prerequisites: Ensure you have Node.js and npx installed.
2. Locate Configuration File: Find claude_desktop_config.json:
   • macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: $env:AppData\Claude\claude_desktop_config.json
3. Edit Configuration: Add the GraphQL Schema MCP server to the mcpServers object.
4. Add Server: Example JSON configuration:

   {
     "mcpServers": {
       "GraphQL Schema": {
         "command": "npx",
         "args": ["-y", "mcp-graphql-schema", "/ABSOLUTE/PATH/TO/schema.graphqls"]
       }
     }
   }
   

5. Save & Restart: Save the file and restart Claude Desktop.
6. Verify Setup: Confirm the server is running and accessible in Claude.

Cursor

No explicit Cursor setup instructions are provided in the repository.

Cline

No explicit Cline setup instructions are provided in the repository.

Securing API Keys

No information about securing API keys or environment variable configuration is mentioned in the repository.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “MCP-name” to whatever the actual name of your MCP server is (e.g., “github-mcp”, “weather-api”, etc.) and replace the URL with your own MCP server URL.

Overview

Based on the details above, this MCP server is solid for GraphQL schema exploration and tooling but lacks explicit prompts, resources, and key management documentation. It is very focused on its domain and well-documented for use with Claude.

Our opinion

This MCP server is highly specialized and effective for GraphQL schema analysis, with robust tool support and clear documentation for Claude integration. However, the absence of prompt templates, explicit resource definitions, and environment variable/key security handling limits its broader applicability and ease of secure deployment. Roots and sampling support are not mentioned, which may affect advanced integration scenarios. Overall, this is a strong, reliable MCP for its target use case but could be improved for generality and security.

MCP Score