111 available actions
What your AI agent can do in Better Stack MCP
Investigate Better Stack observability data, monitors, incidents, and logs. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 111 actions.
Common starting points
- Export dashboardExport a dashboard configuration as JSON.
- QueryExecute a ClickHouse SQL query to retrieve logs, traces/spans, errors, and metrics from telemetry data.
- Add chart to dashboardAdd a new chart to a dashboard.
- Add dashboard sectionAdd a section divider to a dashboard.
- Update error stateUpdate the state of a specific error (mark as resolved, ignored, or unresolved)
- Update metric expressionUpdate an existing metric expression.
Browse all 111 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 3 actions
- Export dashboardExport a dashboard configuration as JSON.
- QueryExecute a ClickHouse SQL query to retrieve logs, traces/spans, errors, and metrics from telemetry data.
- Query helpGet instructions for building SQL ClickHouse queries for logs and spans (fields, aggregations, examples) to run directly via the query tools (query / render_chart)…
Create & communicateCreate records or send supported messagesView 17 actions
- Add chart to dashboardAdd a new chart to a dashboard.
- Add dashboard sectionAdd a section divider to a dashboard.
- Create applicationCreate a new application in Better Stack.
- Create chart alertCreate a new chart alert on an existing chart.
- Create cloud connectionCreate a secure cloud connection for direct ClickHouse query access to logs, spans, and metrics data.
- Create dashboardCreate a new dashboard.
- Create heartbeatCreate a new heartbeat that expects a periodic request from a cron job, worker, or other background task, and alerts when that request stops arriving.
- Create incidentCreate a new incident providing a summary of the issue, requester email, and other optional details
- Create incident commentCreate a comment on an incident
- Create metric expressionCreate a new metric expression (extract-metrics-from-logs rule) on a source.
- Create monitorCreate a new monitor that tracks the availability of a website, host, or service.
- Create sourceCreate a new log source in Better Stack.
- Create status page reportCreate a new status page report
- Create status page report updateCreate a new status update for an existing status page report
- Create status page resourceAdd a resource (monitor, heartbeat, or group) to a status page.
- Create status page sectionCreate a section (resource group) on a status page to group resources under a heading
- Import dashboardImport a dashboard from JSON configuration.
Update & manageChange and manage existing recordsView 14 actions
- Change team member roleChange a team member's role.
- Edit applicationEdit an existing application in Better Stack - rename it, pause or resume ingesting, or set its VRL transformations, including the exception grouping program.
- Edit chartEdit an existing chart name, query, type, or settings.
- Edit chart alertEdit an existing chart alert configuration.
- Edit dashboardEdit an existing dashboard's name or source eligibility.
- Edit dashboard sectionEdit an existing dashboard section.
- Move chartsMove one or more charts to new positions on a dashboard.
- Set dashboard variableCreate or update a dashboard template variable — a user-facing filter in the dashboard toolbar, referenced in chart SQL as (required — the chart errors until it…
- Set exploration variableCreate or update a variable on an exploration (saved Explore query), referenced in its query as .
- Update error stateUpdate the state of a specific error (mark as resolved, ignored, or unresolved)
- Update metric expressionUpdate an existing metric expression.
- Update status pageUpdate the settings of a status page (company name, contact URL, theme, layout, and more)
- Update status page resourceUpdate a resource on a status page.
- Update status page sectionRename a status page section or move it by setting its position
Remove & cancelRemove records or cancel supported workView 10 actions
- Delete chart alertDelete a chart alert permanently.
- Delete metric expressionDelete a metric expression from a source.
- Remove chartRemove a chart from its dashboard permanently.
- Remove dashboardRemove a dashboard permanently.
- Remove dashboard sectionRemove a section divider from a dashboard permanently.
- Remove dashboard variableRemove a dashboard template variable by name.
- Remove exploration variableRemove a variable from an exploration (saved Explore query) by name.
- Remove status page resourceRemove a resource from a status page
- Remove status page sectionRemove a section from a status page.
- Remove team memberRemove a member from a Better Stack team, or cancel a pending invitation.
Other actionsSpecialist and administrative actions.View 67 actions
- Acknowledge incidentAcknowledge an ongoing incident
- ApplicationGet comprehensive details of a specific application including its configuration, retention settings, ingestion details, custom bucket settings (if configured)
- ApplicationsList all available applications in a paginated table format.
- Available incident escalation policiesGet available escalation policies for an incident
- ChartGet detailed information about a specific chart including its SQL queries, configuration, and settings.
- Chart alertGet detailed information about a specific chart alert including its configuration, SQL queries, status, and current incident info.
- Chart alert helpGet instructions for creating and configuring chart alerts, including alert types, operators, configuration fields, supported chart types, and common mistakes.
- Chart alertsList chart alerts with optional filtering by team, chart, or dashboard.
- Chart building helpGet comprehensive instructions for building charts and dashboards, including chart types, units, axis settings, column mapping, legend placement, layout tips, and…
- ClustersList all available storage clusters for a specific team.
- DashboardGet detailed information about a specific dashboard including its charts, sections, layout, template variables, and configuration.
- Dashboard query helpGet instructions for writing a ClickHouse query to use inside a Better Stack **Dashboard** chart (or chart alert).
- DashboardsList all available dashboards in a paginated table format.
- Dashboard templatesList all available dashboard templates in a paginated table format.
- Data regionsList all available data regions and clusters for application and source creation.
- DocumentationSearch for relevant documentation articles and return their contents
- ErrorGet comprehensive details of a specific error including its type, message, call site information, first occurrence, current state (unhandled, unresolved, ignored…
- ErrorsList error patterns for an application with occurrence counts, affected users, current state, and links.
- Errors query helpGet comprehensive instructions for building SQL ClickHouse queries for error tracking, including both error patterns (metrics) and individual exceptions.
- Escalate incidentEscalate an ongoing incident to a user, team, schedule, or policy
- Escalation policiesList all escalation policies with their steps and configuration
- Escalation policyGet detailed information about a specific escalation policy
- ExplorationGet detailed information about a specific exploration (saved Explore query) including its sources, chart type, template variables, saved time range, and query.
- ExplorationsList saved explorations (saved Explore queries) in a paginated table.
- Explore logs query helpGet instructions for writing a ClickHouse query to use inside the Better Stack **Explore logs** page (and live-tail charts) for log and span data.
- HeartbeatGet details of a specific heartbeat
- Heartbeat availabilityGet availability summary for a specific heartbeat
- HeartbeatsList all heartbeats with filtering and pagination options
- IncidentGet detailed information about a specific incident
- Incident commentsGet comments for an incident
- IncidentsList incidents with filtering and pagination options
- Incident timelineGet the timeline of events for an incident
- Invite team memberInvite someone to a Better Stack team by e-mail address.
- MetricGet comprehensive details about a specific metric.
- Metric expressionsList the metric expressions (extract-metrics-from-logs rules) on a source.
- Metrics query helpGet instructions for building SQL ClickHouse queries for metrics (available metrics, aggregations, examples) to run directly via the query tools ( / ), using concrete /…
- Metrics schemaGet metrics and cardinality for a source.
- MonitorGet details of a specific monitor
- Monitor availabilityGet availability (SLA) summary for a specific monitor
- Monitor response timesGet response time metrics for a specific monitor
- MonitorsList monitors with optional filtering and pagination
- On callGet detailed information about a specific on-call calendar or the default calendar
- On call eventGet detailed information about a specific on-call event
- On call eventsList all on-call schedule events for a specific calendar
- On call rotationGet on-call rotation configuration for a specific calendar
- On callsList all on-call calendars for the team
- ReleasesList all releases for a specific application in a paginated table format.
- Render chartExecute a ClickHouse SQL query and visualize the result as a chart.
- Reopen incidentReopen a resolved incident (must be within 24 hours of resolution)
- Replays query helpGet comprehensive instructions for building SQL ClickHouse queries for session replays.
- Resolve incidentResolve an ongoing incident
- SeveritiesList all severities (urgency levels) with their notification settings
- SeverityGet detailed information about a specific severity (urgency level)
- SourceGet comprehensive details of a specific source including its configuration, retention settings, ingestion details, custom bucket settings (if configured)
- Source fieldsGet complete field catalog for a logs or spans source.
- SourcesList all available sources in a paginated table format.
- Status pageGet details of a specific status page
- Status page reportsList status reports (incidents/maintenance) for a specific status page
- Status page report updateGet details of a specific status page report update
- Status page report updatesList status updates for a specific status report
- Status page resourcesGet resources (monitors/heartbeats) for a specific status page
- Status pagesList all status pages with filtering and pagination options
- Status page sectionsList the sections (resource groups) of a status page
- Team membersList the members of a Better Stack team, including pending invitations.
- Team rolesList the roles defined in a Better Stack organization, including their role_id and system-role identifier (admin, billing_admin, team_lead, responder, member, or…
- TeamsList all available teams in Better Stack Logs.
- Toggle chart alert pausePause or unpause a chart alert.
Connection record
A connection you can control.
- Sign-in
- OAuth sign-in
- Setup
- Sign in with your own Better Stack MCP account. Access is limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Better Stack MCP
How does the agent connect to Better Stack MCP?
You sign in with your own Better Stack MCP account. Permissions are limited to what the agent needs, the connection is health-checked, and you can revoke access from Better Stack MCP at any time.
What can the agent actually do in Better Stack MCP?
The page above lists the 111 actions currently available through the Better Stack MCP connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Better Stack MCP included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Better Stack MCP is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Better Stack MCP to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.