OperatorNest tools

Calcule custos de API e assinaturas, horários de reunião compartilhados, agendamentos recorrentes e correspondências de cron.

GitHub

Servidor MCP hospedado

npx add-mcp 'https://operatornest.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Ferramentas OperatorNest

Endpoint MCP hospedado: https://operatornest.com/mcp (HTTP Streamable, sem chave de API).

Cinco cálculos determinísticos de custo, fuso horário e agendamento usam dados agrupados e as mesmas definições de ferramentas via HTTP e stdio, retornando entradas normalizadas, unidades, método, premissas, fontes datadas e um link para abrir cada resultado no OperatorNest. Sem chamadas de rede. O código-fonte TypeScript está incluído; os cálculos não criam eventos, instalam agendamentos ou executam tarefas.

Ferramenta	Resultado
`ai_api_cost`	USD por requisição, dia e mês a partir de contagens de tokens e taxas de modelos selecionados
`meeting_time_zones`	Intervalos compartilhados de 30 minutos dentro de 09:00–17:00 para 2–8 pessoas
`recurring_schedule`	Horas mensais, regras de recorrência e um calendário RFC 5545
`ai_subscription_stack_cost`	Totais mensais e anuais com capacidades sobrepostas
`cron_next_runs`	1–10 correspondências após um instante UTC, dentro de 366 dias

O justfile instala dependências congeladas, verifica pré-requisitos e executa a compilação e os testes:

just setup
just doctor
just check

Auto-hospedagem

Para desenvolvimento com checkout, execute just setup para instalar Node 26 e pnpm 12. O pacote publicado suporta Node.js 22.19 ou mais recente.

git clone https://github.com/OperatorNest/mcp-tools.git
cd mcp-tools
pnpm install --frozen-lockfile
pnpm test:local
pnpm build
node dist/stdio.js

Para um cliente com suporte a stdio, use node com o caminho absoluto para dist/stdio.js como argumento para servir mensagens MCP delimitadas por nova linha em stdin/stdout, mantendo o tráfego de protocolo separado dos logs gravados em stderr.

O pacote é preparado como @operatornest/mcp-tools versão 1.1.0. Para executar um pacote local via npx antes da publicação no registro:

pnpm pack --out /tmp/operatornest-mcp-tools-1.1.0.tgz
npx --yes --package /tmp/operatornest-mcp-tools-1.1.0.tgz operatornest-mcp-tools

Após a publicação no npm, o comando equivalente é npx --yes @operatornest/mcp-tools@1.1.0. A publicação é uma ação separada do mantenedor.

Worker HTTP

src/worker.ts exporta um Worker autônomo com um endpoint /mcp. Use sua própria configuração de Worker; wrangler.jsonc é um ponto de partida local. Execute-o localmente com:

pnpm dev:worker --port 8787

Conecte um cliente a http://localhost:8787/mcp. Para hospedagem remota, siga a documentação de configuração do Worker em sua própria conta.

O manipulador HTTP usa respostas JSON sem estado, sem sessões ou streams de assinatura, limita corpos de requisição a 32 KiB, rejeita lotes JSON-RPC e retorna erros genéricos, com CORS para origens HTTPS e acesso de origem local a endpoints locais.

A limitação de taxa é opcional. Para ativá-la, configure uma vinculação de limite de taxa MCP_LIMITER. Quando presente, usa um hash SHA-256 de CF-Connecting-IP; a rejeição retorna HTTP 429 com Retry-After: 60. IP de cliente ausente ou erro de vinculação retorna HTTP 503. Sem vinculação, não há limitação de taxa.

Configuração do cliente

Estes trechos conectam ao endpoint hospedado. Substitua sua própria URL HTTPS /mcp para usar sua instância HTTP. Documentação de configuração verificada em 2 de outubro de 2026; controles de conta e workspace podem afetar o acesso às ferramentas.

ChatGPT

Ative o Modo desenvolvedor em Configurações → Segurança e login. Em Plugins, use o botão de adição para criar um aplicativo em modo desenvolvedor com esta URL e Sem autenticação:

https://operatornest.com/mcp

Selecione o aplicativo no Modo desenvolvedor no menu de adição da conversa. Instruções oficiais.

Claude

No Claude, abra Personalizar → Conectores, selecione Adicionar conector personalizado e insira https://operatornest.com/mcp. Escolha Não entrar e adicione o conector. Ative-o para sua conversa na lista de Conectores do menu de adição. Proprietários da organização podem precisar adicioná-lo primeiro. Instruções oficiais do conector.

Para Claude Code:

claude mcp add --transport http operatornest https://operatornest.com/mcp

Verifique a conexão com /mcp. Instruções oficiais.

Codex

codex mcp add operatornest --url https://operatornest.com/mcp

Alternativamente, em ~/.codex/config.toml:

[mcp_servers.operatornest]
url = "https://operatornest.com/mcp"

Instruções oficiais.

Cursor

Adicione a .cursor/mcp.json no seu projeto, ou ~/.cursor/mcp.json para todos os projetos:

{
  "mcpServers": {
    "operatornest": { "url": "https://operatornest.com/mcp" }
  }
}

Instruções oficiais.

CLI Gemini

Adicione a ~/.gemini/settings.json:

{
  "mcpServers": {
    "operatornest": { "httpUrl": "https://operatornest.com/mcp" }
  }
}

Instruções oficiais.

VS Code

Adicione .vscode/mcp.json ao seu projeto:

{
  "servers": {
    "operatornest": { "type": "http", "url": "https://operatornest.com/mcp" }
  }
}

Inicie o servidor a partir do arquivo de configuração e ative suas ferramentas no modo Agente. Instruções oficiais.

Dados e limites

As taxas de API estão congeladas em 2026-09-28T17:08:16.340Z em src/data/pricing-snapshot.json, contendo 194 modelos de models.dev. Este é o snapshot filtrado do MCP hospedado. Use os valores agrupados de modelId; o catálogo mais amplo do site pode incluir registros que este servidor não aceita. Taxas nulas permanecem não listadas. O cache recorre à taxa de entrada quando ausente; descontos por lote exigem dados publicados. Encargos não relacionados a tokens são excluídos.

Os planos de assinatura estão em src/data/ai-plans.ts, verificados em 27 de setembro de 2026 com links de fontes oficiais. Os totais anuais usam encargos anuais publicados, ou doze encargos mensais quando nenhum encargo anual é listado. Impostos, diferenças regionais e promoções são excluídos.

Os resultados de reuniões e cron usam o banco de dados de fusos horários IANA do runtime. Calendários recorrentes usam horários locais flutuantes no calendário de importação. O Cron suporta estrelas numéricas, listas, intervalos, passos e nomes de dias da semana nos dialetos GitHub, Cloudflare, Quartz e AWS; L, W, # e meses nomeados são rejeitados. Os resultados descrevem estimativas e prévias de agendamento.

Desenvolvimento

pnpm check
pnpm test:local
pnpm build
pnpm dlx @modelcontextprotocol/inspector --cli node dist/stdio.js \
  --method tools/call --tool-name cron_next_runs \
  --tool-arg 'expression=0 9 * * 1-5' --tool-arg dialect=github \
  --tool-arg zone=UTC --tool-arg after=2026-10-02T00:00:00Z --tool-arg count=1

Os testes validam esquemas de entrada e saída, chamadas válidas e inválidas, limites HTTP e inicialização/listagem/chamada em ambos os transportes. Veja documentação do CLI Inspector, orientações de contribuição, relato de segurança e atribuição de dados.