Tickstem
Programación cron, monitoreo de disponibilidad, monitoreo de latidos y verificación de correo electrónico como herramientas MCP nativas para Claude Code, Cursor y cualquier agente compatible con MCP.
Documentación
tickstem/mcp
Servidor MCP para Tickstem — expone la programación de trabajos cron, monitoreo de disponibilidad, monitoreo de latidos y verificación de correo electrónico como herramientas nativas para asistentes de codificación con IA (Claude, Cursor, Copilot y cualquier agente compatible con MCP).
Permite que tu asistente de IA registre trabajos cron, cree monitores de disponibilidad con aserciones de respuesta, gestione monitores de latidos, verifique direcciones de correo electrónico y consulte resultados — mientras tú escribes el código de la aplicación.
Instalación
Descarga un binario precompilado (no requiere Go):
| Plataforma | Binario |
|---|---|
| macOS (Apple Silicon) | tsk-mcp-darwin-arm64 |
| macOS (Intel) | tsk-mcp-darwin-amd64 |
| Linux (x86-64) | tsk-mcp-linux-amd64 |
| Linux (ARM64) | tsk-mcp-linux-arm64 |
| Windows (x86-64) | tsk-mcp-windows-amd64.exe |
Descárgalo desde Releases, hazlo ejecutable y colócalo en tu PATH:
# macOS / Linux example
chmod +x tsk-mcp-darwin-arm64
mv tsk-mcp-darwin-arm64 /usr/local/bin/tsk-mcp
O instala con Go:
go install github.com/tickstem/mcp/cmd/tsk-mcp@latest
Inicio rápido
export TICKSTEM_API_KEY=tsk_your_key_here
tsk-mcp
El servidor habla el Protocolo de Contexto de Modelo a través de stdio — conéctalo a cualquier cliente compatible con MCP.
Claude Code
Agrégalo a tu ~/.claude/claude_desktop_config.json (o equivalente):
{
"mcpServers": {
"tickstem": {
"command": "tsk-mcp",
"env": {
"TICKSTEM_API_KEY": "tsk_your_key_here"
}
}
}
}
Herramientas disponibles
Trabajos cron
| Herramienta | Descripción |
|---|---|
list_jobs | Lista todos los trabajos cron de la cuenta |
get_job | Obtiene un trabajo cron por ID |
register_job | Registra un nuevo trabajo cron (nombre, programación, endpoint) |
update_job | Actualiza un trabajo existente — solo cambian los campos proporcionados |
pause_job | Pausa un trabajo para que ya no se ejecute |
resume_job | Reanuda un trabajo pausado o con fallos |
delete_job | Elimina permanentemente un trabajo y su historial de ejecuciones |
list_executions | Lista el historial de ejecuciones de un trabajo, del más reciente al más antiguo |
Monitoreo de disponibilidad
| Herramienta | Descripción |
|---|---|
list_monitors | Lista todos los monitores — estado, URL, intervalo, expiración de SSL, aserciones |
create_monitor | Crea un monitor con aserciones de respuesta opcionales (código de estado, tiempo de respuesta, cuerpo) |
get_monitor | Obtiene un monitor por ID |
pause_monitor | Pausa un monitor para que deje de hacer sondeos |
resume_monitor | Reanuda un monitor pausado |
delete_monitor | Elimina permanentemente un monitor y su historial de comprobaciones |
list_monitor_checks | Lista comprobaciones recientes — estado, código HTTP, duración, error, expiración de SSL |
Aserciones de respuesta
create_monitor acepta un parámetro assertions — un arreglo JSON de condiciones que deben cumplirse todas para que una comprobación se considere activa. Cuando se establecen aserciones, reemplazan la lógica predeterminada de 2xx/3xx.
[
{ "source": "status_code", "comparison": "eq", "target": "200" },
{ "source": "response_time", "comparison": "lt", "target": "2000" },
{ "source": "body", "comparison": "contains", "target": "\"status\":\"ok\"" }
]
| Fuente | Comparaciones válidas | Objetivo |
|---|---|---|
status_code | eq ne lt lte gt gte | entero cadena |
response_time | eq ne lt lte gt gte | entero cadena (ms) |
body | eq ne contains not_contains | cadena simple |
Monitoreo de latidos
| Herramienta | Descripción |
|---|---|
list_heartbeats | Lista todos los latidos — estado, token, intervalo, ventana de gracia, hora del último ping |
create_heartbeat | Crea un monitor de latidos (interruptor de hombre muerto) |
get_heartbeat | Obtiene un latido por ID |
update_heartbeat | Actualiza nombre, intervalo o ventana de gracia |
pause_heartbeat | Suprime alertas durante tiempo de inactividad planificado |
resume_heartbeat | Reanuda las alertas después de una pausa |
delete_heartbeat | Elimina permanentemente un latido y su historial de pings |
ping_heartbeat | Registra una ejecución exitosa de un trabajo — no se necesita clave API, el token es la credencial |
list_heartbeat_pings | Lista pings recientes de un latido, del más reciente al más antiguo |
Verificación de correo electrónico
| Herramienta | Descripción |
|---|---|
verify_email | Verifica sintaxis, registros MX, dominio desechable y prefijo basado en rol |
list_verify_history | Lista resultados de verificación anteriores de la cuenta |
Variables de entorno
| Variable | Requerida | Descripción |
|---|---|---|
TICKSTEM_API_KEY | Sí | Clave API de app.tickstem.dev |
TICKSTEM_BASE_URL | No | Sobrescribe la URL base de la API (p. ej. http://localhost:8080/v1 para desarrollo local) |
Desarrollo local
export TICKSTEM_API_KEY=tsk_your_key_here
export TICKSTEM_BASE_URL=http://localhost:8080/v1
go run ./cmd/tsk-mcp
SDKs
El servidor MCP gestiona la infraestructura desde tu asistente de IA. Para el código de la aplicación, usa el SDK que coincida con tu lenguaje:
| Lenguaje | Instalación | Documentación |
|---|---|---|
| Python | pip install tickstem | github.com/tickstem/python |
| Go (cron) | go get github.com/tickstem/cron | pkg.go.dev |
| Go (uptime) | go get github.com/tickstem/uptime | pkg.go.dev |
| Go (heartbeat) | go get github.com/tickstem/heartbeat | pkg.go.dev |
| Go (verify) | go get github.com/tickstem/verify | pkg.go.dev |
| Node.js | npm install @tickstem/cron | github.com/tickstem/node |
Todos los SDKs usan la misma clave API.
Obtén una clave API
app.tickstem.dev — el plan gratuito incluye 1,000 ejecuciones cron, 5 monitores de disponibilidad, 5 monitores de latidos y 500 verificaciones de correo electrónico por mes.
Licencia
MIT