Tickstem Mcp

tickstem/mcp

[](https://glama.ai/mcp/servers/tickstem/mcp) [](https://smithery.ai/servers/tickstem-info/tickstem-mcp)

MCP server for Tickstem — exposes cron job scheduling, uptime monitoring, heartbeat monitoring, and email verification as native tools for AI coding assistants (Claude, Cursor, Copilot, and any MCP-compatible agent).

Let your AI assistant register cron jobs, create uptime monitors with response assertions, manage heartbeat monitors, verify email addresses, and query results — while you write the app code.

Install

Download a pre-built binary (no Go required):

| Platform | Binary | |----------|--------| | 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 |

Download from Releases, make executable, and place on your PATH:

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

Or install with Go:

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

Quick start

export TICKSTEM_API_KEY=tsk_your_key_here
tsk-mcp

The server speaks the Model Context Protocol over stdio — connect it to any MCP-compatible client.

Claude Code

Add to your ~/.claude/claude_desktop_config.json (or equivalent):

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

Available tools

Cron jobs

| Tool | Description | |------|-------------| | list_jobs | List all cron jobs in the account | | get_job | Get a cron job by ID | | register_job | Register a new cron job (name, schedule, endpoint) | | update_job | Update an existing job — only provided fields change | | pause_job | Pause a job so it no longer fires | | resume_job | Resume a paused or failing job | | delete_job | Permanently delete a job and its execution history | | list_executions | List execution history for a job, most recent first |

Uptime monitoring

| Tool | Description | |------|-------------| | list_monitors | List all monitors — status, URL, interval, SSL expiry, assertions | | create_monitor | Create a monitor with optional response assertions (status code, response time, body) | | get_monitor | Get a monitor by ID | | pause_monitor | Pause a monitor so it stops polling | | resume_monitor | Resume a paused monitor | | delete_monitor | Permanently delete a monitor and its check history | | list_monitor_checks | List recent checks — status, HTTP code, duration, error, SSL expiry |

Response assertions

create_monitor accepts an assertions parameter — a JSON array of conditions that must all pass for a check to be considered up. When assertions are set they replace the default 2xx/3xx logic.

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

| Source | Valid comparisons | Target | |--------|------------------|--------| | status_code | eq ne lt lte gt gte | integer string | | response_time | eq ne lt lte gt gte | integer string (ms) | | body | eq ne contains not_contains | plain string |

Heartbeat monitoring

| Tool | Description | |------|-------------| | list_heartbeats | List all heartbeats — status, token, interval, grace window, last ping time | | create_heartbeat | Create a heartbeat monitor (dead-man's switch) | | get_heartbeat | Get a heartbeat by ID | | update_heartbeat | Update name, interval, or grace window | | pause_heartbeat | Suppress alerts during planned downtime | | resume_heartbeat | Resume alerting after a pause | | delete_heartbeat | Permanently delete a heartbeat and its ping history | | ping_heartbeat | Record a successful job run — no API key needed, token is the credential | | list_heartbeat_pings | List recent pings for a heartbeat, most recent first |

Email verification

| Tool | Description | |------|-------------| | verify_email | Check syntax, MX records, disposable domain, and role-based prefix | | list_verify_history | List past verification results for the account |

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | TICKSTEM_API_KEY | Yes | API key from app.tickstem.dev | | TICKSTEM_BASE_URL | No | Override API base URL (e.g. http://localhost:8080/v1 for local dev) |

Local development

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

SDKs

The MCP server handles infrastructure management from your AI assistant. For application code, use the SDK that matches your language:

| Language | Install | Docs | |----------|---------|------| | 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 |

All SDKs use the same API key.

Get an API key

app.tickstem.dev — free tier includes 1,000 cron executions, 5 uptime monitors, 5 heartbeat monitors, and 500 email verifications per month.

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tickstem
• Source: tickstem/mcp
• License: MIT

Install and usage instructions live in the source repository linked above.