Read Dead Man's Snitch monitors and status; create, tag, pause and unpause snitches.
Score is being calculated.
WRITE: add one or more tags to a snitch, keeping the existing ones. Returns the snitch's full tag list. POST /v1/snitches/{token}/tags.
| Name | Required | Description | Default |
|---|---|---|---|
| tags | Yes | ||
| snitch | Yes | The snitch: its token, the masked token shown by deadmanssnitch_list_snitches (e.g. ab…yz), or its exact name. |
WRITE: create a new snitch (monitor). Returns it with its check-in URL (https://nosnch.in/), which the job must call on every run; keep it secret. Fails with 402 when the plan's snitch limit is reached. POST /v1/snitches.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the snitch. | |
| tags | No | ||
| notes | No | Free-text notes. | |
| interval | Yes | Expected check-in frequency. The *_minute values are only available on the Basic plan; weekly = Monday to Monday. | |
| alert_type | No | Default basic. | |
| alert_email | No | Email addresses that get this snitch's alerts instead of all team members (max 10; this limit is ours, not the vendor's). An empty list clears the override. |
One snitch with its full details, including the check-in URL (https://nosnch.in/). The check-in URL is a secret: anyone who has it can check in and so silence the alert; share it only where the job runs. GET /v1/snitches/{token}.
| Name | Required | Description | Default |
|---|---|---|---|
| snitch | Yes | The snitch: its token, the masked token shown by deadmanssnitch_list_snitches (e.g. ab…yz), or its exact name. |
List the snitches (cron/heartbeat monitors) of the account with status (pending, healthy, failed, errored, paused), interval, alert type, tags and last check-in. Tokens are masked (the token is also the check-in secret); pass the masked token or the name to the other snitch tools. The API has no paging: all snitches come back. Optionally filter by tags (must have all) or status. GET /v1/snitches.
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Only snitches that have ALL of these tags. | |
| status | No | Only snitches in this status (filtered here). |
WRITE: pause a snitch, which SILENCES its alerts: a job that stops running goes unnoticed while it is paused. until says when alerting resumes: 'healthy' (default: on the next healthy check-in), 'unpaused' (stays paused until deadmanssnitch_unpause_snitch) or a future ISO 8601 time. A snitch that has never checked in (pending) cannot be paused. POST /v1/snitches/{token}/pause.
| Name | Required | Description | Default |
|---|---|---|---|
| until | No | 'healthy' (default), 'unpaused', or a future ISO 8601 time with timezone, e.g. 2026-10-20T08:00:00Z. | |
| snitch | Yes | The snitch: its token, the masked token shown by deadmanssnitch_list_snitches (e.g. ab…yz), or its exact name. |
WRITE: remove one tag from a snitch (the snitch itself is untouched). Returns the remaining tags. DELETE /v1/snitches/{token}/tags/{tag}.
| Name | Required | Description | Default |
|---|---|---|---|
| tag | Yes | A tag. | |
| snitch | Yes | The snitch: its token, the masked token shown by deadmanssnitch_list_snitches (e.g. ab…yz), or its exact name. |
WRITE: resume alerting for a paused snitch (safe on a snitch that is not paused). POST /v1/snitches/{token}/unpause.
| Name | Required | Description | Default |
|---|---|---|---|
| snitch | Yes | The snitch: its token, the masked token shown by deadmanssnitch_list_snitches (e.g. ab…yz), or its exact name. |
WRITE: change a snitch. Only the fields you pass change. tags REPLACES the whole tag list (use deadmanssnitch_add_tags to add) and alert_email replaces the alert recipients (an empty list = all team members). Returns the updated snitch with the token masked. PATCH /v1/snitches/{token}.
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New name. | |
| tags | No | The complete new tag list (replaces the old one; [] removes all tags). | |
| notes | No | New notes; null clears them. | |
| snitch | Yes | The snitch: its token, the masked token shown by deadmanssnitch_list_snitches (e.g. ab…yz), or its exact name. | |
| interval | No | Expected check-in frequency. The *_minute values are only available on the Basic plan; weekly = Monday to Monday. | |
| alert_type | No | basic = fixed deadline; smart = learns when the job usually checks in and alerts earlier. | |
| alert_email | No | Email addresses that get this snitch's alerts instead of all team members (max 10; this limit is ours, not the vendor's). An empty list clears the override. |
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
deadmanssnitch_add_tagsdeadmanssnitch_create_snitchdeadmanssnitch_get_snitchdeadmanssnitch_list_snitchesdeadmanssnitch_pause_snitchdeadmanssnitch_remove_tagdeadmanssnitch_unpause_snitchdeadmanssnitch_update_snitchRead monitors, incidents, heartbeats, on-call and status pages; acknowledge or resolve incidents.
Monitor websites, APIs, and servers: create monitors, triage incidents, and query uptime stats.
Manage Cronitor monitors and send telemetry pings — list, inspect, create, update, delete.
Read status-page status, services, incidents and metrics; create, update and publish incidents.
Add one secure layer between your agents and this server.
