Monitors

Delete a monitor and stop the recurring charge

Removes the monitor and its check history. The scheduled checks stop, and so does the only recurring cost on the platform.

delete_monitor

What it is

The job: Turn off a watch you no longer need.

Monitors are the one part of Twin Browser that spends credits without you calling anything, so deleting them is the one cleanup that has an ongoing cost attached. The monitor and its check history are removed together.

If you want to stop the checks but keep the definition, PATCH the monitor to active: false over REST instead — the MCP surface has delete but not pause.

The call

Call it exactly like this.

Copied from the tool's registration and the route handler — not paraphrased.

MCPdelete_monitor.mcp.jsonjson
// MCP tool call — server "twin-browser"
{
  "tool": "delete_monitor",
  "arguments": {
    "id": "…"
  }
}
DELETE /api/v1/monitors/{id}request.shbash
curl -X DELETE "https://twin-browser.com/api/v1/monitors/MONITOR_ID" \
  -H "Authorization: Bearer $TWIN_API_KEY"
Parameters accepted by delete_monitor
ParameterTypeWhat it does
id*stringThe monitor id, from list_monitors.

Returns

response.jsonjson
{ "deleted": true }

What it costs

Free

Deleting costs nothing and stops the recurring per-check charge from the next tick onward.

See the full rate card

Which one

When a different tool is the right call.

The honest answer is often the neighbouring tool. These are the trades.

list_monitors

Get the id from there first. There is no delete-by-name.

list_monitors

Questions

delete_monitor, answered.

Can I pause a monitor instead of deleting it?
Yes, over REST: PATCH /api/v1/monitors/{id} updates active, interval, callback, selector and watch spec. The MCP tool set covers create, list, history and delete, so a pause is one of the things worth reaching for the REST API for.