Tickstem

Agendamento cron, monitoramento de uptime, monitoramento de heartbeat e verificação de e-mail como ferramentas MCP nativas para Claude Code, Cursor e qualquer agente compatível com MCP.

GitHub

Documentação

tickstem/mcp

Servidor MCP para Tickstem — expõe agendamento de jobs cron, monitoramento de uptime, monitoramento de heartbeat e verificação de e-mail como ferramentas nativas para assistentes de codificação com IA (Claude, Cursor, Copilot e qualquer agente compatível com MCP).

Deixe seu assistente de IA registrar jobs cron, criar monitores de uptime com asserções de resposta, gerenciar monitores de heartbeat, verificar endereços de e-mail e consultar resultados — enquanto você escreve o código do aplicativo.

Instalação

Baixe um binário pré-compilado (sem necessidade de Go):

Plataforma	Binário
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`

Baixe em Releases, torne-o executável e coloque-o no seu PATH:

# macOS / Linux example
chmod +x tsk-mcp-darwin-arm64
mv tsk-mcp-darwin-arm64 /usr/local/bin/tsk-mcp

Ou instale com Go:

go install github.com/tickstem/mcp/cmd/tsk-mcp@latest

Início rápido

export TICKSTEM_API_KEY=tsk_your_key_here
tsk-mcp

O servidor fala o Model Context Protocol via stdio — conecte-o a qualquer cliente compatível com MCP.

Claude Code

Adicione ao seu ~/.claude/claude_desktop_config.json (ou equivalente):

{
  "mcpServers": {
    "tickstem": {
      "command": "tsk-mcp",
      "env": {
        "TICKSTEM_API_KEY": "tsk_your_key_here"
      }
    }
  }
}

Ferramentas disponíveis

Jobs cron

Ferramenta	Descrição
`list_jobs`	Lista todos os jobs cron da conta
`get_job`	Obtém um job cron por ID
`register_job`	Registra um novo job cron (nome, agendamento, endpoint)
`update_job`	Atualiza um job existente — apenas os campos fornecidos são alterados
`pause_job`	Pausa um job para que ele não seja mais disparado
`resume_job`	Retoma um job pausado ou com falhas
`delete_job`	Exclui permanentemente um job e seu histórico de execuções
`list_executions`	Lista o histórico de execuções de um job, do mais recente ao mais antigo

Monitoramento de uptime

Ferramenta	Descrição
`list_monitors`	Lista todos os monitores — status, URL, intervalo, expiração de SSL, asserções
`create_monitor`	Cria um monitor com asserções de resposta opcionais (código de status, tempo de resposta, corpo)
`get_monitor`	Obtém um monitor por ID
`pause_monitor`	Pausa um monitor para que ele pare de fazer polling
`resume_monitor`	Retoma um monitor pausado
`delete_monitor`	Exclui permanentemente um monitor e seu histórico de verificações
`list_monitor_checks`	Lista verificações recentes — status, código HTTP, duração, erro, expiração de SSL

Asserções de resposta

create_monitor aceita um parâmetro assertions — um array JSON de condições que devem ser todas atendidas para que uma verificação seja considerada ativa. Quando asserções são definidas, elas substituem a lógica padrão de 2xx/3xx.

[
  { "source": "status_code",   "comparison": "eq",       "target": "200"              },
  { "source": "response_time", "comparison": "lt",       "target": "2000"             },
  { "source": "body",          "comparison": "contains", "target": "\"status\":\"ok\"" }
]

Origem	Comparações válidas	Alvo
`status_code`	`eq` `ne` `lt` `lte` `gt` `gte`	inteiro string
`response_time`	`eq` `ne` `lt` `lte` `gt` `gte`	inteiro string (ms)
`body`	`eq` `ne` `contains` `not_contains`	string simples

Monitoramento de heartbeat

Ferramenta	Descrição
`list_heartbeats`	Lista todos os heartbeats — status, token, intervalo, janela de tolerância, horário do último ping
`create_heartbeat`	Cria um monitor de heartbeat (interruptor de homem morto)
`get_heartbeat`	Obtém um heartbeat por ID
`update_heartbeat`	Atualiza nome, intervalo ou janela de tolerância
`pause_heartbeat`	Suprime alertas durante manutenção planejada
`resume_heartbeat`	Retoma alertas após uma pausa
`delete_heartbeat`	Exclui permanentemente um heartbeat e seu histórico de pings
`ping_heartbeat`	Registra uma execução bem-sucedida de job — sem necessidade de chave de API, o token é a credencial
`list_heartbeat_pings`	Lista pings recentes de um heartbeat, do mais recente ao mais antigo

Verificação de e-mail

Ferramenta	Descrição
`verify_email`	Verifica sintaxe, registros MX, domínio descartável e prefixo baseado em função
`list_verify_history`	Lista resultados de verificação anteriores da conta

Variáveis de ambiente

Variável	Obrigatória	Descrição
`TICKSTEM_API_KEY`	Sim	Chave de API de app.tickstem.dev
`TICKSTEM_BASE_URL`	Não	Substitui a URL base da API (ex.: `http://localhost:8080/v1` para desenvolvimento local)

Desenvolvimento local

export TICKSTEM_API_KEY=tsk_your_key_here
export TICKSTEM_BASE_URL=http://localhost:8080/v1
go run ./cmd/tsk-mcp

SDKs

O servidor MCP gerencia a infraestrutura a partir do seu assistente de IA. Para código de aplicação, use o SDK que corresponde à sua linguagem:

Linguagem	Instalação	Documentação
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 os SDKs usam a mesma chave de API.

Obtenha uma chave de API

app.tickstem.dev — o plano gratuito inclui 1.000 execuções de cron, 5 monitores de uptime, 5 monitores de heartbeat e 500 verificações de e-mail por mês.

Licença

MIT