Tickstem MCP

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):

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

Uptime monitoring

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\"" } ]

Heartbeat monitoring

Email verification

Environment variables

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:

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