Bridges any GraphQL API to Claude Code — auto-generates MCP tools via schema introspection.
Connect Runs on your machine
claude mcp add mcp-graphql-bridge -e GRAPHQL_API_URL=<GRAPHQL_API_URL> -e GRAPHQL_INTROSPECTION_URL=<GRAPHQL_INTROSPECTION_URL> -e GRAPHQL_TOKEN=<GRAPHQL_TOKEN> -e GRAPHQL_INTROSPECTION_TOKEN=<GRAPHQL_INTROSPECTION_TOKEN> -e GRAPHQL_MAX_TOOLS=<GRAPHQL_MAX_TOOLS> -e GRAPHQL_INCLUDE_MUTATIONS=<GRAPHQL_INCLUDE_MUTATIONS> -e GRAPHQL_MAX_RETRIES=<GRAPHQL_MAX_RETRIES> -- npx -y [email protected]{
"mcpServers": {
"mcp-graphql-bridge": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"GRAPHQL_API_URL": "<GRAPHQL_API_URL>",
"GRAPHQL_INTROSPECTION_URL": "<GRAPHQL_INTROSPECTION_URL>",
"GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
"GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>",
"GRAPHQL_MAX_TOOLS": "<GRAPHQL_MAX_TOOLS>",
"GRAPHQL_INCLUDE_MUTATIONS": "<GRAPHQL_INCLUDE_MUTATIONS>",
"GRAPHQL_MAX_RETRIES": "<GRAPHQL_MAX_RETRIES>"
}
}
}
}{
"mcpServers": {
"mcp-graphql-bridge": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"GRAPHQL_API_URL": "<GRAPHQL_API_URL>",
"GRAPHQL_INTROSPECTION_URL": "<GRAPHQL_INTROSPECTION_URL>",
"GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
"GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>",
"GRAPHQL_MAX_TOOLS": "<GRAPHQL_MAX_TOOLS>",
"GRAPHQL_INCLUDE_MUTATIONS": "<GRAPHQL_INCLUDE_MUTATIONS>",
"GRAPHQL_MAX_RETRIES": "<GRAPHQL_MAX_RETRIES>"
}
}
}
}{
"servers": {
"mcp-graphql-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"GRAPHQL_API_URL": "<GRAPHQL_API_URL>",
"GRAPHQL_INTROSPECTION_URL": "<GRAPHQL_INTROSPECTION_URL>",
"GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
"GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>",
"GRAPHQL_MAX_TOOLS": "<GRAPHQL_MAX_TOOLS>",
"GRAPHQL_INCLUDE_MUTATIONS": "<GRAPHQL_INCLUDE_MUTATIONS>",
"GRAPHQL_MAX_RETRIES": "<GRAPHQL_MAX_RETRIES>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
GRAPHQL_API_URLOptional | GraphQL endpoint URL used for executing queries and mutations. Defaults to the public Countries API. |
GRAPHQL_INTROSPECTION_URLOptional | GraphQL endpoint URL used for schema introspection. Defaults to GRAPHQL_API_URL. |
GRAPHQL_TOKENOptional, secret | Bearer token for authenticating query and mutation execution. |
GRAPHQL_INTROSPECTION_TOKENOptional, secret | Bearer token for schema introspection. Defaults to GRAPHQL_TOKEN. |
GRAPHQL_MAX_TOOLSOptional | Maximum number of generated query and mutation tools. Defaults to 128. |
GRAPHQL_INCLUDE_MUTATIONSOptional | Set to false to disable mutation tools and mutation execution. Defaults to true. |
GRAPHQL_MAX_RETRIESOptional | Retries for transient upstream responses. Defaults to 0. |
Details
| Package | [email protected] (NPM, stdio) |
| First published | 28 Jul 2026 |
| Last updated | 28 Jul 2026 |
| Registry name | io.github.murilojrpereira/mcp-graphql-bridge |
More developer tools servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.