Skip to content
Back to search

12happy-mcp

12happy MCP server: uptime monitoring from Claude, Cursor and VS Code

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/12happyhq--12happy-mcp/badge.svg)](/listings/12happyhq--12happy-mcp)

HTML

<a href="/listings/12happyhq--12happy-mcp"><img src="/api/listings/12happyhq--12happy-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

claude mcp add 12happy -e TWELVEHAPPY_API_KEY=mon_live_... -- npx -y 12happy-mcp

Claude Desktop

Add this to `claude_desktop_config.json` (Settings → Developer → Edit Config), then restart Claude:

{
  "mcpServers": {
    "12happy": {
      "command": "npx",
      "args": ["-y", "12happy-mcp"],
      "env": { "TWELVEHAPPY_API_KEY": "mon_live_..." }
    }
  }
}

Cursor

Add the same block to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in a project.

VS Code

Add this to `.vscode/mcp.json`. VS Code asks for the key once and stores it securely:

{
  "inputs": [
    { "type": "promptString", "id": "twelvehappy-key", "description": "12happy API key", "password": true }
  ],
  "servers": {
    "12happy": {
      "command": "npx",
      "args": ["-y", "12happy-mcp"],
      "env": { "TWELVEHAPPY_API_KEY": "${input:twelvehappy-key}" }
    }
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 116 lines
  1. # 12happy MCP server
  2. Uptime monitoring you can talk to. This [Model Context Protocol](https://modelcontextprotocol.io) server connects [12happy](https://www.12hpy.com/) to Claude, Cursor, VS Code and any other MCP client, so you can ask:
  3. - "Is anything down right now?"
  4. - "Watch https://api.example.com/health every minute and alert the #ops Slack channel."
  5. - "Why did the checkout monitor fail last night, and from which regions?"
  6. - "What was our uptime and p95 response time for the API last month?"
  7. - "Silence alerts for 20 minutes while I deploy."
  8. - "Tell me if the nightly backup stops running."
  9. 12happy checks from the US, Europe and Israel, and opens an incident only when a quorum of regions agrees that something is down, so one flaky probe doesn't page you.
  10. ## What you need
  11. - A 12happy account on the **Pro or Agency plan**, which include API access. [Start free](https://app.12hpy.com/), then upgrade from the console.
  12. - An **API key**: in the [console](https://app.12hpy.com/), open **API keys** and choose **Create key**. Pick the scopes the assistant should have. A key with only the read scopes can't change anything.
  13. - Node.js 20 or later.
  14. ## Install
  15. ### Claude Code
  16. ```bash
  17. claude mcp add 12happy -e TWELVEHAPPY_API_KEY=mon_live_... -- npx -y 12happy-mcp
  18. ```
  19. ### Claude Desktop
  20. Add this to `claude_desktop_config.json` (Settings → Developer → Edit Config), then restart Claude:
  21. ```json
  22. {
  23. "mcpServers": {
  24. "12happy": {
  25. "command": "npx",
  26. "args": ["-y", "12happy-mcp"],
  27. "env": { "TWELVEHAPPY_API_KEY": "mon_live_..." }
  28. }
  29. }
  30. }
  31. ```
  32. ### Cursor
  33. Add the same block to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in a project.
  34. ### VS Code
  35. Add this to `.vscode/mcp.json`. VS Code asks for the key once and stores it securely:
  36. ```json
  37. {
  38. "inputs": [
  39. { "type": "promptString", "id": "twelvehappy-key", "description": "12happy API key", "password": true }
  40. ],
  41. "servers": {
  42. "12happy": {
  43. "command": "npx",
  44. "args": ["-y", "12happy-mcp"],
  45. "env": { "TWELVEHAPPY_API_KEY": "${input:twelvehappy-key}" }
  46. }
  47. }
  48. }
  49. ```
  50. ## Tools
  51. | Tool | What it does |
  52. |---|---|
  53. | `get_overview` | Monitors up, down, slow and paused; open incidents; uptime over N days |
  54. | `list_monitors` | All monitors, filterable by status or text |
  55. | `get_monitor` | One monitor's settings and latest results per region |
  56. | `get_uptime_report` | Uptime % and p50/p95/p99 response time for any period or region |
  57. | `list_incidents` | Outages and slowdowns, with cause and confirming regions |
  58. | `list_alert_channels` | Email, Slack, webhook, SMS and other channels, and their health |
  59. | `list_regions` | Where checks can run from |
  60. | `create_monitor` | Watch a URL, keyword, hostname (ping, DNS, SSL certificate) or TCP port, or a cron job by heartbeat: it returns the URL the job calls when it finishes |
  61. | `update_monitor` | Change target, interval, regions, keyword, timeout or slow threshold |
  62. | `pause_monitor` | Pause or resume, keeping history |
  63. | `check_now` | Run a check immediately |
  64. | `delete_monitor` | Delete a monitor and its history (assistants are told to confirm first) |
  65. | `acknowledge_incident` | Take ownership and stop escalation |
  66. | `start_maintenance` | Silence alerts or pause checks for a deploy |
  67. | `set_monitor_alerts` | Choose which channels a monitor alerts, with escalation delays |
  68. Read-only tools are marked as such, and `delete_monitor` is marked destructive, so clients that ask before risky actions will ask.
  69. ## Settings
  70. | Variable | |
  71. |---|---|
  72. | `TWELVEHAPPY_API_KEY` | Required. A key from the console's API keys page. |
  73. | `TWELVEHAPPY_ORG` | Optional. Agencies and resellers: the client organization to act on by default. Every tool also takes an `organization` argument. |
  74. | `TWELVEHAPPY_API_URL` | Optional. Defaults to `https://be.12hpy.com/v1`. |
  75. ## Security
  76. - The key is sent only to the 12happy API, as a bearer token, and is never logged.
  77. - Scopes are enforced by the API: a key without `monitors:write` gets a clear "missing scope" error rather than a change.
  78. - Revoke a key at any time from the API keys page; it stops working immediately.
  79. ## Develop
  80. ```bash
  81. npm install
  82. npm run build
  83. npm run inspect # opens the MCP Inspector
  84. node --env-file=.env test/smoke.mjs <test-organization-id>
  85. ```
  86. The API reference is at [be.12hpy.com/docs/api](https://be.12hpy.com/docs/api).
  87. ## License
  88. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.