spillway-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOCAL_GPU_PROFILE | No | Hardware preset for local GPU inference. Valid values: 8gb_vram, 12gb_vram, 24gb_vram_or_mac_unified. | |
| LOCAL_LLM_BASE_URL | No | Base URL for the local OpenAI-compatible LLM server (e.g., http://127.0.0.1:11434/v1 for Ollama). | |
| LOCAL_OLLAMA_MODEL | No | Model name to use with Ollama for local GPU inference (e.g., qwen2.5-coder:14b). | |
| AGY_GIT_REPORT_ONLY | No | Set to 1 to restrict git operations to read-only reporting. | |
| AGY_MAX_CONCURRENCY | No | Maximum number of concurrent Antigravity (cloud) subagent tasks. Default is 1. | 1 |
| AGY_NO_SELF_BOOTSTRAP | No | Set to 1 to prevent the server from automatically bootstrapping configuration (e.g., modifying .mcp.json). | |
| LOCAL_GPU_CONCURRENCY | No | Maximum number of concurrent local GPU tasks. Default is 1. | 1 |
| AGY_DENY_SKIP_PERMISSIONS | No | Set to 1 to disallow skipping permission checks. |
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": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| codex_researchA | Run read-only research through a dedicated headless Codex CLI. Separate serialized queue from agy. No automatic provider/model fallback. Returns exact model/effort, session, usage when available, and retained job evidence. |
| codex_followupA | Continue an explicit completed Spillway Codex session in the same workspace/home and model. Always read-only; never resumes the latest ambient session. |
| codex_job_resultB | Inspect or wait for a Codex job, including retained output and stop evidence. |
| codex_statusA | Codex setup, queue, model and quota status. Quota is unknown; this does not perform inference. |
| codex_cancelA | Cancel a queued or running Codex job. Waits for process-stop evidence; an unconfirmed stop quarantines execution. |
| agy_delegate_researchA | Delegate deep read-only codebase research, cross-module architectural analysis, bug root-cause tracing, or security verification to Google Antigravity CLI (agy) using verified Gemini 3.8 Flash or Gemini 4 Argon models in --mode=plan. SERIALIZATION & ASYNC BUDGET: Calls are serialized (one at a time, AGY_MAX_CONCURRENCY = 1); a prompt that needs more than ~8 minutes of agent time should be split into one bounded question per call, or launched expecting to fetch the result by job_id via |
| agy_spawn_swarmA | Dispatch multiple read-only Antigravity subagents using gemini-3.8-flash-low or gemini-3.8-flash-medium across strictly disjoint directory partitions. SERIALIZATION & ASYNC BUDGET: Tasks run sequentially one after another (one at a time, AGY_MAX_CONCURRENCY = 1) and share the same ~8-minute soft budget ceiling; keep each task prompt bounded or fetch any in-flight task result by job_id via |
| agy_delegate_editA | Delegate complex multi-file code modifications or cross-module refactoring to Antigravity (agy) in --mode=accept-edits. SERIALIZATION & ASYNC BUDGET: Calls are serialized (one at a time, AGY_MAX_CONCURRENCY = 1); split edits needing >~8 minutes into smaller scoped calls or fetch in-flight runs via |
| agy_session_followupA | Resume an existing Antigravity conversation ID (--conversation ) so previously loaded files remain in context cache, automatically compacting the session if context usage exceeds 80%. SERIALIZATION & ASYNC BUDGET: Calls are serialized (one at a time, AGY_MAX_CONCURRENCY = 1); keep follow-ups to one bounded question (<~8 minutes) or fetch in-flight runs by job_id via |
| agy_job_resultA | Fetch the stored output or live status of an Antigravity job by |
| agy_cancelA | Cancel a currently running or queued Antigravity job by |
| agy_configure_workspaceA | Update workspace environment configuration and Antigravity IDE Visual HUD settings. Auto-detects project toolchains (.venv, node_modules/.bin), registers monorepo directories (--add-dir), injects environment variables, optionally syncs .vscode/settings.json, and attaches or launches the Antigravity IDE window. WHEN TO USE: Only when configuring custom virtualenv/monorepo paths or toggling IDE Visual HUD attachment. DO NOT USE FOR: Read-only status or quota checks (use |
| agy_statusA | Inspect current system health, Gemini 5-hour/weekly quota windows, Local GPU VRAM availability ( |
| local_file_scoutA | ZERO-TRUST MEMORY TOOL: Read repository files directly from disk on the server side and use the Local GPU LLM (0x cloud quota) as a strict forensic disk-evidence extractor. Outputs verbatim signatures, imports, and logic with exact 1-based |
| local_exec_and_triageA | Execute allow-listed test, build, typecheck, or lint commands (pytest, npm test, npx tsc, cargo check, go test) in a managed subprocess with Windows process-tree kill protection ( |
| local_draft_leaf_codeA | Draft standalone leaf-node boilerplate, unit test files, DTOs, or schemas on disk using the Local GPU LLM (0x cloud quota). Reads |
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 16 tools
The prefix scheme separates three backends (codex_, agy_, local_), but each backend exposes near-parallel operations — codex_research vs agy_delegate_research, codex_followup vs agy_session_followup, codex_status vs agy_status, codex_cancel vs agy_cancel — so an agent must read the routing rules to pick correctly. Descriptions do a lot of work with explicit 'DO NOT USE FOR' clauses, but the overlapping research/scout/draft/edit triad (local_file_scout vs agy_delegate_research vs local_draft_leaf_code vs agy_delegate_edit) remains genuinely easy to misselect.
A consistent three-prefix scheme (codex_/agy_/local_) groups tools predictably, which is a real strength. Within groups, however, conventions are mixed: verb_noun (agy_delegate_edit, agy_spawn_swarm) sits beside noun-phrase tools (agy_status, agy_job_result, codex_job_result) and odd forms like local_file_scout (noun_verb) and local_exec_and_triage.
Sixteen tools is at the borderline of heavy, and the cost is amplified because the surface duplicates the same lifecycle (research, follow-up, status, cancel, job-result) across two agent backends plus a local tier. Each tool is justified individually, but the aggregate feels larger than the underlying domain requires.
Coverage is broad: research, editing, multi-file delegation, drafting, command execution, session follow-up, job retrieval, cancellation, status, and workspace configuration are all present, so most workflows have a path forward. Minor gaps include no generic file read/list or job-listing operation independent of the status tools, and Codex offers no edit path at all.