io.github.murilojrpereira/mcp-graphql-bridge MCP Server

Name: io.github.murilojrpereira/mcp-graphql-bridge MCP Server
Author: io.github.murilojrpereira

io.github.murilojrpereira/mcp-graphql-bridge

Repository Registry

What is the io.github.murilojrpereira/mcp-graphql-bridge MCP server?

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

How to install io.github.murilojrpereira/mcp-graphql-bridge

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GRAPHQL_API_URL
GraphQL endpoint URL used for executing queries and mutations. Defaults to the public Countries API.
GRAPHQL_INTROSPECTION_URL
GraphQL endpoint URL used for schema introspection. Defaults to GRAPHQL_API_URL.
GRAPHQL_TOKEN
secret
Bearer token for authenticating query and mutation execution.
GRAPHQL_INTROSPECTION_TOKEN
secret
Bearer token for schema introspection. Defaults to GRAPHQL_TOKEN.
GRAPHQL_MAX_TOOLS
Maximum number of generated query and mutation tools. Defaults to 128.
GRAPHQL_INCLUDE_MUTATIONS
Set to false to disable mutation tools and mutation execution. Defaults to true.
GRAPHQL_MAX_RETRIES
Retries for transient upstream responses. Defaults to 0.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-graphql-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_API_URL": "<YOUR_GRAPHQL_API_URL>",
        "GRAPHQL_INTROSPECTION_URL": "<YOUR_GRAPHQL_INTROSPECTION_URL>",
        "GRAPHQL_TOKEN": "<YOUR_GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<YOUR_GRAPHQL_INTROSPECTION_TOKEN>",
        "GRAPHQL_MAX_TOOLS": "<YOUR_GRAPHQL_MAX_TOOLS>",
        "GRAPHQL_INCLUDE_MUTATIONS": "<YOUR_GRAPHQL_INCLUDE_MUTATIONS>",
        "GRAPHQL_MAX_RETRIES": "<YOUR_GRAPHQL_MAX_RETRIES>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-graphql-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_API_URL": "<YOUR_GRAPHQL_API_URL>",
        "GRAPHQL_INTROSPECTION_URL": "<YOUR_GRAPHQL_INTROSPECTION_URL>",
        "GRAPHQL_TOKEN": "<YOUR_GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<YOUR_GRAPHQL_INTROSPECTION_TOKEN>",
        "GRAPHQL_MAX_TOOLS": "<YOUR_GRAPHQL_MAX_TOOLS>",
        "GRAPHQL_INCLUDE_MUTATIONS": "<YOUR_GRAPHQL_INCLUDE_MUTATIONS>",
        "GRAPHQL_MAX_RETRIES": "<YOUR_GRAPHQL_MAX_RETRIES>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-graphql-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_API_URL": "<YOUR_GRAPHQL_API_URL>",
        "GRAPHQL_INTROSPECTION_URL": "<YOUR_GRAPHQL_INTROSPECTION_URL>",
        "GRAPHQL_TOKEN": "<YOUR_GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<YOUR_GRAPHQL_INTROSPECTION_TOKEN>",
        "GRAPHQL_MAX_TOOLS": "<YOUR_GRAPHQL_MAX_TOOLS>",
        "GRAPHQL_INCLUDE_MUTATIONS": "<YOUR_GRAPHQL_INCLUDE_MUTATIONS>",
        "GRAPHQL_MAX_RETRIES": "<YOUR_GRAPHQL_MAX_RETRIES>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-graphql-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-graphql-bridge"
      ],
      "env": {
        "GRAPHQL_API_URL": "<YOUR_GRAPHQL_API_URL>",
        "GRAPHQL_INTROSPECTION_URL": "<YOUR_GRAPHQL_INTROSPECTION_URL>",
        "GRAPHQL_TOKEN": "<YOUR_GRAPHQL_TOKEN>",
        "GRAPHQL_INTROSPECTION_TOKEN": "<YOUR_GRAPHQL_INTROSPECTION_TOKEN>",
        "GRAPHQL_MAX_TOOLS": "<YOUR_GRAPHQL_MAX_TOOLS>",
        "GRAPHQL_INCLUDE_MUTATIONS": "<YOUR_GRAPHQL_INCLUDE_MUTATIONS>",
        "GRAPHQL_MAX_RETRIES": "<YOUR_GRAPHQL_MAX_RETRIES>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-graphql-bridge --env GRAPHQL_API_URL=<YOUR_GRAPHQL_API_URL> --env GRAPHQL_INTROSPECTION_URL=<YOUR_GRAPHQL_INTROSPECTION_URL> --env GRAPHQL_TOKEN=<YOUR_GRAPHQL_TOKEN> --env GRAPHQL_INTROSPECTION_TOKEN=<YOUR_GRAPHQL_INTROSPECTION_TOKEN> --env GRAPHQL_MAX_TOOLS=<YOUR_GRAPHQL_MAX_TOOLS> --env GRAPHQL_INCLUDE_MUTATIONS=<YOUR_GRAPHQL_INCLUDE_MUTATIONS> --env GRAPHQL_MAX_RETRIES=<YOUR_GRAPHQL_MAX_RETRIES> -- npx -y mcp-graphql-bridge