antigravity-quota
Connects to the local Google Antigravity 2.0 Language Server to query live 5-hour and 7-day quota limits, per-model quota details, user status, and to start/finish quota tracking with self-learning calibration.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
⚡ Antigravity Quota & Self-Learning Estimator (antigravity-quota)
A zero-dependency Model Context Protocol (MCP) server and Antigravity 2.0 Plugin that connects directly to the local Google Antigravity 2.0 Language Server via ConnectRPC/gRPC-Web over HTTPS.
Enables AI agents to query live 5-hour (5h) and 7-day (weekly) quota limits, forecast how much quota a complex plan will consume via /quota, and self-learn from real pre/post task measurements — including automatic parallel-chat noise detection.
🎯 Key Features
⚡ Zero External Dependencies: Built with pure Node.js standard libraries (
https,child_process,readline,fs). No bulkynode_modulesrequired!💬 Native
/quotaSlash Command: Check live limits instantly or ask "Wie viel/quotawürde dieser Plan verbrauchen?" for a deep consumption forecast.🧠 Self-Learning Calibration Engine (
quota_learnings.json): Records the AI's pre-task consumption estimate alongside a live quota snapshot (start_quota_tracking) and compares it against the actual quota drop once the task completes (finish_quota_tracking). Automatically calculates per-model and per-category calibration multipliers so predictions become more accurate with every task.🛡️ Automatic Parallel-Chat Noise Isolation: Since Antigravity quotas are shared account-wide across all open chats, running parallel conversations during a task would normally skew the measured delta.
antigravity-quotaautomatically inspects localtranscript.jsonllogs across all active conversations during the task window, calculates the exact weighted token share of the tracked chat vs. background chats, and isolates true task consumption (attributed5hUsedPercentvs.raw5hUsedPercent).🔍 Autonomous ConnectRPC Discovery: Automatically locates running
language_server.exeprocesses, extracts the ephemeral--csrf_token, and negotiates the active HTTPS port.
Related MCP server: llm-quota-mcp
💬 The /quota Slash Command
bundled in skills/quota/SKILL.md:
Quick Status Check:
/quotaOutputs a compact summary of remaining 5-hour and weekly percentages and countdown timers for Gemini and Claude/GPT models.
Deep Plan & Task Consumption Forecast:
Wie viel /quota würde der Plan verbrauchen?Inspects the planned scope (files, tool calls, subagents, model tier).
Consults
quota_learnings.jsonfor historical benchmarks and self-corrects usingcalibrationMultiplier.Calls
start_quota_trackingto snapshot current limits and store the estimate.Upon task completion, calls
finish_quota_trackingto measure real consumption, check for parallel chat interference, and update the learning store.
🛠️ Available MCP Tools
Tool | Description |
| Returns live 5-hour and 7-day (weekly) quota buckets ( |
| Returns per-model live quota info and capabilities across all 13+ active models (Gemini 4 Argon, Gemini 3.8 Flash/Pro, Claude 3.7 Sonnet, etc.). |
| Returns user account tier ( |
| Snapshots live 5h & weekly quotas before a task starts and records the AI's estimated consumption in |
| Measures the real post-task quota drop, scans |
| Retrieves historical task benchmarks, accuracy multipliers, and past runs filtered by model or category. |
🧠 How Self-Learning & Parallel-Chat Detection Works
flowchart LR
A["User asks: /quota for Plan"] --> B["AI queries get_quota_learnings"]
B --> C["AI calls start_quota_tracking (Snapshot + Estimate)"]
C --> D["Task Execution"]
D --> E["AI calls finish_quota_tracking"]
E --> F["Scans ~/.gemini/antigravity/brain/*/transcript.jsonl"]
F --> G{"Parallel Chats Active?"}
G -- No --> H["100% Clean Isolated Learning (Weight 1.0)"]
G -- Yes --> I["Proportional Token-Share Isolation + Warning"]
H --> J["Updates quota_learnings.json"]
I --> JWhen finish_quota_tracking runs, it returns a detailed breakdown:
estimated5hPercent: What the AI predicted before starting.raw5hUsedPercent: Total account-wide 5h quota drop during the task window.attributed5hUsedPercent: Isolated quota consumption attributed to this specific chat based onthisChatTokenShare.parallelNoise5hPercent: Quota consumed by other chats running in parallel during the same timeframe.parallelActivity.warningNote: Explicit warning if background chats were active.
🚀 Setup & Installation
1. Register the MCP Server (~/.gemini/config/mcp_config.json)
{
"mcpServers": {
"antigravity-quota": {
"command": "node",
"args": [
"D:/Projekte/AGY-MCP/antigravity-quota/server.js"
]
}
}
}2. Enable the Plugin & /quota Skill
Copy or link this repository into ~/.gemini/config/plugins/antigravity-quota so Antigravity automatically loads plugin.json, skills/quota/SKILL.md, and rules/AGENTS.md.
📜 License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Meter, cap, and block AI agent spend before the provider is charged.
Agent FinOps Spend Guard, Deterministic Budget Passport, LLM Token Cost Router & VIP Discounts.
LLM API prices and AI agent cost estimates, verified daily. Read-only cost lookup tools.
Rent A100 and H100 GPUs by the minute from your agent, within a spending limit you set.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides coding agents with pre-flight cost estimation by analyzing local logs to forecast token usage and quota impact before expensive work, exposing tools for remaining quota, per-task cost estimates, and attempt affordability.132 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables agents to check remaining Anthropic and OpenAI rate-limit quotas with reset times, plus Hermes Agent token usage, so bots can throttle or stop before hitting limits.MIT
- AlicenseNot gradedqualityBmaintenanceLets a coding agent inspect its own account's subscription limit windows, usage, and cost history, and decide whether to pause and sleep until a limit resets rather than failing mid-task. Supports multiple accounts and providers such as Claude Code and Codex.MIT
- AlicenseAqualityCmaintenanceLets an AI agent check its own Claude and Codex usage limits — used percentages and exact reset times for session and weekly windows — so it can plan long-running work around resets instead of dying mid-task. It reads local, credential-free sources by default, always reports which source answered, and ships a hook that pushes quota state into context automatically.1MIT