mcp.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
  "mcpServers": {
    "context-budget": {
      "type": "streamable-http",
      "url": "https://token-weather-budget.475035492.workers.dev/mcp",
      "extensions": {
        "com.openai": {
          "auth": {
            "type": "none"
          },
          "review": {
            "testCases": [
              {
                "description": "Reference 100000 and usage 65000; no local record or account access.",
                "userPrompt": "My reference budget is 100000 tokens and my current estimate is 65000. How much room remains?",
                "toolsTriggered": "plan_context_budget",
                "expectedOutput": "Call plan_context_budget with reference_limit_tokens=100000 and used_tokens=65000. Return remaining_tokens=35000, fraction=0.65 and weather=Cloudy; task/reserve remain unknown."
              },
              {
                "description": "Separate extra task context from the output reserve.",
                "userPrompt": "Budget 100000, used 65000, add 20000 for my task and reserve 5000 for output. Will that fit?",
                "toolsTriggered": "plan_context_budget",
                "expectedOutput": "Call plan_context_budget with reference_limit_tokens=100000, used_tokens=65000, planned_increase_tokens=20000 and reserved_output_tokens=5000. Return planned usage 90000, remaining 10000 and fits_reference=true."
              },
              {
                "description": "Already over the supplied reference; do not report negative headroom.",
                "userPrompt": "My reference is 100000 tokens, I use 110000, and the next task adds 10000 plus a 5000 output reserve. Show the overage.",
                "toolsTriggered": "plan_context_budget",
                "expectedOutput": "Call plan_context_budget with reference_limit_tokens=100000, used_tokens=110000, planned_increase_tokens=10000 and reserved_output_tokens=5000. Return current overage 10000, planned overage 25000, remaining zero and fits_reference=false."
              },
              {
                "description": "Forecast only from an explicitly supplied scalar future growth estimate; no past-turn array.",
                "userPrompt": "Reference 100000, current usage 65000. Assume growth of 10000 tokens per turn. Forecast five turns.",
                "toolsTriggered": "plan_context_budget",
                "expectedOutput": "Call plan_context_budget with reference_limit_tokens=100000, used_tokens=65000, growth_per_turn_tokens=10000 and sources.growth_per_turn_tokens=assumed. Return totals 75000,85000,95000,105000,115000 and turns_until_reference=4. Explain that this is reference crossing, not actual compaction."
              },
              {
                "description": "Unknown reference is a supported partial calculation.",
                "userPrompt": "I do not know my reference limit. I use 65000 tokens, expect another 20000 and reserve 5000 for output. Calculate what you can.",
                "toolsTriggered": "plan_context_budget",
                "expectedOutput": "Call plan_context_budget with used_tokens=65000, planned_increase_tokens=20000 and reserved_output_tokens=5000, omitting the reference. Return planned usage 90000; remaining, fit and weather stay unknown. Do not guess a model limit."
              }
            ],
            "negativeTestCases": [
              {
                "description": "The remote tool cannot read private current ChatGPT context or account quota. Do not invoke plan_context_budget as a telemetry reader; explain the limitation and request supplied numeric values only if useful.",
                "userPrompt": "Read my actual private ChatGPT context and remaining account quota automatically."
              },
              {
                "description": "Do not send a transcript, credential or prior-turn records to the MCP, and do not call plan_context_budget with them. Explain that only scalar numeric budget inputs are accepted; request a minimal numeric summary.",
                "userPrompt": "Can I send you my full chat transcript and API key so the server can analyse them?"
              },
              {
                "description": "Model/thinking changes, chat moving and compaction controls are unsupported. Do not invoke plan_context_budget for those actions, create chats, alter settings or install hooks; explain the scope.",
                "userPrompt": "Automatically move this chat, change my model and adjust the compaction setting now."
              }
            ]
          }
        }
      }
    }
  }
}