mcp-deadmansnitch


Namemcp-deadmansnitch JSON
Version 0.1.0 PyPI version JSON
download
home_pageNone
SummaryMCP server for Dead Man's Snitch monitoring service
upload_time2025-07-24 09:30:23
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseMIT
keywords cron deadmansnitch mcp monitoring scheduled-tasks
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # MCP Dead Man's Snitch

[![PyPI version](https://badge.fury.io/py/mcp-deadmansnitch.svg)](https://pypi.org/project/mcp-deadmansnitch/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-deadmansnitch.svg)](https://pypi.org/project/mcp-deadmansnitch/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![CI](https://github.com/jamesbrink/mcp-deadmansnitch/actions/workflows/ci.yml/badge.svg)](https://github.com/jamesbrink/mcp-deadmansnitch/actions/workflows/ci.yml)

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. Install the package:
```bash
pip install mcp-deadmansnitch
```

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

3. Configure Claude Desktop by adding this to your settings:

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

## Available Tools

### `list_snitches`
List all snitches, optionally filtered by tags.

### `get_snitch`
Get details about a specific snitch using its token.

### `check_in`
Send a check-in to confirm a task completed successfully.

### `create_snitch`
Create a new snitch monitor with intervals: 15_minute, hourly, daily, weekly, or monthly.

### `update_snitch`
Update snitch configuration including name, interval, notes, tags, and alert settings.

### `delete_snitch`
Permanently delete a snitch.

### `pause_snitch`
Temporarily pause monitoring (optionally until a specific time).

### `unpause_snitch`
Resume monitoring for a paused snitch.

### `add_tags` / `remove_tag`
Manage tags for organizing snitches.

## 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.
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mcp-deadmansnitch",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": "James Brink <james@jamesbrink.net>",
    "keywords": "cron, deadmansnitch, mcp, monitoring, scheduled-tasks",
    "author": null,
    "author_email": "James Brink <james@jamesbrink.net>",
    "download_url": "https://files.pythonhosted.org/packages/74/f2/2342687b27ca3a4087b77c54ea2b6d2520a90dba4736a0d9d2b448945ef7/mcp_deadmansnitch-0.1.0.tar.gz",
    "platform": null,
    "description": "# MCP Dead Man's Snitch\n\n[![PyPI version](https://badge.fury.io/py/mcp-deadmansnitch.svg)](https://pypi.org/project/mcp-deadmansnitch/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-deadmansnitch.svg)](https://pypi.org/project/mcp-deadmansnitch/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![CI](https://github.com/jamesbrink/mcp-deadmansnitch/actions/workflows/ci.yml/badge.svg)](https://github.com/jamesbrink/mcp-deadmansnitch/actions/workflows/ci.yml)\n\nA 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.\n\n## What it does\n\nThis MCP server provides tools to:\n- List and search your monitoring snitches\n- Check in (ping) snitches to confirm tasks are running\n- Create new monitors for your scheduled jobs\n- Update, pause, or delete existing monitors\n- Manage tags for organizing your snitches\n\n## Installation & Setup\n\n1. Install the package:\n```bash\npip install mcp-deadmansnitch\n```\n\n2. Get your API key from [Dead Man's Snitch account settings](https://deadmanssnitch.com/account/integrations)\n\n3. Configure Claude Desktop by adding this to your settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"deadmansnitch\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-deadmansnitch\"],\n      \"env\": {\n        \"DEADMANSNITCH_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### `list_snitches`\nList all snitches, optionally filtered by tags.\n\n### `get_snitch`\nGet details about a specific snitch using its token.\n\n### `check_in`\nSend a check-in to confirm a task completed successfully.\n\n### `create_snitch`\nCreate a new snitch monitor with intervals: 15_minute, hourly, daily, weekly, or monthly.\n\n### `update_snitch`\nUpdate snitch configuration including name, interval, notes, tags, and alert settings.\n\n### `delete_snitch`\nPermanently delete a snitch.\n\n### `pause_snitch`\nTemporarily pause monitoring (optionally until a specific time).\n\n### `unpause_snitch`\nResume monitoring for a paused snitch.\n\n### `add_tags` / `remove_tag`\nManage tags for organizing snitches.\n\n## Example Usage in Claude\n\nOnce configured, you can ask Claude:\n- \"List all my Dead Man's Snitch monitors\"\n- \"Create a daily monitor called 'Database Backup'\"\n- \"Check in the backup-job snitch\"\n- \"Pause the deployment monitor for 2 hours\"\n- \"Show me all snitches tagged with 'production'\"\n\n## Support\n\n- [GitHub Issues](https://github.com/jamesbrink/mcp-deadmansnitch/issues)\n- [Dead Man's Snitch API Docs](https://deadmanssnitch.com/docs/api/v1)\n- [MCP Documentation](https://modelcontextprotocol.io/)\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "MCP server for Dead Man's Snitch monitoring service",
    "version": "0.1.0",
    "project_urls": {
        "Documentation": "https://github.com/jamesbrink/mcp-deadmansnitch#readme",
        "Homepage": "https://github.com/jamesbrink/mcp-deadmansnitch",
        "Issues": "https://github.com/jamesbrink/mcp-deadmansnitch/issues",
        "Repository": "https://github.com/jamesbrink/mcp-deadmansnitch"
    },
    "split_keywords": [
        "cron",
        " deadmansnitch",
        " mcp",
        " monitoring",
        " scheduled-tasks"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d416f900ef8a40c0b23fff78418e751d1cd407fe1b7d6c169349d18628937ef4",
                "md5": "2fa034b1449d684efcf0493bcd86f4aa",
                "sha256": "d68edf6127e14eb67edb366d6391b41bebe1273a6f9cd4a36b34d95c8d82ef3d"
            },
            "downloads": -1,
            "filename": "mcp_deadmansnitch-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "2fa034b1449d684efcf0493bcd86f4aa",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 9009,
            "upload_time": "2025-07-24T09:30:22",
            "upload_time_iso_8601": "2025-07-24T09:30:22.288172Z",
            "url": "https://files.pythonhosted.org/packages/d4/16/f900ef8a40c0b23fff78418e751d1cd407fe1b7d6c169349d18628937ef4/mcp_deadmansnitch-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "74f22342687b27ca3a4087b77c54ea2b6d2520a90dba4736a0d9d2b448945ef7",
                "md5": "ac46b76d5d3ec4f2700a45c12fc49543",
                "sha256": "bdf53be2917d2d197bf32c77b758bbe0d1db1bdb749be44cea26bb98decbe8ca"
            },
            "downloads": -1,
            "filename": "mcp_deadmansnitch-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "ac46b76d5d3ec4f2700a45c12fc49543",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 76062,
            "upload_time": "2025-07-24T09:30:23",
            "upload_time_iso_8601": "2025-07-24T09:30:23.612646Z",
            "url": "https://files.pythonhosted.org/packages/74/f2/2342687b27ca3a4087b77c54ea2b6d2520a90dba4736a0d9d2b448945ef7/mcp_deadmansnitch-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-24 09:30:23",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "jamesbrink",
    "github_project": "mcp-deadmansnitch#readme",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "mcp-deadmansnitch"
}
        
Elapsed time: 1.88062s