Ned Watch

Official11 tools

by ned

Wake me when my agent misses its heartbeat. Deadman, overrun, HTTP, TLS, content; US+EU nodes.

watch.ned/ned-watch (MCP) Server

Wake me when my agent misses its heartbeat: one quickstart call. This MCP server exposes HTTP access secured with TLS and provides a “deadman” mechanism for monitoring. It supports US and EU nodes, enabling region-based deployment for the heartbeat alert workflow.

🛠️ Key Features

Deadman heartbeat monitoring for an agent
One quickstart call to begin
HTTP interface
TLS security
US + EU nodes

🚀 Use Cases

Detect when an agent misses its heartbeat
Trigger actions after heartbeat loss using the deadman mechanism
Deploy monitoring across US and EU environments

⚡ Developer Benefits

Simple setup via a single quickstart call
Clear transport model using HTTP with TLS
Works with multi-region node options (US, EU)

⚠️ Limitations

No additional tools, configuration options, or capabilities are described beyond the deadman/heartbeat quickstart approach.

Captured live from the server via tools/list.

watch_register

Register a watch. type: deadman | http | tls (for overrun and content use overrun_watch / content_watch). target: URL (http/tls); omit for deadman. interval_s >= 300 on the free tier. condition: e.g. {"grace_s": 600} for deadman, {"max_ms": 2000} for http latency, {"warn_days": 14} for tls. Ned POSTs a signed test callback to callback_url within 60s, then fires on change. No agent key yet? Call this without one: the response includes agent_key (shown once). Store it and pass it as NED_AGENT_KEY next time.

Parameters5

type	string	required
callback_url	string	required
target	any	optional
interval_s	integer	optional
condition	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "title": "Type",
      "type": "string"
    },
    "callback_url": {
      "title": "Callback Url",
      "type": "string"
    },
    "target": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Target"
    },
    "interval_s": {
      "default": 300,
      "title": "Interval S",
      "type": "integer"
    },
    "condition": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Condition"
    }
  },
  "required": [
    "type",
    "callback_url"
  ],
  "title": "watch_registerArguments"
}

quickstart

The fastest way to be watched, in one call. Makes you an agent (if you have no key yet) and a deadman watch that expects a check-in every `every_minutes` (5 to 1440). Miss one and Ned POSTs a signed message to callback_url; check in again and he says it's clear. Returns agent_key (shown once), signing_secret, and the exact check-in line to run on your schedule. The first 5 watches are free.

Parameters2

callback_url	string	required
every_minutes	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "callback_url": {
      "title": "Callback Url",
      "type": "string"
    },
    "every_minutes": {
      "default": 60,
      "title": "Every Minutes",
      "type": "integer"
    }
  },
  "required": [
    "callback_url"
  ],
  "title": "quickstartArguments"
}

watch_get

Current state of one of your watches: status, fired, fire_count, next_check, last_state.

Parameters1

watch_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "watch_id": {
      "title": "Watch Id",
      "type": "string"
    }
  },
  "required": [
    "watch_id"
  ],
  "title": "watch_getArguments"
}

watch_cancel

Cancel a watch you registered. Frees a free-tier slot.

Parameters1

watch_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "watch_id": {
      "title": "Watch Id",
      "type": "string"
    }
  },
  "required": [
    "watch_id"
  ],
  "title": "watch_cancelArguments"
}

deadman_checkin

Check in on a deadman watch to keep it from firing. Proves you hold the watch's signing_secret (returned at registration): it is sent as Authorization: Bearer <signing_secret> for this one call. No agent key needed.

Parameters2

watch_id	string	required
signing_secret	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "watch_id": {
      "title": "Watch Id",
      "type": "string"
    },
    "signing_secret": {
      "title": "Signing Secret",
      "type": "string"
    }
  },
  "required": [
    "watch_id",
    "signing_secret"
  ],
  "title": "deadman_checkinArguments"
}

overrun_watch

Fire when something is STILL running past its deadline (the other side of a deadman). Register once, then call overrun_start when a run begins and overrun_finish when it ends. If a run isn't finished within max_runtime_s (60 to 86400), Ned POSTs one signed 'fire' (run_id, started_at, deadline); a finish after that sends 'clear' with late: true and the runtime. A start while a run is open closes the old one as superseded (no callback). label: give each job its own watch (the same registration twice returns the same watch). 1c/day; counts toward the free 5.

Parameters3

callback_url	string	required
max_runtime_s	integer	required
label	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "callback_url": {
      "title": "Callback Url",
      "type": "string"
    },
    "max_runtime_s": {
      "title": "Max Runtime S",
      "type": "integer"
    },
    "label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Label"
    }
  },
  "required": [
    "callback_url",
    "max_runtime_s"
  ],
  "title": "overrun_watchArguments"
}

overrun_start

A run began on an overrun watch. Returns run_id and deadline. Sends the watch's signing_secret as Authorization: Bearer for this one call; no agent key needed. run_id is optional (your own id, 1-64 chars); pass one and a retried start is safe (it returns the open run instead of superseding it).

Parameters3

watch_id	string	required
signing_secret	string	required
run_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "watch_id": {
      "title": "Watch Id",
      "type": "string"
    },
    "signing_secret": {
      "title": "Signing Secret",
      "type": "string"
    },
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    }
  },
  "required": [
    "watch_id",
    "signing_secret"
  ],
  "title": "overrun_startArguments"
}

overrun_finish

The run ended. Returns runtime_s and late. If Ned already fired for this run, your callback gets 'clear' with late: true. Finishing with no run open is an error (409).

Parameters3

watch_id	string	required
signing_secret	string	required
run_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "watch_id": {
      "title": "Watch Id",
      "type": "string"
    },
    "signing_secret": {
      "title": "Signing Secret",
      "type": "string"
    },
    "run_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Run Id"
    }
  },
  "required": [
    "watch_id",
    "signing_secret"
  ],
  "title": "overrun_finishArguments"
}

content_watch

Fire when a URL answers but says the wrong thing. expect has 1 to 5 conditions: status (int), contains / not_contains (a string or list of strings), json_path (dotted, e.g. "data.items.0.state") with equals (a JSON scalar) or exists (true/false). No regex. Pages over 256 KB fail as 'size'. The callback names the condition that failed, never the page's content. 2c/day at >= 60s, 7c at >= 30s; free within the first 5 at >= 300s. Example: expect={"status": 200, "json_path": "status", "equals": "ok"}

Parameters4

target	string	required
callback_url	string	required
expect	object	required
interval_s	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "target": {
      "title": "Target",
      "type": "string"
    },
    "callback_url": {
      "title": "Callback Url",
      "type": "string"
    },
    "expect": {
      "additionalProperties": true,
      "title": "Expect",
      "type": "object"
    },
    "interval_s": {
      "default": 300,
      "title": "Interval S",
      "type": "integer"
    }
  },
  "required": [
    "target",
    "callback_url",
    "expect"
  ],
  "title": "content_watchArguments"
}

balance

Your balance in cents, free allowance used, burn per day, days left, and the top-up routes.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "balanceArguments"
}

pricing

Ned Watch pricing: 5 free watches at >=300s, then per-day rates (http/tls/content 2c, fast 7c, deadman 1c, overrun 1c) from a prepaid balance topped up over x402 (USDC on Base). Public, no key needed. Paying is done against POST /v1/topup/{5,20,50}, not here.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "pricingArguments"
}

Install

Tools (11)

watch_registerquickstartwatch_getwatch_canceldeadman_checkinoverrun_watchoverrun_startoverrun_finish

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.ned.watch/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ned-watch": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.ned.watch/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

watch.ned/ned-watch (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

watch_register

quickstart

watch_get

watch_cancel

deadman_checkin

overrun_watch

overrun_start

overrun_finish

content_watch

balance

pricing

Install

Remote endpoint

Related servers