claude-agy-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AGY_PATH | No | Path to the agy binary | agy |
| AGY_SANDBOX | No | Run agy with --sandbox | false |
| AGY_TIMEOUT | No | Seconds; overrides the ceiling for every tool, passed as --print-timeout, enforced with a 15s kill grace | 3600 |
| AGY_ON_FAILURE | No | strict appends an instruction to failed-tool errors telling the calling agent not to absorb the work itself | fallback |
| AGY_MAX_RUNTIME | No | Seconds; absolute runtime ceiling. The bridge never kills for inactivity — only cancellation, quota, or this | 3600 |
| AGY_DEFAULT_MODEL | No | Fallback model when no chain entry is available | Gemini 3.6 Flash (High) |
| AGY_MAX_OUTPUT_CHARS | No | Truncation cap for tool output | 50000 |
| AGY_SKIP_PERMISSIONS | No | Pass --dangerously-skip-permissions to agy | true |
| AGY_TIMEOUT_DELEGATE | No | Seconds; overrides the ceiling for the delegate tool. Wins over AGY_TIMEOUT | 3600 |
| AGY_TIMEOUT_FOLLOW_UP | No | Seconds; overrides the ceiling for the follow_up tool. Wins over AGY_TIMEOUT | 3600 |
| AGY_TIMEOUT_WEB_LOOKUP | No | Seconds; overrides the ceiling for the web_lookup tool. Wins over AGY_TIMEOUT | 3600 |
| AGY_TIMEOUT_DEEP_SEARCH | No | Seconds; overrides the ceiling for the deep_search tool. Wins over AGY_TIMEOUT | 3600 |
| AGY_TIMEOUT_ANALYZE_FILES | No | Seconds; overrides the ceiling for the analyze_files tool. Wins over AGY_TIMEOUT | 3600 |
| AGY_TIMEOUT_ADVERSARIAL_REVIEW | No | Seconds; overrides the ceiling for the adversarial_review tool. Wins over AGY_TIMEOUT | 3600 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| analyze_filesA | Delegate file analysis to the Antigravity CLI (Gemini) instead of reading files yourself. USE THIS whenever a file is large (>200 lines) or the task spans more than 3 files: logs, database dumps, generated code, cross-file reviews, comparisons. The files never enter your context — only the answer does. |
| deep_searchA | Delegate codebase archaeology to the Antigravity CLI: git log/diff/blame spelunking, wide greps across a repo, 'when/why did X change', 'where is Y used'. USE THIS instead of running many search commands yourself — it saves your context. |
| web_lookupA | Delegate a web/documentation lookup to the Antigravity CLI (Gemini with web access): library docs, API references, error messages, current versions, external knowledge. USE THIS when you need information you don't have or that may be newer than your training data. |
| adversarial_reviewA | Get an adversarial second opinion from a different model family (Gemini Pro). ALWAYS use this for plan critiques, design reviews, and pre-merge code review: it hunts for flaws, edge cases, security issues, and unstated assumptions you may have missed. Pass either |
| follow_upA | Continue a previous Antigravity session by session_id (returned by every other tool). USE THIS for follow-up questions about a prior delegation — the full prior context is already on agy's side, so you don't resend anything. Pass |
| delegateA | Raw delegation to the Antigravity CLI for heavy tasks that don't fit the other tools. Read-only by default; pass |
| delegate_manyA | Fan one question out to several models at once (a council, with a disagreement report), or fan several sub-tasks out to one model. Runs behind the same concurrency cap as everything else, so it queues rather than stampedes the shared quota. |
| set_modelA | Choose the model and reasoning tier every tool uses from now on, on this machine. Ask the user first — "proceed with the default, or change model or effort?" — then call this once: with no arguments to accept the default, or with what they chose. The choice is saved and no tool asks again. An explicit |
| agy_statusA | What this bridge has spent and what it can still do: tokens by model, live quota cooldowns, runs in flight, the resolved model chain per tool, the user's set_model choice, the models agy offers, warm sessions, and the agy version and flags detected at startup. Check this before a large fan-out, or to list models before set_model. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Most tools have distinct targets (status, model selection, file analysis, code search, web lookup, review, follow-up), and descriptions give clear 'use this when' guidance. However, the generic `delegate` overlaps conceptually with the specialized delegation wrappers (analyze_files, deep_search, web_lookup), so an agent must rely on the descriptions to route correctly.
Names are mostly snake_case verb_noun or verb_phrase (analyze_files, deep_search, web_lookup, set_model, follow_up), which is readable and predictable. Minor deviations exist: `agy_status` uses an app prefix, `adversarial_review` is adjective_noun, and `delegate`/`delegate_many` differ in style.
Nine tools is well-scoped for a delegation bridge: one status, one config, one follow-up, and a small set of specialized plus generic delegation entry points. Each tool earns its place without bloat.
The surface covers the core lifecycle: configure model, check status/quota, delegate to specialized contexts, review adversarially, and continue sessions. Minor gaps exist around session discovery/listing or cleanup, but agents can work around these via follow_up and agy_status.