Capacity

Provider capacity status and rate limit exhaustion forecasting.

Overview

The Capacity resource provides real-time visibility into provider utilization, rate limit headroom, and budget exhaustion forecasting across all registered providers.

Methods

forecast()

Predict rate limit and budget exhaustion per provider.

const forecast = await client.capacity.forecast();
// { forecasts: [{ provider: "anthropic", avg_requests_per_hour: 45, rate_limit_rpm: 60, exhaustion_estimate: "2h", ... }] }

forecast = client.capacity.forecast()
# forecast["forecasts"][0]["provider"]  # => "anthropic"

Response shape:

{
  "forecasts": [
    {
      "provider": "anthropic",
      "avg_requests_per_hour": 45,
      "peak_requests_per_hour": 60,
      "daily_cost_usd": 12.5,
      "growth_rate_pct": 5.2,
      "rate_limit_rpm": 60,
      "utilization_pct": 75,
      "exhaustion_estimate": "2h",
      "trend": "stable"
    }
  ]
}

providers()

Get per-provider capacity status based on 24-hour rolling window.

const providers = await client.capacity.providers();
// { providers: [{ provider: "openai", health: "healthy", total_requests_24h: 500, success_rate: 98.0 }] }

providers = client.capacity.providers()
# providers["providers"][0]["health"]  # => "healthy"

Response shape:

{
  "providers": [
    {
      "provider": "openai",
      "total_requests_24h": 500,
      "success_rate": 98.0,
      "error_count_24h": 10,
      "avg_latency_ms": 320,
      "total_cost_24h": 4.5,
      "last_used": "2026-03-09T12:00:00Z",
      "health": "healthy"
    }
  ]
}

MCP Tools

Tool	Description	Permission
br_get_capacity	Provider capacity status with 24h metrics and health	router.read