Monitorea la actividad de los agentes rastreando sus check-ins y enviando alertas por correo electrónico cuando un agente no reporta dentro de los intervalos especificados.
También conocido como jdkabattles/forgingstack-watchtower, forgingstack-watchtower
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.0
- Último commit
- 8 nov 2026
- Licencia
- MIT
¿Qué es ForgingStack Watchtower MCP?
Monitorea la actividad de los agentes rastreando sus check-ins y enviando alertas por correo electrónico cuando un agente no reporta dentro de los intervalos especificados.
Resumen generado a partir del README del proyecto
Acerca del MCP server de ForgingStack Watchtower
ForgingStack Watchtower proporciona un sistema de monitoreo para rastrear la actividad de los agentes mediante check-ins periódicos. Está diseñado para desarrolladores que necesitan recibir notificaciones por correo electrónico cuando un agente no reporta dentro de un tiempo definido. El sistema funciona permitiendo a los usuarios registrar un watch con un intervalo y un periodo de gracia específicos, tras los cuales el servicio monitorea cualquier falta de comunicación.
Los usuarios interactúan con este MCP server localmente a través de stdio proporcionando una FORGINGSTACK_API_KEY. El servidor se conecta a un servicio remoto privado que gestiona los check-ins de actividad, las alertas por correo electrónico y la facturación. Aunque los check-ins son gratuitos, registrar un watch y recibir una alerta consumen un crédito cada uno. El servidor incluye herramientas como create_watch, check_in, get_watch, get_credits y get_receipt para gestionar estos procesos. Los usuarios deben registrarse para obtener una API key y los créditos iniciales para comenzar a monitorear agentes.
Qué puedes hacer con él
- 1Monitorear la conectividad de los agentesConfigurar un cronograma de check-in recurrente para asegurar que un agente se mantenga activo y notificarme si deja de responder.
- 2Verificar el saldo de créditosConsultar cuántos créditos quedan en mi cuenta para asegurar que se puedan enviar las alertas.
- 3Silenciar tiempos de inactividad temporalesPosponer un watch durante un número específico de minutos para evitar recibir alertas por correo electrónico innecesarias.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar ForgingStack Watchtower MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar ForgingStack Watchtower MCP en Claude Code
$ claude mcp add --env 'FORGINGSTACK_API_KEY=<YOUR_FORGINGSTACK_API_KEY>' forgingstack-watchtower -- uvx forgingstack-watchtowerInstalar ForgingStack Watchtower MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"forgingstack-watchtower": {
"command": "uvx",
"args": [
"forgingstack-watchtower"
],
"env": {
"FORGINGSTACK_API_KEY": "<YOUR_FORGINGSTACK_API_KEY>"
}
}
}
}Instalar ForgingStack Watchtower MCP en VS Code
.vscode/mcp.json
{
"servers": {
"forgingstack-watchtower": {
"type": "stdio",
"command": "uvx",
"args": [
"forgingstack-watchtower"
],
"env": {
"FORGINGSTACK_API_KEY": "<YOUR_FORGINGSTACK_API_KEY>"
}
}
}
}Instalar ForgingStack Watchtower MCP en VS Code CLI
$ code --add-mcp '{"name":"forgingstack-watchtower","type":"stdio","command":"uvx","args":["forgingstack-watchtower"],"env":{"FORGINGSTACK_API_KEY":"<YOUR_FORGINGSTACK_API_KEY>"}}'Instalar ForgingStack Watchtower MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"forgingstack-watchtower": {
"command": "uvx",
"args": [
"forgingstack-watchtower"
],
"env": {
"FORGINGSTACK_API_KEY": "<YOUR_FORGINGSTACK_API_KEY>"
}
}
}
}Instalar ForgingStack Watchtower MCP en Codex
$ codex mcp add forgingstack-watchtower --env 'FORGINGSTACK_API_KEY=<YOUR_FORGINGSTACK_API_KEY>' -- uvx forgingstack-watchtowerInstalar ForgingStack Watchtower MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.forgingstack-watchtower] command = "uvx" args = ["forgingstack-watchtower"] [mcp_servers.forgingstack-watchtower.env] FORGINGSTACK_API_KEY = "<YOUR_FORGINGSTACK_API_KEY>"
Instalar ForgingStack Watchtower MCP en Gemini CLI
$ gemini mcp add -s user -e 'FORGINGSTACK_API_KEY=<YOUR_FORGINGSTACK_API_KEY>' forgingstack-watchtower uvx -- forgingstack-watchtowerInstalar ForgingStack Watchtower MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"forgingstack-watchtower": {
"command": "uvx",
"args": [
"forgingstack-watchtower"
],
"env": {
"FORGINGSTACK_API_KEY": "<YOUR_FORGINGSTACK_API_KEY>"
}
}
}
}Configuración
FORGINGSTACK_API_KEYObligatorioSecretoAPI key for Watchtower. Sign up via POST /v1/signup (key shown once). Required for all tools except check_in, which needs only watch_id and checkin_key.
FORGINGSTACK_API_BASEWatchtower API base URL. Live default.
| Nombre | Descripción | Tipo |
|---|---|---|
| FORGINGSTACK_API_KEY | API key for Watchtower. Sign up via POST /v1/signup (key shown once). Required for all tools except check_in, which needs only watch_id and checkin_key. | ObligatorioSecreto |
| FORGINGSTACK_API_BASE | Watchtower API base URL. Live default. |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblejdkabattles/forgingstack-watchtower is public and reachablegithub.com/jdkabattles/forgingstack-watchtower ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-08github.com/jdkabattles/forgingstack-watchtower ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from forgingstack-watchtowerAprobado
- No hay avisos críticos en el paquete ni en sus dependencias1 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubForgingStack Watchtower
The agent that stops checking in IS the one you will hear about.
mcp-name: io.github.jdkabattles/forgingstack-watchtower
This is the public client for Watchtower. The service itself — the liveness checks, the alert emails, the receipt chain, the key store, and billing — runs on ForgingStack's private service and is not in this repo. Copying this repo does not give you the service: you still need an API key and credits, from signup below.
Live API: https://forgingstack-watchtower.jkbattles.workers.dev
How it works
- You register a watch on an agent: how often it should check in
(
interval_seconds, 30 to 2,592,000) plus extra quiet time allowed (grace_seconds, 0 to 86,400), and where the alert email goes. One watch per agent per owner. Registering a watch costs 1 credit and returns a check-in key, shown once. - The agent checks in with its watch id and check-in key. Check-ins are free and need no API key.
- If the agent goes quiet past its interval plus grace, Watchtower emails an alert and issues a hash-chained receipt. Each alert costs the watch owner 1 credit; an owner at 0 credits is skipped and the watch stays overdue.
- When the agent checks in again after an alert or overdue period, a recovery receipt is issued. You can also snooze a watch (1 to 1,440 minutes) to silence alerts for a while.
Signup (v1)
curl -X POST https://forgingstack-watchtower.jkbattles.workers.dev/v1/signup \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com"}'
Returns an API key once and 100 starter credits. Save the key immediately — it is stored only as a hash and cannot be shown again. Click the verification link in the signup email before the key can register watches; until then, watch registration returns 403.
Use it (MCP, stdio)
Set the key, then run the MCP server in this repo:
export FORGINGSTACK_API_KEY="your-key-here"
python -m app.mcp_server
Tools: create_watch, check_in, get_watch, get_credits,
get_receipt. See SKILL.md for when to use it and when not to.
Price
1 credit to register a watch, 1 credit per alert, check-ins free.
100 starter credits on signup. Credit packs: $10 for 1,000 credits,
bought with POST /v1/billing/checkout — credits are added once the
payment is verified (usually within the hour).
Files in this repo
app/mcp_server.py— MCP wrapper client (stdio, stdlib only)SKILL.md— when to use it, how to read watch statusagent-card.json— A2A-style discovery cardserver.json— MCP Registry metadatapyproject.toml— package metadata for the MCP client
Preguntas sobre ForgingStack Watchtower MCP
¿Cómo agrego ForgingStack Watchtower MCP a Claude Code?
Ejecuta claude mcp add --env 'FORGINGSTACK_API_KEY=<YOUR_FORGINGSTACK_API_KEY>' forgingstack-watchtower -- uvx forgingstack-watchtower en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego ForgingStack Watchtower MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cuánto cuesta usar Watchtower?
Registrar un watch cuesta 1 crédito y cada alerta cuesta 1 crédito, mientras que los check-ins son gratuitos.
¿Cómo empiezo a usar Watchtower?
Puedes registrarte mediante un comando curl para recibir una API key y 100 créditos de inicio.
¿Puedo silenciar las alertas temporalmente?
Sí, puedes posponer un watch por una duración de entre 1 y 1,440 minutos.
¿Qué pasa si me quedo sin créditos?
Si un propietario tiene 0 créditos, se omitirá durante las alertas y el watch permanecerá en estado de retraso (overdue).