OperatorNest tools

Calcula costos de API y suscripciones, horarios de reuniones compartidos, calendarios recurrentes y coincidencias de cron.

GitHub

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Herramientas de OperatorNest

Endpoint MCP alojado: https://operatornest.com/mcp (HTTP Streamable, sin clave API).

Cinco cálculos deterministas de costos, zonas horarias y programación utilizan datos incluidos y las mismas definiciones de herramientas a través de HTTP y stdio, devolviendo entradas normalizadas, unidades, método, suposiciones, fuentes fechadas y un enlace para abrir cada resultado en OperatorNest. Sin llamadas de red. El código fuente TypeScript está incluido; los cálculos no crean eventos, instalan programaciones ni ejecutan tareas.

Herramienta	Resultado
`ai_api_cost`	USD por solicitud, día y mes a partir de recuentos de tokens y tarifas de modelos seleccionados
`meeting_time_zones`	Bloques compartidos de 30 minutos dentro de 09:00–17:00 para 2–8 personas
`recurring_schedule`	Horas mensuales, reglas de recurrencia y un calendario RFC 5545
`ai_subscription_stack_cost`	Totales mensuales y anuales con capacidades superpuestas
`cron_next_runs`	1–10 coincidencias después de un instante UTC, dentro de 366 días

El justfile instala dependencias congeladas, verifica requisitos previos y ejecuta la compilación y las pruebas:

just setup
just doctor
just check

Autoalojamiento

Para desarrollo con checkout, ejecute just setup para instalar Node 26 y pnpm 12. El paquete publicado admite Node.js 22.19 o más reciente.

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 un cliente con soporte stdio, use node con la ruta absoluta a dist/stdio.js como argumento para servir mensajes MCP delimitados por nueva línea en stdin/stdout, manteniendo el tráfico de protocolo separado de los registros escritos en stderr.

El paquete se prepara como @operatornest/mcp-tools versión 1.1.0. Para ejecutar un paquete local a través de npx antes de la publicación en el 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

Después de la publicación en npm, el comando equivalente es npx --yes @operatornest/mcp-tools@1.1.0. La publicación es una acción separada del mantenedor.

Worker HTTP

src/worker.ts exporta un Worker independiente con un endpoint /mcp. Use su propia configuración de Worker; wrangler.jsonc es un punto de partida local. Ejecútelo localmente con:

pnpm dev:worker --port 8787

Conecte un cliente a http://localhost:8787/mcp. Para alojamiento remoto, siga la documentación de configuración del Worker en su propia cuenta.

El manejador HTTP utiliza respuestas JSON sin estado, sin sesiones ni flujos de suscripción, limita los cuerpos de solicitud a 32 KiB, rechaza lotes JSON-RPC y devuelve errores genéricos, con CORS para orígenes HTTPS y acceso de origen local a endpoints locales.

La limitación de velocidad es opcional. Para habilitarla, configure un enlace de limitación de velocidad MCP_LIMITER. Cuando está presente, utiliza un hash SHA-256 de CF-Connecting-IP; el rechazo devuelve HTTP 429 con Retry-After: 60. La falta de IP de cliente o un error de enlace devuelve HTTP 503. Sin enlace, no hay limitación de velocidad.

Configuración del cliente

Estos fragmentos se conectan al endpoint alojado. Sustituya su propia URL HTTPS /mcp para usar su instancia HTTP. Documentación de configuración verificada el 2 de octubre de 2026; los controles de cuenta y espacio de trabajo pueden afectar el acceso a las herramientas.

ChatGPT

Habilite el modo Desarrollador en Configuración → Seguridad e inicio de sesión. En Plugins, use el botón más para crear una aplicación en modo desarrollador con esta URL y Sin autenticación:

https://operatornest.com/mcp

Seleccione la aplicación desde el modo Desarrollador en el menú más de la conversación. Instrucciones oficiales.

Claude

En Claude, abra Personalizar → Conectores, seleccione Agregar conector personalizado e ingrese https://operatornest.com/mcp. Elija Sin inicio de sesión y agregue el conector. Habilítelo para su conversación desde la lista de Conectores del menú más. Los propietarios de organizaciones pueden necesitar agregarlo primero. Instrucciones oficiales del conector.

Para Claude Code:

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

Verifique la conexión con /mcp. Instrucciones oficiales.

Codex

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

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

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

Instrucciones oficiales.

Cursor

Agregue a .cursor/mcp.json en su proyecto, o ~/.cursor/mcp.json para todos los proyectos:

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

Instrucciones oficiales.

CLI de Gemini

Agregue a ~/.gemini/settings.json:

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

Instrucciones oficiales.

VS Code

Agregue .vscode/mcp.json a su proyecto:

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

Inicie el servidor desde el archivo de configuración y habilite sus herramientas en el modo Agente. Instrucciones oficiales.

Datos y límites

Las tarifas de API están congeladas en 2026-09-28T17:08:16.340Z en src/data/pricing-snapshot.json, que contiene 194 modelos de models.dev. Esta es la instantánea filtrada del MCP alojado. Use los valores incluidos de modelId; el catálogo más amplio del sitio web puede incluir registros que este servidor no acepta. Las tarifas nulas permanecen sin listar. El almacenamiento en caché recurre a la tarifa de entrada cuando está ausente; los descuentos por lotes requieren datos publicados. Los cargos no relacionados con tokens están excluidos.

Los planes de suscripción están en src/data/ai-plans.ts, verificados el 27 de septiembre de 2026 con enlaces a fuentes oficiales. Los totales anuales utilizan cargos anuales publicados, o doce cargos mensuales cuando no se lista un cargo anual. Impuestos, diferencias regionales y promociones están excluidos.

Los resultados de reuniones y cron utilizan la base de datos de zonas horarias IANA del runtime. Los calendarios recurrentes usan horas locales flotantes en el calendario importador. Cron admite estrellas numéricas, listas, rangos, pasos y nombres de días de la semana en los dialectos de GitHub, Cloudflare, Quartz y AWS; L, W, # y meses con nombre son rechazados. Los resultados describen estimaciones y vistas previas de programación.

Desarrollo

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

Las pruebas validan esquemas de entrada y salida, llamadas válidas e inválidas, límites HTTP e inicialización/listado/llamada en ambos transportes. Consulte la documentación de la CLI de Inspector, la guía de contribución, el informe de seguridad y la atribución de datos.