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