Skip to content
MCP server

MCP Graphql Bridge

Bridges any GraphQL API to Claude Code — auto-generates MCP tools via schema…

Runs locallyStatus and history
Install
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-bridge

Add 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.

How AIPoweredBot checks servers