mcp-graphql-introspection

GraphQL Introspection MCP Server

A Node.js server implementing the Model Context Protocol (MCP) that provides GraphQL schema introspection capabilities. This server enables LLMs to inspect GraphQL schemas and retrieve information about available queries, mutations, and types.

Features

• Schema Introspection: Query GraphQL endpoints to retrieve complete schema information
• Query Discovery: List all available queries with descriptions and parameters
• Mutation Discovery: List all available mutations with descriptions and parameters
• Type Details: Get detailed information about specific GraphQL types including fields, enum values, and input fields
• Flexible Endpoint Support: Connect to any GraphQL endpoint (defaults to localhost:4001/api/graphql)

API

Tools

• introspect_schema

  • Get full GraphQL schema information from endpoint
  • Input: endpoint (string, optional): GraphQL endpoint URL (defaults to localhost:4001/api/graphql)
  • Returns basic schema information including query/mutation/subscription types and counts

• get_graphql_gql_queries

  • List all available queries with descriptions and parameters
  • Input: endpoint (string, optional): GraphQL endpoint URL (defaults to localhost:4001/api/graphql)
  • Returns formatted list of queries with their arguments and return types

• get_graphql_gql_mutations

  • List all available mutations with descriptions and parameters
  • Input: endpoint (string, optional): GraphQL endpoint URL (defaults to localhost:4001/api/graphql)
  • Returns formatted list of mutations with their arguments and return types

• get_graphql_type_details

  • Get detailed information about specific GraphQL types
  • Input: endpoint (string, optional): GraphQL endpoint URL (defaults to localhost:4001/api/graphql)
  • Input: typeNames (array of strings): Names of the GraphQL types to inspect
  • Returns detailed type information including fields, enum values, and input fields

Usage

Claude code

claude mcp add graphql-introspection npx mcp-graphql-introspection

Cursor

Click the button to install:

Or install manually:

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx @playwright/mcp. You can also verify config or add command like arguments via clicking Edit.

{
  "mcpServers": {
    "graphql-introspection": {
      "command": "npx",
      "args": ["mcp-graphql-introspection"]
    }
  }
}

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "graphql-introspection": {
      "command": "npx",
      "args": ["mcp-graphql-introspection"]
    }
  }
}

VS Code

Add this to your VS Code settings:

{
  "mcpServers": {
    "graphql-introspection": {
      "command": "npx",
      "args": ["mcp-graphql-introspection"]
    }
  }
}

Build

npm install
npm run build

License

This MCP server is licensed under the MIT License. This allows you to freely use, modify, and distribute the software.