Graphql To Mcp

What is Graphql To Mcp?

Graphql To Mcp turns any GraphQL API into MCP (Model Context Protocol) tools with zero configuration. By pointing it at a GraphQL endpoint, it automatically discovers all queries and mutations via introspection and generates one MCP tool per operation. It works with Claude Desktop, Cursor, Windsurf, and any MCP client.

How to use Graphql To Mcp?

Run it directly with npx graphql-to-mcp <graphql-endpoint-url> (no install needed) or add it to a Claude Desktop or Cursor config file under mcpServers. Optional flags include --bearer, --api-key, --include, --exclude, --prefix, --timeout, --max-retries, and --transport. It can also be used programmatically via the createServer function.

Key features of Graphql To Mcp

• Zero configuration – just provide a GraphQL endpoint URL
• Auto-introspection discovers all queries and mutations
• Flat parameter schemas improve LLM accuracy
• Smart truncation handles large responses (array slicing, depth limiting, character cap)
• Auth support: Bearer tokens, API keys, and custom headers
• Include/exclude filters to control which operations are exposed

Use cases of Graphql To Mcp

• Give an LLM like Claude access to query and mutate a GraphQL API
• Combine multiple GraphQL APIs in one MCP client using the --prefix option
• Pair with mcp-openapi to expose both GraphQL and REST endpoints to the same LLM
• Securely expose a subset of operations to an AI assistant using include/exclude filters

FAQ from Graphql To Mcp

How does Graphql To Mcp handle large responses?

GraphQL responses are automatically truncated: arrays are sliced to 20 items (with metadata showing total count), object depth is limited to 5 levels, and a hard cap of 50,000 characters is applied to prevent overwhelming LLM context windows.

Does Graphql To Mcp support authentication?

Yes. It supports Bearer tokens (via --bearer), API keys (via --api-key specifying name, value, and location), and arbitrary custom headers (via --header or the -H flag).

Can I expose only specific queries or mutations?

Yes. Use the --include <pattern> flag to include only operations matching a pattern, and --exclude <pattern> to hide matching operations. Patterns support wildcards (e.g., get*).

What transport protocols does Graphql To Mcp support?

It supports both stdio (default) and sse (Server-Sent Events) transport, selectable via the --transport option.

Is there any code or configuration required to get started?

No. Just run npx graphql-to-mcp https://your-api.com/graphql and the server is ready. The only dependencies are Node.js (required to run npx) and network access to the GraphQL endpoint.