rea
Reverse engineer anything with agents, from app behavior down to native binaries.
Bridges any GraphQL API to Claude Code — auto-generates MCP tools via schema introspection.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Reverse engineer anything with agents, from app behavior down to native binaries.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 4/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 16/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala MCP Graphql Bridge. Sigue https://mcp.popnx.com/i/murilojrpereira-mcp-graphql-bridge.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de MCP Graphql Bridge (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server MCP Graphql Bridge para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "graphql-bridge": { "command": "npx", "args": [ "-y", "mcp-graphql-bridge" ], "env": { "GRAPHQL_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GRAPHQL_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de MCP Graphql Bridge aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa MCP Graphql Bridge y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando MCP Graphql Bridge o muestra una herramienta de MCP Graphql Bridge en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GRAPHQL_API_URL URL del endpoint GraphQL usado para ejecutar consultas y mutaciones. Por defecto, la API pública de Countries. GRAPHQL_INTROSPECTION_URL URL del endpoint GraphQL usado para la introspección del esquema. Por defecto, GRAPHQL_API_URL. GRAPHQL_INTROSPECTION_TOKEN Token Bearer para la introspección del esquema. Por defecto usa GRAPHQL_TOKEN GRAPHQL_MAX_TOOLS Número máximo de herramientas de consulta y mutación generadas. El valor predeterminado es 128. GRAPHQL_INCLUDE_MUTATIONS Establézcalo en false para desactivar las herramientas de modificación y su ejecución. El valor predeterminado es true. GRAPHQL_MAX_RETRIES Reintenta ante respuestas transitorias del servicio upstream. Por defecto, 0. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar MCP Graphql Bridge
MCP Graphql Bridge se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar MCP Graphql Bridge
B · Otros en Herramientas para desarrolladores que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de MCP Graphql Bridge (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server MCP Graphql Bridge para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user graphql-bridge --env GRAPHQL_TOKEN=your-value -- npx -y mcp-graphql-bridge 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GRAPHQL_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de MCP Graphql Bridge aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user graphql-bridge --env GRAPHQL_TOKEN=your-value -- npx -y mcp-graphql-bridgeCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver MCP Graphql Bridge en la lista como conectado
Usa MCP Graphql Bridge y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando MCP Graphql Bridge o muestra una herramienta de MCP Graphql Bridge en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GRAPHQL_API_URL URL del endpoint GraphQL usado para ejecutar consultas y mutaciones. Por defecto, la API pública de Countries. GRAPHQL_INTROSPECTION_URL URL del endpoint GraphQL usado para la introspección del esquema. Por defecto, GRAPHQL_API_URL. GRAPHQL_INTROSPECTION_TOKEN Token Bearer para la introspección del esquema. Por defecto usa GRAPHQL_TOKEN GRAPHQL_MAX_TOOLS Número máximo de herramientas de consulta y mutación generadas. El valor predeterminado es 128. GRAPHQL_INCLUDE_MUTATIONS Establézcalo en false para desactivar las herramientas de modificación y su ejecución. El valor predeterminado es true. GRAPHQL_MAX_RETRIES Reintenta ante respuestas transitorias del servicio upstream. Por defecto, 0. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de MCP Graphql Bridge (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server MCP Graphql Bridge para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "graphql-bridge": { "command": "npx", "args": [ "-y", "mcp-graphql-bridge" ], "env": { "GRAPHQL_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GRAPHQL_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de MCP Graphql Bridge aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de MCP Graphql Bridge, GRAPHQL_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa MCP Graphql Bridge y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando MCP Graphql Bridge o muestra una herramienta de MCP Graphql Bridge en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GRAPHQL_API_URL URL del endpoint GraphQL usado para ejecutar consultas y mutaciones. Por defecto, la API pública de Countries. GRAPHQL_INTROSPECTION_URL URL del endpoint GraphQL usado para la introspección del esquema. Por defecto, GRAPHQL_API_URL. GRAPHQL_INTROSPECTION_TOKEN Token Bearer para la introspección del esquema. Por defecto usa GRAPHQL_TOKEN GRAPHQL_MAX_TOOLS Número máximo de herramientas de consulta y mutación generadas. El valor predeterminado es 128. GRAPHQL_INCLUDE_MUTATIONS Establézcalo en false para desactivar las herramientas de modificación y su ejecución. El valor predeterminado es true. GRAPHQL_MAX_RETRIES Reintenta ante respuestas transitorias del servicio upstream. Por defecto, 0. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de MCP Graphql Bridge (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server MCP Graphql Bridge para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "graphql-bridge": { "type": "stdio", "command": "npx", "args": [ "-y", "mcp-graphql-bridge" ], "env": { "GRAPHQL_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En GRAPHQL_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de MCP Graphql Bridge aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de MCP Graphql Bridge, GRAPHQL_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa MCP Graphql Bridge y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando MCP Graphql Bridge o muestra una herramienta de MCP Graphql Bridge en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
GRAPHQL_API_URL URL del endpoint GraphQL usado para ejecutar consultas y mutaciones. Por defecto, la API pública de Countries. GRAPHQL_INTROSPECTION_URL URL del endpoint GraphQL usado para la introspección del esquema. Por defecto, GRAPHQL_API_URL. GRAPHQL_INTROSPECTION_TOKEN Token Bearer para la introspección del esquema. Por defecto usa GRAPHQL_TOKEN GRAPHQL_MAX_TOOLS Número máximo de herramientas de consulta y mutación generadas. El valor predeterminado es 128. GRAPHQL_INCLUDE_MUTATIONS Establézcalo en false para desactivar las herramientas de modificación y su ejecución. El valor predeterminado es true. GRAPHQL_MAX_RETRIES Reintenta ante respuestas transitorias del servicio upstream. Por defecto, 0. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user graphql-bridge --env GRAPHQL_TOKEN=your-value -- npx -y mcp-graphql-bridgeClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"graphql-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "your-value"
}
}
}
}GRAPHQL_API_URL envGRAPHQL_INTROSPECTION_URL envGRAPHQL_TOKEN secreto obligatorio envGRAPHQL_INTROSPECTION_TOKEN secreto envGRAPHQL_MAX_TOOLS envGRAPHQL_INCLUDE_MUTATIONS envGRAPHQL_MAX_RETRIES envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub murilojrpereira, dueña del repo
Último cambio de código: hace 3 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para mcp-graphql-bridge@2.1.0
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/murilojrpereira-mcp-graphql-bridge)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: GRAPHQL_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 3 días, y la última versión (2.1.0) llegó al registro hace 4 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP servers
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| Este MCP Graphql Bridge | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | En la nube o instalado en tu equipo |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | Sí | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| Licencia | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
A generic MCP (Model Context Protocol) server that bridges any GraphQL API to Claude Code. It introspects your GraphQL schema and exposes each query and mutation as an individual tool, letting Claude interact with your API directly.
On startup the server will:
schema-introspection.json file in the working directory (fast, no network call)GRAPHQL_INTROSPECTION_URLquery__ ) and one per mutation (mutation__ )execute_graphql fallback tool and a get_type_details explorer toolnpm install -g mcp-graphql-bridge
git clone https://github.com/murilojrpereira/mcp-graphql-bridge.git
cd mcp-graphql-bridge npm install npm run build
| Variable | Required | Description |
|---|---|---|
GRAPHQL_API_URL | No | Endpoint used for queries and mutations. Defaults to a public demo API (countries.trevorblades.com) if unset — replace with your own for real use. |
GRAPHQL_INTROSPECTION_URL | No | Endpoint used for schema introspection. Defaults to GRAPHQL_API_URL if unset. |
GRAPHQL_TOKEN | No | Bearer token for GraphQL authentication (used for query/mutation execution). Omit for public APIs. |
GRAPHQL_INTROSPECTION_TOKEN | No | Bearer token for schema introspection, if it requires different credentials than execution (e.g. a separate schema registry). Defaults to GRAPHQL_TOKEN if unset. |
MCP_AUTH_TOKEN | No | Bearer token required by the hosted /mcp HTTP endpoint when MCP_TRANSPORT=http |
GRAPHQL_MAX_TOOLS | No | Maximum number of query/mutation tools to register. Queries are prioritized over mutations when truncating. Default 128. |
GRAPHQL_INCLUDE_MUTATIONS | No | Set to false to exclude every mutation field entirely, for a read-only deployment. Default true. |
GRAPHQL_MAX_RETRIES | No | Retries (0–5) for 429/502/503/504 responses, honoring Retry-After when present. Default 0 (disabled). |
For schemas with hundreds of fields (GitHub's GraphQL API has 284 root fields — 32 queries, 252 mutations), GRAPHQL_MAX_TOOLS and GRAPHQL_INCLUDE_MUTATIONS are what keep registration bounded and predictable. If the cap truncates the schema, stderr logs exactly how many queries/mutations were registered vs. available.
No configuration is required to try the server — with nothing set, it starts against the public demo API above and logs that it's doing so. See docs/architecture.md for the full token model and why the GraphQL endpoint is fixed per deployment rather than a per-request parameter.
You can set these in a .env file at the project root:
GRAPHQL_API_URL=https://your-api.example.com/graphql
GRAPHQL_INTROSPECTION_URL=https://your-api.example.com/graphql GRAPHQL_TOKEN=your-bearer-token
Or pass them directly via the claude mcp add command (see below).
By default the server introspects your schema live on startup — no file needed, and it automatically retries at a shallower query depth if your API rejects the full-depth attempt (some APIs, especially CDN-fronted ones, enforce a query depth limit). Use this step only if your API has introspection disabled entirely in production, or you want faster startup times:
curl -s -X POST https://your-api.example.com/graphql \
-H "Content-Type: application/json" \ -H "Authorization: Bearer your-bearer-token" \ -d '{"query":"{ __schema { queryType { fields { name description args { name description defaultValue type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } } mutationType { fields { name description args { name description defaultValue type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } } } }"}' \
schema-introspection.json
If your API rejects this with a depth/complexity-limit error, shrink the ofType { ... } nesting (each level resolves one more NonNull/List wrapper — most real-world types need 2-3 levels; only doubly-wrapped lists like [[Int!]!]! need more).
If installed from npm:
claude mcp add --transport stdio \
--env GRAPHQL_API_URL=https://your-api.example.com/graphql \ --env GRAPHQL_INTROSPECTION_URL=https://your-api.example.com/graphql \ --env GRAPHQL_TOKEN=your-bearer-token \ graphql-bridge -- mcp-graphql-bridge
If cloned from source:
claude mcp add --transport stdio \
--env GRAPHQL_API_URL=https://your-api.example.com/graphql \ --env GRAPHQL_INTROSPECTION_URL=https://your-api.example.com/graphql \ --env GRAPHQL_TOKEN=your-bearer-token \ graphql-bridge -- node /absolute/path/to/mcp-graphql-bridge/dist/index.js
Important: Make sure to use
mcp-graphql-bridge/dist/index.js(the compiled output), notmcp-graphql-bridge/index.js. The TypeScript source must be built first withnpm run build, and the entry point is in thedist/folder.
.mcp.json)claude mcp add --transport stdio --scope project \
--env GRAPHQL_API_URL=https://your-api.example.com/graphql \ --env GRAPHQL_INTROSPECTION_URL=https://your-api.example.com/graphql \ --env GRAPHQL_TOKEN=your-bearer-token \ graphql-bridge -- mcp-graphql-bridge
Note: Use absolute paths. All
--envand--transportflags must come before the server name.
claude mcp list
Then in a Claude Code session, run /mcp to see available servers and tools.
This server is published to the official MCP Registry as io.github.murilojrpereira/mcp-graphql-bridge, so MCP clients that browse the registry can discover and install it from there.
Two worked walkthroughs — a small public schema with no configuration needed, then a large, real enterprise-scale schema requiring auth and tool-count limits.
This is the zero-config default — nothing to install or configure beyond the server itself.
claude mcp add --transport stdio graphql-countries -- mcp-graphql-bridge
/mcp to confirm graphql-countries is connected). You should see tools like query__country, query__countries, and query__continents.Using graphql-countries, find the country with code "BR", then list its continent's other countries.
Claude calls query__country({ code: "BR", __fields: "{ name continent { code name } }" }), then query__continent or query__countries({ __fields: "{ name }" }) filtered by the result.
Look up the country with code "ZZZ".
Returns the GraphQL API's own error text — the bridge passes it through rather than masking it.
GitHub's GraphQL API has 284 root fields (32 queries, 252 mutations) — far more than the GRAPHQL_MAX_TOOLS default of 128, and it needs a token for every request, including introspection (unlike GitHub's REST API, which allows some anonymous reads).
export GH_TOKEN=ghp_your_personal_access_token # or: source a gitignored .env file first
claude mcp add --transport stdio graphql-github \ --env GRAPHQL_API_URL=https://api.github.com/graphql \ --env GRAPHQL_INTROSPECTION_URL=https://api.github.com/graphql \ --env GRAPHQL_TOKEN=$GH_TOKEN \ --env GRAPHQL_INCLUDE_MUTATIONS=false \ graphql-bridge -- mcp-graphql-bridge
GRAPHQL_INCLUDE_MUTATIONS=false registers all 32 (read-only) queries and zero mutations — comfortably under the cap, and a meaningfully safer default for an AI agent than exposing all 252 write operations.
Using graphql-github, look up the repository facebook/react and tell me its star count.
Claude calls query__repository({ owner: "facebook", name: "react", __fields: "{ name stargazerCount }" }).
GRAPHQL_INCLUDE_MUTATIONS=false and raise the cap (GRAPHQL_MAX_TOOLS=400), understanding that this exposes write access to your GitHub account scoped to whatever permissions your token has.| Tool | Description |
|---|---|
query__ | One tool per GraphQL query field |
mutation__ | One tool per GraphQL mutation field |
execute_graphql | Generic fallback — run any query or mutation (mutations rejected if GRAPHQL_INCLUDE_MUTATIONS=false) |
get_type_details | Explore fields of a specific GraphQL type |
All per-operation tools accept a special __fields argument where you can provide a custom GraphQL selection set (e.g. { id name status }). If omitted, only scalar fields are returned.
Per-call auth override: every tool (including execute_graphql) also accepts bearer_token and custom_headers arguments. If provided, they override GRAPHQL_TOKEN/no-auth for that single request only, letting Claude switch credentials per call without restarting the server.
bearer_token, custom_headers) but never the destination host — GRAPHQL_API_URL is set once at deployment time. A shared server that let callers redirect it to an arbitrary destination would be a Server-Side Request Forgery (SSRF) primitive; this design rules that out by construction.execute_graphql too: it parses the query and rejects any mutation when this flag is off, rather than only omitting the convenience mutation__* tools while leaving the generic fallback able to run anything./mcp endpoint for public-routable deployments; requests are capped at 10MB.See docs/architecture.md for the full design rationale and SECURITY.md to report a vulnerability.
docker build -t mcp-graphql-bridge .
`bas