Better Stack MCP by usefulapi is an MCP server published by io.usefulapi, hosted at betterstack.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 9 tools, including betterstack_list_monitors, betterstack_get_monitor, betterstack_list_incidents, betterstack_get_incident, betterstack_list_heartbeats.
Read monitors, incidents, heartbeats, on-call and status pages; acknowledge or resolve incidents.
3,918 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List uptime monitors with their status (up/down/paused/pending/maintenance/validating), check frequency, and alert settings. Good first call to discover what is being monitored. Uptime API: GET /api/v2/monitors.
| Parameter | Type | Description |
|---|---|---|
| url | string | Filter monitors by their monitored URL. |
| page | integer | Page number for pagination (default 1). |
| per_page | integer | Results per page. |
| team_name | string | Filter by team name (only when using a global API token). |
| pronounceable_name | string |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| Filter monitors by their pronounceable name. |
{
"name": "betterstack_list_monitors",
"title": "List monitors",
"description": "List uptime monitors with their status (up/down/paused/pending/maintenance/validating), check frequency, and alert settings. Good first call to discover what is being monitored. Uptime API: GET /api/v2/monitors.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"url": {
"type": "string",
"description": "Filter monitors by their monitored URL."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number for pagination (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 250,
"description": "Results per page.",
"exclusiveMinimum": 0
},
"team_name": {
"type": "string",
"description": "Filter by team name (only when using a global API token)."
},
"pronounceable_name": {
"type": "string",
"description": "Filter monitors by their pronounceable name."
}
}
},
"annotations": {
"title": "List monitors",
"readOnlyHint": true
}
}Get a single monitor by id, including current status, last_checked_at, SSL/HTTP settings, regions, and alerting configuration. Uptime API: GET /api/v2/monitors/{id}.
| Parameter | Type | Description |
|---|---|---|
| monitor_id * | string | The monitor id (from betterstack_list_monitors). |
{
"name": "betterstack_get_monitor",
"title": "Get a monitor",
"description": "Get a single monitor by id, including current status, last_checked_at, SSL/HTTP settings, regions, and alerting configuration. Uptime API: GET /api/v2/monitors/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"monitor_id"
],
"properties": {
"monitor_id": {
"type": "string",
"description": "The monitor id (from betterstack_list_monitors)."
}
}
},
"annotations": {
"title": "Get a monitor",
"readOnlyHint": true
}
}List incidents (alerts triggered by monitors/heartbeats), filterable by date range, monitor, and acknowledged/resolved state. Each incident carries cause, started_at, acknowledged_at, resolved_at. Uptime API: GET /api/v3/incidents.
| Parameter | Type | Description |
|---|---|---|
| to | string | End date yyyy-mm-dd (inclusive). |
| from | string | Start date yyyy-mm-dd (inclusive). |
| page | integer | Page number for pagination (default 1). |
| per_page | integer | Results per page. |
| resolved | boolean | true = only resolved, false = only unresolved. |
| team_name | string | Filter by team name (only when using a global API token). |
| monitor_id | string | Only incidents for this monitor id. |
| acknowledged | boolean | true = only acknowledged, false = only unacknowledged. |
| heartbeat_id | string | Only incidents for this heartbeat id. |
{
"name": "betterstack_list_incidents",
"title": "List incidents",
"description": "List incidents (alerts triggered by monitors/heartbeats), filterable by date range, monitor, and acknowledged/resolved state. Each incident carries cause, started_at, acknowledged_at, resolved_at. Uptime API: GET /api/v3/incidents.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date yyyy-mm-dd (inclusive)."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date yyyy-mm-dd (inclusive)."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number for pagination (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 250,
"description": "Results per page.",
"exclusiveMinimum": 0
},
"resolved": {
"type": "boolean",
"description": "true = only resolved, false = only unresolved."
},
"team_name": {
"type": "string",
"description": "Filter by team name (only when using a global API token)."
},
"monitor_id": {
"type": "string",
"description": "Only incidents for this monitor id."
},
"acknowledged": {
"type": "boolean",
"description": "true = only acknowledged, false = only unacknowledged."
},
"heartbeat_id": {
"type": "string",
"description": "Only incidents for this heartbeat id."
}
}
},
"annotations": {
"title": "List incidents",
"readOnlyHint": true
}
}Get a single incident by id, including cause, status, timeline timestamps (started/acknowledged/resolved), who acknowledged/resolved it, and the related monitor. Uptime API: GET /api/v3/incidents/{id}.
| Parameter | Type | Description |
|---|---|---|
| incident_id * | string | The incident id (from betterstack_list_incidents). |
{
"name": "betterstack_get_incident",
"title": "Get an incident",
"description": "Get a single incident by id, including cause, status, timeline timestamps (started/acknowledged/resolved), who acknowledged/resolved it, and the related monitor. Uptime API: GET /api/v3/incidents/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"incident_id"
],
"properties": {
"incident_id": {
"type": "string",
"description": "The incident id (from betterstack_list_incidents)."
}
}
},
"annotations": {
"title": "Get an incident",
"readOnlyHint": true
}
}List heartbeats (cron/background-job monitors that expect a periodic ping), with period, grace, and status (up/down/paused/pending). Uptime API: GET /api/v2/heartbeats.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (default 1). |
| per_page | integer | Results per page. |
| team_name | string | Filter by team name (only when using a global API token). |
{
"name": "betterstack_list_heartbeats",
"title": "List heartbeats",
"description": "List heartbeats (cron/background-job monitors that expect a periodic ping), with period, grace, and status (up/down/paused/pending). Uptime API: GET /api/v2/heartbeats.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number for pagination (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 250,
"description": "Results per page.",
"exclusiveMinimum": 0
},
"team_name": {
"type": "string",
"description": "Filter by team name (only when using a global API token)."
}
}
},
"annotations": {
"title": "List heartbeats",
"readOnlyHint": true
}
}List on-call calendars/schedules and the users currently on call for escalation. Useful to see who gets paged. Uptime API: GET /api/v2/on-calls.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (default 1). |
| per_page | integer | Results per page. |
| team_name | string | Filter by team name (only when using a global API token). |
{
"name": "betterstack_list_on_call",
"title": "List on-call schedules",
"description": "List on-call calendars/schedules and the users currently on call for escalation. Useful to see who gets paged. Uptime API: GET /api/v2/on-calls.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number for pagination (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 250,
"description": "Results per page.",
"exclusiveMinimum": 0
},
"team_name": {
"type": "string",
"description": "Filter by team name (only when using a global API token)."
}
}
},
"annotations": {
"title": "List on-call schedules",
"readOnlyHint": true
}
}List public/private status pages with company name, subdomain, aggregate_state, and published flag. Uptime API: GET /api/v2/status-pages.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (default 1). |
| per_page | integer | Results per page. |
| team_name | string | Filter by team name (only when using a global API token). |
{
"name": "betterstack_list_status_pages",
"title": "List status pages",
"description": "List public/private status pages with company name, subdomain, aggregate_state, and published flag. Uptime API: GET /api/v2/status-pages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page number for pagination (default 1).",
"exclusiveMinimum": 0
},
"per_page": {
"type": "integer",
"maximum": 250,
"description": "Results per page.",
"exclusiveMinimum": 0
},
"team_name": {
"type": "string",
"description": "Filter by team name (only when using a global API token)."
}
}
},
"annotations": {
"title": "List status pages",
"readOnlyHint": true
}
}Acknowledge an ongoing incident, signalling that someone is looking into it (stops further escalation). Idempotent-ish: acknowledging an already-acknowledged incident returns HTTP 409. Uptime API: POST /api/v3/incidents/{id}/acknowledge.
| Parameter | Type | Description |
|---|---|---|
| incident_id * | string | The incident id to acknowledge (from betterstack_list_incidents). |
| acknowledged_by * | string | User e-mail or a custom identifier of who is acknowledging the incident. |
{
"name": "betterstack_acknowledge_incident",
"title": "Acknowledge an incident",
"description": "Acknowledge an ongoing incident, signalling that someone is looking into it (stops further escalation). Idempotent-ish: acknowledging an already-acknowledged incident returns HTTP 409. Uptime API: POST /api/v3/incidents/{id}/acknowledge.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"incident_id",
"acknowledged_by"
],
"properties": {
"incident_id": {
"type": "string",
"description": "The incident id to acknowledge (from betterstack_list_incidents)."
},
"acknowledged_by": {
"type": "string",
"description": "User e-mail or a custom identifier of who is acknowledging the incident."
}
}
},
"annotations": {
"title": "Acknowledge an incident",
"readOnlyHint": false,
"idempotentHint": true
}
}Resolve an ongoing incident, marking it as handled/closed. Idempotent-ish: resolving an already-resolved incident returns HTTP 409. Uptime API: POST /api/v3/incidents/{id}/resolve.
| Parameter | Type | Description |
|---|---|---|
| incident_id * | string | The incident id to resolve (from betterstack_list_incidents). |
| resolved_by * | string | User e-mail or a custom identifier of who is resolving the incident. |
{
"name": "betterstack_resolve_incident",
"title": "Resolve an incident",
"description": "Resolve an ongoing incident, marking it as handled/closed. Idempotent-ish: resolving an already-resolved incident returns HTTP 409. Uptime API: POST /api/v3/incidents/{id}/resolve.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"incident_id",
"resolved_by"
],
"properties": {
"incident_id": {
"type": "string",
"description": "The incident id to resolve (from betterstack_list_incidents)."
},
"resolved_by": {
"type": "string",
"description": "User e-mail or a custom identifier of who is resolving the incident."
}
}
},
"annotations": {
"title": "Resolve an incident",
"readOnlyHint": false,
"idempotentHint": true
}
}Tools for Better Stack, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which of our websites are down right now?"; "Show me all incidents from the last 7 days and how long each lasted."; "Who is on call for our team right now, and for which schedule?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Better Stack data. Free plan: 50 tool calls per month. Run betterstack_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run betterstack_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run betterstack_upgrade without a plan: it returns both plans, each with a payment link for the user to open. betterstack_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.