Tickstem

dev.tickstemPublished by tickstem.devv1.0.0Updated Oct 27, 2026

Tickstem developer tools — manage cron jobs and verify emails from your AI coding assistant.

Overview

AI-generated overview

Tickstem's local MCP server lets an AI assistant create and manage cron jobs, uptime and heartbeat monitors, and verify email addresses.

What you can do
  • List, create, update, pause, resume and delete cron jobs, and read their execution history
  • Create and manage uptime monitors with response assertions on status code, response time and body, and list recent checks
  • Create and manage heartbeat (dead-man's switch) monitors, ping them and list recent pings
  • Verify email addresses for syntax, MX records, disposable domains and role-based prefixes, and list past verification results
When to use it
Useful when you want your coding assistant to set up scheduled jobs, uptime or heartbeat monitoring and email checks for an app while you write code, instead of switching to a separate dashboard.
Requirements
Runs as a local binary (pre-built for macOS, Linux and Windows, or installed with Go) and speaks MCP over stdio. Requires a Tickstem API key in the TICKSTEM_API_KEY environment variable; TICKSTEM_BASE_URL optionally overrides the API base URL. Network access to the Tickstem API is needed.
Before you install
The API key is passed in plain text through the client configuration and grants access to the whole account. Tools can create, update, pause and permanently delete jobs, monitors and heartbeats, including their execution and check history, so destructive calls should be reviewed. Heartbeat pings use a token as the credential. Usage is subject to Tickstem's free-tier quotas and any paid plan.

Installation

In SourceWeft

  1. Open Tickstem in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

tickstem/mcp

[Glama] [smithery badge]

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

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

bash
# macOS / Linux examplechmod +x tsk-mcp-darwin-arm64mv tsk-mcp-darwin-arm64 /usr/local/bin/tsk-mcp

Or install with Go:

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

Quick start

bash
export TICKSTEM_API_KEY=tsk_your_key_heretsk-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):

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

Available tools

Cron jobs

ToolDescription
list_jobsList all cron jobs in the account
get_jobGet a cron job by ID
register_jobRegister a new cron job (name, schedule, endpoint)
update_jobUpdate an existing job — only provided fields change
pause_jobPause a job so it no longer fires
resume_jobResume a paused or failing job
delete_jobPermanently delete a job and its execution history
list_executionsList execution history for a job, most recent first

Uptime monitoring

ToolDescription
list_monitorsList all monitors — status, URL, interval, SSL expiry, assertions
create_monitorCreate a monitor with optional response assertions (status code, response time, body)
get_monitorGet a monitor by ID
pause_monitorPause a monitor so it stops polling
resume_monitorResume a paused monitor
delete_monitorPermanently delete a monitor and its check history
list_monitor_checksList 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.

json
[  { "source": "status_code",   "comparison": "eq",       "target": "200"              },  { "source": "response_time", "comparison": "lt",       "target": "2000"             },  { "source": "body",          "comparison": "contains", "target": "\"status\":\"ok\"" }]
SourceValid comparisonsTarget
status_codeeq ne lt lte gt gteinteger string
response_timeeq ne lt lte gt gteinteger string (ms)
bodyeq ne contains not_containsplain string

Heartbeat monitoring

ToolDescription
list_heartbeatsList all heartbeats — status, token, interval, grace window, last ping time
create_heartbeatCreate a heartbeat monitor (dead-man's switch)
get_heartbeatGet a heartbeat by ID
update_heartbeatUpdate name, interval, or grace window
pause_heartbeatSuppress alerts during planned downtime
resume_heartbeatResume alerting after a pause
delete_heartbeatPermanently delete a heartbeat and its ping history
ping_heartbeatRecord a successful job run — no API key needed, token is the credential
list_heartbeat_pingsList recent pings for a heartbeat, most recent first

Email verification

ToolDescription
verify_emailCheck syntax, MX records, disposable domain, and role-based prefix
list_verify_historyList past verification results for the account

Environment variables

VariableRequiredDescription
TICKSTEM_API_KEYYesAPI key from app.tickstem.dev
TICKSTEM_BASE_URLNoOverride API base URL (e.g. http://localhost:8080/v1 for local dev)

Local development

bash
export TICKSTEM_API_KEY=tsk_your_key_hereexport TICKSTEM_BASE_URL=http://localhost:8080/v1go 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:

LanguageInstallDocs
Pythonpip install tickstemgithub.com/tickstem/python
Go (cron)go get github.com/tickstem/cronpkg.go.dev
Go (uptime)go get github.com/tickstem/uptimepkg.go.dev
Go (heartbeat)go get github.com/tickstem/heartbeatpkg.go.dev
Go (verify)go get github.com/tickstem/verifypkg.go.dev
Node.jsnpm install @tickstem/crongithub.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: README.md at commit baf970d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts