Skip to main content
Glama
deenesjakoruzh
tickstem

Tickstem

by tickstem
OverviewSchemaRelated ServersScoreDiscussions
Go
Remote

tickstem/mcp

Glama

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

Related MCP server: ticktick-mcp-server

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

Install Server
A
license - permissive license
A
quality
A
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
2dRelease cycle
16Releases (12mo)
Commit activity

Resources

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tickstem/mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server