Agy Bridge
by sshahzaiibcommunityv0.3.1
8
2
An MCP bridge that routes Claude Code tasks to the Antigravity CLI (`agy`) so heavy work like file analysis, deep repository searches, web lookups, and code reviews happens outside Claude's context window. It supports per-tool model routing, session continuation, output truncation, and quota-aware failover.
From the registry: Delegate heavy tasks from Claude Code to the Antigravity CLI (Gemini) with quota-aware failover.
Install & configure
Prerequisites
- requiredInstall Node.js 18+Node.js version 18 or newer is required to run the MCP server via npx.https://nodejs.org/
- requiredInstall and authenticate Antigravity CLI (agy)The agy CLI must be installed and authenticated before using the bridge, since the MCP server delegates work to it.https://antigravity.google/docs/cli-getting-started
- requiredInstall Claude CodeThe README lists Claude Code as a requirement for the documented setup.https://docs.anthropic.com/en/docs/claude-code
- optionalOptional: add delegation rules fileDownload the provided CLAUDE.md rules file into your project or ~/.claude/CLAUDE.md for global usage guidance.
https://raw.githubusercontent.com/sshahzaiib/agy-bridge/main/CLAUDE.md$ curl -o CLAUDE.md https://raw.githubusercontent.com/sshahzaiib/agy-bridge/main/CLAUDE.md
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `agy-bridge` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 18+** — Node.js version 18 or newer is required to run the MCP server via npx. (https://nodejs.org/)
- **Install and authenticate Antigravity CLI (agy)** — The agy CLI must be installed and authenticated before using the bridge, since the MCP server delegates work to it. (https://antigravity.google/docs/cli-getting-started)
- **Install Claude Code** — The README lists Claude Code as a requirement for the documented setup. (https://docs.anthropic.com/en/docs/claude-code)
Optional prerequisites:
- Optional: add delegation rules file — Download the provided CLAUDE.md rules file into your project or ~/.claude/CLAUDE.md for global usage guidance. Run: `curl -o CLAUDE.md https://raw.githubusercontent.com/sshahzaiib/agy-bridge/main/CLAUDE.md` (https://raw.githubusercontent.com/sshahzaiib/agy-bridge/main/CLAUDE.md)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","agy-bridge"]
- optional environment variables:
- `AGY_PATH`: Path to the agy binary. (example: `<path-to-agy-binary>`)
- `AGY_TIMEOUT`: Timeout in seconds for all tools; overrides per-tool defaults and is passed as --print-timeout. (example: `<timeout-seconds>`)
- `AGY_MAX_OUTPUT_CHARS`: Maximum number of output characters returned by the bridge before truncation. (example: `<max-output-chars>`)
- `AGY_DEFAULT_MODEL`: Fallback model name used when no preferred chain entry is available. (example: `<model-name>`)
- `AGY_SKIP_PERMISSIONS`: Whether to pass --dangerously-skip-permissions to agy. (example: `<true-or-false>`)
- `AGY_SANDBOX`: Whether to run agy with --sandbox. (example: `<true-or-false>`)
- `AGY_ON_FAILURE`: Failure behavior; set to strict to instruct the calling agent not to do the delegated work itself after a failure. (example: `<fallback-or-strict>`)
Note: The README's client-specific command `claude mcp add -s user agy-bridge npx -- -y agy-bridge` wraps the canonical stdio config. The server itself runs via stdio using `npx -y agy-bridge`. No environment variables are required by the bridge itself, but the underlying agy CLI must already be installed and authenticated.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README's client-specific command `claude mcp add -s user agy-bridge npx -- -y agy-bridge` wraps the canonical stdio config. The server itself runs via stdio using `npx -y agy-bridge`. No environment variables are required by the bridge itself, but the underlying agy CLI must already be installed and authenticated.
Tools (6)
analyze_files
Analyze large files, multiple files, logs, dumps, or generated code
deep_search
Search git history and perform repo-wide greps or blame/diff/log archaeology
web_lookup
Look up external documentation, API references, and current web knowledge
adversarial_review
Critique plans, designs, and code reviews
follow_up
Continue a prior agy session using a session_id without resending context
delegate
Delegate other heavy tasks to agy
Environment variables
AGY_PATHPath to the agy binaryAGY_TIMEOUTOverrides the per-tool timeout in secondsAGY_MAX_OUTPUT_CHARSMaximum characters of tool output to returnAGY_DEFAULT_MODELFallback model when no preference chain entry is availableAGY_SKIP_PERMISSIONSPasses --dangerously-skip-permissions to agyAGY_SANDBOXRuns agy with --sandboxAGY_ON_FAILUREControls failure behavior, including strict mode instructions on delegation errorsPrerequisites
- • Node.js 18+
Packages
agy-bridge
npmv0.3.1transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Jun 12, 2026
- Last commit
- Jun 13, 2026
- Registry name
- io.github.sshahzaiib/agy-bridge
Categories
Related Servers
Netdata
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
79.8k
Codebase Memory Mcp
Persistent codebase knowledge graph. Survives session restarts and context compaction.
35.4k
Oh My Posh Validator
Validate oh-my-posh configurations and segment snippets against the official schema.
23.2k