Skip to main content
Glama

Antigravity MCP Bridge

Bridge Model Context Protocol (MCP) server connecting Claude Code to Google Antigravity (Gemini) using your local Antigravity session, CLI (agy), and subscription quota.


🎯 What is this?

When using Claude Code, heavy tasks like ingesting massive log dumps, analyzing entire repositories, or inspecting multiple large files (>300 lines) can rapidly consume Claude's context window and Anthropic API tokens.

Antigravity MCP Bridge enables Claude Code to delegate these tasks to Gemini 3.8 Flash or Gemini 4 running via Google Antigravity.

Key Benefits:

  • Massive Context (1M+ Tokens): Offload large codebases, documentation, or log dumps.

  • Zero Additional API Costs: Uses your active Google Antigravity plan/session via agy CLI instead of Google AI Studio or Anthropic tokens.

  • Specialized Consultation: Use Gemini for second opinions, deep code reviews, unit test matrix generation, and Google ecosystem technologies (Go, Android/Kotlin, Flutter, Firebase, Google Cloud).

  • Proactive / Autonomous: Configurable so Claude Code automatically delegates heavy workloads without manual intervention.


Related MCP server: Deep Code Reasoning MCP Server

🚀 Installation & Setup

1. Requirements

2. Clone and install dependencies

git clone https://github.com/JohnMndz/antigravity-mcp-bridge.git
cd antigravity-mcp-bridge
npm install

3. Register in Claude Code

Run the following command to register the MCP server globally for your user:

claude mcp add --scope user antigravity node /path/to/antigravity-mcp-bridge/index.js

(On Windows, use node C:\Users\<Username>\antigravity-mcp-bridge\index.js)

Verify the connection:

claude mcp list

You should see:

antigravity: node .../index.js - √ Connected

⚙️ Configuration & Dynamic Model Selection

The bridge provides two tools:

  • ask_gemini_antigravity: Executes queries using your Antigravity session.

  • list_antigravity_models: Queries agy models in real time so Claude Code always sees the latest models available in your Antigravity account without hardcoding model IDs.

Cost & Quota Optimization Strategy:

  • By default, ask_gemini_antigravity uses gemini-4-hydrogen-medium (or AGY_MODEL env var), which combines low latency, low quota impact, and strong symbol accuracy for massive context reading and guided execution.

  • Use mode ("memory", "review", "execute", or "general") to enforce strict anti-hallucination citations, critical audits, or test-verified edits.

  • When Claude needs deep architectural reasoning or critical second opinions, it can call list_antigravity_models and dynamically escalate to gemini-4-argon-medium or gemini-pro-orchestrator-g1-pro.


🤖 Teaching Claude Code to Use It Automatically

Add the following directive to your global ~/.claude/CLAUDE.md:

## Colaboración y Delegación con Gemini en Antigravity (`ask_gemini_antigravity`)
Usa proactivamente las herramientas MCP de Antigravity para que Gemini (1M+ tokens de contexto) actúe como memoria externa y brazo ejecutor de Claude:

1. **Memoria anti-alucinación (`mode: "memory"`)**:
   - Para búsquedas literales exactas usa `Grep` local.
   - Si necesitas entender un flujo que abarca >3 archivos, archivos pesados (>300 líneas) o logs extensos, NO satures tu ventana de contexto: delega primero a `ask_gemini_antigravity` con `mode: "memory"` para obtener un mapa verificado de firmas, tipos, endpoints y `archivo:línea` reales antes de planificar o editar.
   - En sesiones largas (post-compactación), usa `mode: "memory"` para verificar contratos y call sites antes de tocar archivos críticos.
2. **Segunda opinión y revisión crítica (`mode: "review"`)**: Antes de cambios arquitectónicos sensibles o cuando quieras detectar riesgos de concurrencia, seguridad o casos borde, consulta a Gemini (puedes escalar a `gemini-4-argon-medium`).
3. **Ejecución guiada (`mode: "execute"`)**: Para implementar refactors mecánicos según tu plan, escribir suites completas de tests o iterar errores de build/linter hasta dejarlos en verde. Revisa siempre el `git diff` al terminar.
4. **Selección dinámica de modelo y cuidado de cuota**:
   - Por defecto omite el parámetro `model` para usar **Gemini 4 Hydrogen** (`gemini-4-hydrogen-medium`), rápido, preciso y de bajo consumo de cuota.
   - Escala a `gemini-4-argon-medium` para razonamiento arquitectónico profundo o a `gemini-pro-orchestrator-g1-pro` solo para subtareas autónomas complejas. Consulta `list_antigravity_models` si necesitas verificar los IDs activos.

📄 License

MIT © JohnMndz

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers