Provider Status MCP
DrSmile444/provider-status-mcp
Agregador de status de quota/rate-limit para Claude, Codex e Copilot
Ver no GitHubServidor MCP que agrega status de quota e rate-limit dos provedores Claude, Codex e Copilot em uma única visualização. Oferece tanto uma CLI com saída JSON/pretty quanto uma ferramenta MCP para que LLMs consultem disponibilidade de todos os backends simultaneamente, com degradação graciosa quando um provedor não está acessível.
Instalação
npx convez-ai DrSmile444/provider-status-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Verificar rapidamente qual provedor de IA está disponível antes de escolher
- Dar a um LLM uma ferramenta única para checar quais backends está conseguindo acessar
- Monitorar rate limits e quotas de múltiplos provedores de IA em paralelo
- Integrar verificação de disponibilidade em workflows de desenvolvimento
Veredito

MCP prático que resolve um problema real: unificar visibilidade de status em múltiplos provedores de IA. Bem arquitetado com degradação graciosa, API programática clara e saídas bem formatadas. Útil para quem trabalha com múltiplos LLMs em produção.
README
A tradução para o português deste README ainda está na fila.
provider-status-mcp
Aggregate Claude, Codex, and Copilot status into a single view — for both humans and LLMs.
provider-status-mcp collects quota and rate-limit status from all three AI providers at once and
presents them together. Use it to quickly see which providers are available before choosing one, or
give an LLM a single tool that tells it which AI backends it can reach right now.
claude mcp add --scope user provider-status-mcp -- npx -y provider-status-mcp --mcp
Features
- Fetches Claude, Codex, and Copilot status in parallel using their SDKs — no subprocess spawning.
- Quick-glance box at the top showing all three providers at once with progress bars.
--prettyflag for a detailed human-readable summary.- Single MCP tool
get_provider_status— lets an LLM check all providers in one call. - Graceful degradation: a provider that fails or isn't configured is shown as unavailable.
- Programmatic API: import
fetchAllProviders()directly in your own code.
Quick Start
npx provider-status-mcp --pretty
╔══════════════════════════════════════════════════════════════╗
║ Provider Status — Quick Glance ║
╠══════════════════════════════════════════════════════════════╣
║ Claude ✅ [██░░░░░░░░░░░░░] 13% used (5h) · resets 4h 36m ║
║ Codex ✅ [████████░░░░░░░] 56% used (5h) · resets 4h 42m ║
║ Copilot ⛔ RATE LIMITED · resets 66h 6m ║
╚══════════════════════════════════════════════════════════════╝
━━━ Claude ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ Available
5h: 13.0% used [███░░░░░░░░░░░░░░░░░] 87.0% remaining (resets 4h 36m)
7d: 48.0% used [██████████░░░░░░░░░░] 52.0% remaining (resets 25h)
...
Add to Claude Code:
claude mcp add --scope user provider-status-mcp -- npx -y provider-status-mcp --mcp
Then ask:
Which AI providers are available right now?
Am I rate limited on any provider?
Requirements
- Node.js 18 or newer.
- At least one of the individual provider packages available via
npx:claude-status-mcpcodex-status-mcpcopilot-status-mcp
Each provider is invoked separately. Providers that can't be reached are shown as unavailable rather than causing the whole command to fail.
CLI Usage
Default — JSON output
npx provider-status-mcp
{
"claude": { "name": "Claude", "available": true, "rateLimited": false, "primaryWindow": { "label": "5h", "percentUsed": 13, "percentRemaining": 87, "resetsAt": "..." }, ... },
"codex": { "name": "Codex", "available": true, "rateLimited": false, "primaryWindow": { "label": "5h", "percentUsed": 56, "percentRemaining": 44, "resetsAt": "..." }, ... },
"copilot": { "name": "Copilot", "available": false, "rateLimited": true, "primaryWindow": { "label": "5h session", "percentUsed": 100, "percentRemaining": 0, "resetsAt": "..." }, ... }
}
Pretty output
npx provider-status-mcp --pretty
All flags
npx provider-status-mcp [options]
Options:
--pretty Quick-glance box + per-provider details.
--timeout-ms <ms> Per-provider timeout in milliseconds (default: 30000).
--mcp Run as an MCP stdio server.
--help, -h Show help.
Programmatic Usage
Install and import directly in your own code:
npm install provider-status-mcp
import { fetchAllProviders } from "provider-status-mcp";
const { claude, codex, copilot } = await fetchAllProviders();
if (!copilot.available) {
console.log(`Copilot rate limited, resets ${copilot.primaryWindow?.resetsAt}`);
}
// Pick the first available provider
const available = [claude, codex, copilot].find(p => p.available);
console.log(`Use ${available?.name}`);
The package exports:
fetchAllProviders(options?)— fetches all three providers in parallel; returnsAllProvidersResult- Types:
AllProvidersResult,ProviderStatus,RateWindow,FetchOptions
Each provider SDK is called directly (no subprocess spawning), so errors surface as typed exceptions.
MCP Setup
The MCP server exposes one tool: get_provider_status.
Returns the same JSON as the CLI. Optional arguments:
{ "timeoutMs": 30000 }
Claude Code
claude mcp add --scope user provider-status-mcp -- npx -y provider-status-mcp --mcp
Equivalent MCP JSON:
{
"mcpServers": {
"provider-status-mcp": {
"command": "npx",
"args": ["-y", "provider-status-mcp", "--mcp"]
}
}
}
Local Development
npm install
npm run build
# The package.json uses file: references to local siblings during development:
# "claude-status-mcp": "file:../claude-usage-mcp"
# "codex-status-mcp": "file:../codex-status-mcp"
# "copilot-status-mcp": "file:../copilot-status-mcp"
# When publishing, replace these with real version ranges.
npm run status:pretty
Related Packages
These packages are part of the same family of AI provider status tools:
- claude-status-mcp — Claude OAuth usage and rate-limit windows
- codex-status-mcp — Codex / ChatGPT rate-limit windows and credits
- copilot-status-mcp — GitHub Copilot session, weekly, and monthly quota
License
MIT
Made with ❤️ by Dmytro Vakulenko, 2026