convez.ai
MCP ServerIntegração & APIsIntermediário
DrSmile444

Provider Status MCP

DrSmile444/provider-status-mcp

Agregador de status de quota/rate-limit para Claude, Codex e Copilot

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.4.0
Issues abertas
0
Contribuidores
1

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.
  • --pretty flag 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-mcp
    • codex-status-mcp
    • copilot-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; returns AllProvidersResult
  • 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:

License

MIT


Made with ❤️ by Dmytro Vakulenko, 2026

Ver o original no GitHub

Bom para

Relacionados