MCP Graphql Bridge
Bridges any GraphQL API to Claude Code — auto-generates MCP tools via schema…
- Pricing
- Open source
- Runs
- Locally
- Version
- 2.1.0
- Listing updated
- 6 days ago
About MCP Graphql Bridge
MCP Graphql Bridge is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Bridges any GraphQL API to Claude Code — auto-generates MCP tools via schema introspection.
Install
Run in a terminal
claude mcp add mcp-graphql-bridge --env GRAPHQL_TOKEN='<GRAPHQL_TOKEN>' --env GRAPHQL_INTROSPECTION_TOKEN='<GRAPHQL_INTROSPECTION_TOKEN>' -- npx -y mcp-graphql-bridgeAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
"GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
"GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-graphql-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
"GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
"GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "<GRAPHQL_TOKEN>",
"GRAPHQL_INTROSPECTION_TOKEN": "<GRAPHQL_INTROSPECTION_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GRAPHQL_API_URLGraphQL endpoint URL used for executing queries and mutations. Defaults to the public Countries API.GRAPHQL_INTROSPECTION_URLGraphQL endpoint URL used for schema introspection. Defaults to GRAPHQL_API_URL.GRAPHQL_TOKENBearer token for authenticating query and mutation execution.GRAPHQL_INTROSPECTION_TOKENBearer token for schema introspection. Defaults to GRAPHQL_TOKEN.GRAPHQL_MAX_TOOLSMaximum number of generated query and mutation tools. Defaults to 128.GRAPHQL_INCLUDE_MUTATIONSSet to false to disable mutation tools and mutation execution. Defaults to true.GRAPHQL_MAX_RETRIESRetries for transient upstream responses. Defaults to 0.
Pricing
Open source
MCP Graphql Bridge FAQ
Is MCP Graphql Bridge free?
Yes. MCP Graphql Bridge is open source, so you can use and self-host it for free.
How do I add MCP Graphql Bridge to Claude Code?
Run this command in your terminal: claude mcp add mcp-graphql-bridge --env GRAPHQL_TOKEN='<GRAPHQL_TOKEN>' --env GRAPHQL_INTROSPECTION_TOKEN='<GRAPHQL_INTROSPECTION_TOKEN>' -- npx -y mcp-graphql-bridge
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.