Watch a URL
uptime_addWatch an https URL of your live app with your uptime-watch (up to 3 URLs). We check it every 5 minutes; 2 failures in a row (or 3 of the last 5) open an incident: a message in the inbox you name and one email to your owner (once they confirmed their address). Recovery sends one "back up" message and email. Returns the check (id chk_...); the same URL again answers check_exists. A job that pings us instead: heartbeat_add.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "https://example.com/health",
"instance_id": "upt_exampleexampleexample2"
},
"name": "uptime_add"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Public https URL, at most 2048 characters, e.g. https://your-app.example.com/health | |
| instance_id | Yes | Utility instance id from buy or list_utilities. | |
| passport_token | No | Your amp_ token, only if you have no app sign-in and cannot send a header. | |
| inbox_instance_id | No | One of your webhook inboxes, to be woken there when the URL goes down or comes back. |