# Mcp Deadmansnitch

> MCP server for Dead Man's Snitch monitoring service - Monitor scheduled tasks and cron jobs through AI assistants

- **Type:** MCP server
- **Install:** `agentstack add mcp-jamesbrink-mcp-deadmansnitch`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jamesbrink](https://agentstack.voostack.com/s/jamesbrink)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jamesbrink](https://github.com/jamesbrink)
- **Source:** https://github.com/jamesbrink/mcp-deadmansnitch
- **Website:** https://pypi.org/project/mcp-deadmansnitch/

## Install

```sh
agentstack add mcp-jamesbrink-mcp-deadmansnitch
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Dead Man's Snitch

[](https://pypi.org/project/mcp-deadmansnitch/)
[](https://pypi.org/project/mcp-deadmansnitch/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/jamesbrink/mcp-deadmansnitch/actions/workflows/ci.yml)
[](https://codecov.io/gh/jamesbrink/mcp-deadmansnitch)
[](https://flakehub.com/flake/jamesbrink/mcp-deadmansnitch)
[](https://nixos.org)

A Model Context Protocol (MCP) server for [Dead Man's Snitch](https://deadmanssnitch.com/) monitoring service. This server enables AI assistants like Claude to interact with Dead Man's Snitch to monitor scheduled tasks and cron jobs.

## What it does

This MCP server provides tools to:

- List and search your monitoring snitches
- Check in (ping) snitches to confirm tasks are running
- Create new monitors for your scheduled jobs
- Update, pause, or delete existing monitors
- Manage tags for organizing your snitches

## Installation & Setup

1. Get your API key from [Dead Man's Snitch account settings](https://deadmanssnitch.com/account/integrations)

2. Configure your MCP client by adding this to your settings:

```json
{
  "mcpServers": {
    "deadmansnitch": {
      "command": "uvx",
      "args": ["mcp-deadmansnitch"],
      "env": {
        "DEADMANSNITCH_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Nix / NixOS

For Nix users, this project provides a flake with packages, overlays, and a development shell:

```bash
# Run directly
nix run github:jamesbrink/mcp-deadmansnitch

# Build the package
nix build github:jamesbrink/mcp-deadmansnitch
```

See [NIX.md](NIX.md) for detailed NixOS configuration and declarative usage.

### Docker

A Docker image can be built from the Nix flake:

```bash
# Build and load the image
nix build github:jamesbrink/mcp-deadmansnitch#docker
docker load < result

# Run the server
docker run --rm -e DEADMANSNITCH_API_KEY="your_api_key" mcp-deadmansnitch:latest
```

Configure your MCP client to use Docker:

```json
{
  "mcpServers": {
    "deadmansnitch": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "DEADMANSNITCH_API_KEY", "mcp-deadmansnitch:latest"],
      "env": {
        "DEADMANSNITCH_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Available Tools

This MCP server exposes a single unified `snitch` tool with an `action` parameter to reduce context usage when connecting to LLMs.

### `snitch`

Manage Dead Man's Snitch monitors with the following actions:

| Action | Description | Required Params | Optional Params |
|--------|-------------|-----------------|-----------------|
| `list` | List all snitches | - | `tags` (filter) |
| `get` | Get snitch details | `token` | - |
| `create` | Create new snitch | `name`, `interval` | `notes`, `tags`, `alert_type`, `alert_email` |
| `update` | Update snitch | `token` | `name`, `interval`, `notes`, `tags`, `alert_type`, `alert_email` |
| `delete` | Delete snitch | `token` | - |
| `pause` | Pause monitoring | `token` | `until` (ISO 8601) |
| `unpause` | Resume monitoring | `token` | - |
| `check_in` | Send check-in | `token` | `message` |
| `add_tags` | Add tags | `token`, `tags` | - |
| `remove_tag` | Remove a tag | `token`, `tag` | - |

**Valid intervals**: `15_minute`, `hourly`, `daily`, `weekly`, `monthly`

**Valid alert_types**: `basic`, `smart`

## Example Usage in Claude

Once configured, you can ask Claude:

- "List all my Dead Man's Snitch monitors"
- "Create a daily monitor called 'Database Backup'"
- "Check in the backup-job snitch"
- "Pause the deployment monitor for 2 hours"
- "Show me all snitches tagged with 'production'"

## Support

- [GitHub Issues](https://github.com/jamesbrink/mcp-deadmansnitch/issues)
- [Dead Man's Snitch API Docs](https://deadmanssnitch.com/docs/api/v1)
- [MCP Documentation](https://modelcontextprotocol.io/)

## License

MIT License - see [LICENSE](LICENSE) file for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jamesbrink](https://github.com/jamesbrink)
- **Source:** [jamesbrink/mcp-deadmansnitch](https://github.com/jamesbrink/mcp-deadmansnitch)
- **License:** MIT
- **Homepage:** https://pypi.org/project/mcp-deadmansnitch/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-jamesbrink-mcp-deadmansnitch
- Seller: https://agentstack.voostack.com/s/jamesbrink
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.