Tickstem MCP server
Commit Sep 7, 2026Lets an AI assistant manage cron jobs, uptime monitors, heartbeat monitors, and email verification through native tools.
Also known as tickstem/mcp
- Stars
- 2
- Tools
- 29
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Sep 7, 2026
- License
- MIT
What is Tickstem MCP?
Tickstem lets an AI assistant manage cron jobs, uptime monitors, heartbeat monitors, and email verification through native tools. It exposes 29 tools, such as list_jobs, get_job, register_job.
Summary generated from the project's README
About Tickstem MCP server
Managing infrastructure tasks like cron jobs and uptime monitoring from inside an AI coding assistant is what this server enables. Developers using Claude, Cursor, or Copilot can interact with Tickstem services to schedule tasks, monitor website availability, and verify email addresses without leaving their development environment. The server operates via stdio and requires a TICKSTEM_API_KEY to function.
Users can perform a wide range of administrative actions through specific tools. For cron jobs, the assistant can register, update, pause, or delete scheduled tasks and view execution history. Uptime monitoring tools allow for creating monitors with custom response assertions for status codes, response times, and body content. Heartbeat monitors function as dead-man's switches, while email verification tools check for syntax, MX records, and disposable domains.
This setup is designed for developers who want to automate infrastructure management while writing application code. The server is available as a pre-built binary for macOS, Linux, and Windows, or can be installed using Go. The free tier provides limits of 1,000 cron executions, 5 uptime monitors, 5 heartbeat monitors, and 500 email verifications per month.
What you can do with it
- 1Schedule automated tasksAsk your AI assistant to set up a new recurring job with a specific schedule and endpoint.
- 2Monitor website healthInstruct the assistant to create an uptime monitor that checks for specific status codes and response times.
- 3Validate user emailsHave the AI verify if an email address is valid by checking its syntax and MX records.
- 4Manage heartbeat monitorsUse the assistant to create a dead-man's switch to ensure critical processes are running.
Written from the project's README. Every use case is checked against a quote from it.
Tickstem MCP tools 29
Detected from the READMElist_jobsget_jobregister_jobupdate_jobpause_jobresume_jobdelete_joblist_executionslist_monitorscreate_monitorget_monitorpause_monitor
| list_jobs | — | |
| get_job | — | |
| register_job | — | |
| update_job | — | |
| pause_job | — | |
| resume_job | — | |
| delete_job | — | |
| list_executions | — | |
| list_monitors | — | |
| create_monitor | — | |
| get_monitor | — | |
| pause_monitor | — |
Show all 29 toolsShow fewer tools
resume_monitordelete_monitorlist_monitor_checksstatus_coderesponse_timebodylist_heartbeatscreate_heartbeatget_heartbeatupdate_heartbeatpause_heartbeatresume_heartbeatdelete_heartbeatping_heartbeatlist_heartbeat_pingsverify_emaillist_verify_history
| resume_monitor | — | |
| delete_monitor | — | |
| list_monitor_checks | — | |
| status_code | — | |
| response_time | — | |
| body | — | |
| list_heartbeats | — | |
| create_heartbeat | — | |
| get_heartbeat | — | |
| update_heartbeat | — | |
| pause_heartbeat | — | |
| resume_heartbeat | — | |
| delete_heartbeat | — | |
| ping_heartbeat | — | |
| list_heartbeat_pings | — | |
| verify_email | — | |
| list_verify_history | — |
Configuration
TICKSTEM_API_KEYTICKSTEM_BASE_URL
| Name | Description | |
|---|---|---|
| TICKSTEM_API_KEY | — | |
| TICKSTEM_BASE_URL | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachabletickstem/mcp is public and reachablegithub.com/tickstem/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-07github.com/tickstem/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model29 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubtickstem/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
Tickstem MCP questions
What tools does Tickstem MCP provide?
It exposes 29 tools, including list_jobs, get_job, register_job, update_job, pause_job.
Can I use custom assertions for uptime monitoring?
Yes, you can create monitors with response assertions for status codes, response times, and response bodies to define what constitutes a successful check.
Does the email verification tool check for disposable domains?
Yes, the email verification tool checks syntax, MX records, disposable domains, and role-based prefixes.