agyenvoy
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AGY_BIN | No | Full path to the agy CLI binary, if not on PATH. | |
| MCP_TOOL_TIMEOUT | No | Timeout in milliseconds for MCP requests (default 60000). |
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 |
|---|---|
| agy_askA | Send a prompt to the agy CLI (Antigravity, Gemini-backed) and return its response. Runs agy non-interactively in print mode. Use this for a second opinion from Gemini/Claude/GPT models, to delegate a self-contained task, or to continue a multi-turn agy conversation. Args:
Returns JSON: { "response": string, "model": string, "exit_code": number }. On failure exit_code is non-zero and response contains agy's stderr (e.g. binary not found, timeout). Note: runs agy with --dangerously-skip-permissions so tool actions inside agy are auto-approved (required for non-interactive use). Only invoke with prompts you trust to run unattended. |
| agy_list_modelsA | List the models available to the agy CLI (runs Use before agy_ask to discover valid values for its 'model' argument. Takes no arguments. Returns JSON: { "models": string[] } — e.g. ["Gemini 3.5 Flash (High)", "Gemini 3.1 Pro (High)", "Claude Opus 4.6 (Thinking)"]. |
| agy_auth_statusA | Report whether agy is logged in and how much per-model quota (credit) remains. Reads agy's local account store (~/.antigravity_tools). Never returns the auth token. Takes no arguments. Returns JSON: { "logged_in": boolean, // true if a current account has a valid, non-disabled token "email": string | null, // current account email "name": string | null, // current account display name "accounts": string[], // all known account emails "models_quota": [ { "display_name": string, "percentage": number, "reset_time": string } ] // percentage = remaining credit for that model (100 = full) } Use before agy_ask to confirm agy is usable; if logged_in is false, call agy_login. |
| agy_loginA | Ensure agy is logged in. If already authenticated, returns immediately. Otherwise opens a terminal window running agy so you can complete Google sign-in in your browser (agy drives the OAuth flow itself), then polls agy's account store until a valid account appears and reports the signed-in email. Args:
Returns JSON: { "logged_in": boolean, "email": string | null, "already": boolean, "message": string }.
macOS only (opens Terminal.app). On other platforms, run |
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 4 tools
Each tool has a clear, distinct purpose: asking the CLI, checking auth status, listing models, and logging in. There is no functional overlap or ambiguity among them.
All tool names follow a consistent 'agy_verb' pattern (ask, auth_status, list_models, login) using snake_case. The pattern is predictable and easy for an agent to learn.
With only 4 tools, the server is tightly scoped to the essential operations of the agy CLI: authentication, model discovery, and making requests. Each tool is necessary and there is no bloat.
The tool surface covers the core interaction loop: authenticate, check status, list models, and send prompts. Minor gaps exist—e.g., no tool to list ongoing conversations or manage projects directly—but these are partially addressed via parameters in agy_ask, so agents can still function.