How to connect Better Stack to Grok Bot

Connect Grok Bot to Better Stack MCP. List active monitors with recent failures, show unresolved incidents from the last 24h, and more using natural language, with authentication handled for you.

Better Stack MCP logoBetter Stack MCP
Dcr Oauth

Better Stack is an observability platform for monitoring, incident management, and log aggregation. Use it to detect, investigate, and resolve incidents quickly with real-time alerts.

116 Tools

Introduction

Grok is xAI's assistant, and its bot builder lets you create a personal agent that holds context, runs skills, and connects to the apps you already use through plugins.

This guide explains how to connect Better Stack to a Grok bot using Composio Connect, which handles OAuth, token refresh, and reliability so you do not have to. You add Composio as a plugin, authenticate once, then ask your bot to work with Better Stack in plain language.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Better Stack MCP with

Why use Composio?

Composio exposes 1,700+ apps to your Grok bot through a single connection, so you get:

  • Connect to 1,700+ apps with on-demand tool loading, so you do not fill your context window with unnecessary tool definitions.
  • Use programmatic tool calling through a remote workbench, letting the model write its own code to handle complex tool chaining. This reduces back-and-forth for frequent tool calls.
  • Handle large tool responses outside the model context to keep conversations lean.

Connecting Better Stack to Grok Bot

Once Grok Bot is set up, you connect Better Stack entirely from its interface, and the whole flow takes under a minute.

Set up Grok Bot

Get access. Grok Bot is included with Cursor Ultra, Cursor Premium Teams, and SuperGrok Heavy. Get the desktop app for macOS or Windows from x.ai/bot and sign in. An iPhone companion app is also available, and your bots sync across devices.

Create a bot. Pick a suggested role or define your own, then give it a short name, one primary job, and a short description of how it should work. Focused bots work best, because a clear role gives the bot more useful context over time.

Connect Better Stack

1. Add the Composio plugin

Click the button. The Composio listing on x.ai opens and launches Grok Bot for you. If the app does not open on its own, click Add to Grok Bot.

Add to Grok Bot

Composio for Grok Bot listing on x.ai with the Add to Grok Bot button

Grok Bot opens the Composio plugin, showing its connector and skills. Click Add.

Composio plugin sheet in Grok Bot with the Add button

2. Authenticate

Go to the Installed section and click the Composio entry. You'll see its connector and skills listed.

Installed Composio plugin showing the Authenticate button

Click Authenticate. You'll be taken to the Composio consent screen. Review the access it requests and click Authorize. Composio handles the OAuth handshake for you, so you never touch API keys or tokens.

Composio authorization screen with Authorize and Deny

3. Connect your Better Stack account

Back in the chat, ask your bot to connect to Better Stack or give it any Better Stack task.

For example, ask it to:

  • "List active monitors with recent failures"
  • "Show unresolved incidents from the last 24h"
  • "Search logs for 'database connection' errors"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in your Grok bot, and your Better Stack account is ready to use.

What is Grok Bot?

Grok is xAI's assistant, available as a chat interface and a bot builder for creating personal agents that run skills and connect to external apps.

With Composio Connect, your Grok bot can securely access apps like Better Stack through MCP without you sharing account credentials directly with the agent.

What is the Better Stack MCP server, and what's possible with it?

The Better Stack MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Better Stack account. It provides structured and secure access to your observability applications, dashboards, monitors, alerts, incidents, and log sources, so your agent can inspect observability data, build dashboards, configure monitoring, manage incidents, and publish status updates on your behalf.

  • Application and log source management: Have your agent review applications, create or edit applications, configure log sources, and define metric expressions from logs.
  • Dashboards and charts: Let the agent create dashboards, add charts and sections, inspect chart queries and settings, or update existing charts.
  • Monitors, heartbeats, and alerts: Direct your agent to create availability monitors and heartbeats, configure chart alerts, and review current alert settings and incident details.
  • Incident coordination: Instruct your agent to create or acknowledge incidents, add incident comments, and review available escalation policies.
  • Status page communication: Have your agent create status page reports, post updates to existing reports, and organize monitored resources into status page sections.

Way Forward

Now that Better Stack is connected, extend your setup by connecting the other apps you already use every day, so your Grok bot can run true cross-app workflows end to end.

  • Connect Calendar to turn threads into scheduled meetings automatically.
  • Connect Slack or Teams to post summaries, approvals, and alerts where your team works.
  • Connect Notion, Linear, Jira, or Asana to convert requests into tickets, tasks, and docs.
  • Connect Drive, Dropbox, or OneDrive to fetch, file, and share attachments without manual steps.

Start with one workflow you do repeatedly, then keep adding apps as you find new handoffs. With everything behind a single connection, your bot can coordinate multiple tools safely and reliably in one conversation.

TOOLS

Supported Tools

Every Better Stack MCP action and event your agent gets out of the box.

Acknowledge incident

Acknowledge an ongoing incident

Add chart to dashboard

Add a new chart to a dashboard.

Add dashboard section

Add a section divider to a dashboard.

Application

Get comprehensive details of a specific application including its configuration, retention settings, ingestion details, custom bucket settings (if configured)

Applications

List all available applications in a paginated table format.

Available incident escalation policies

Get available escalation policies for an incident

Change team member role

Change a team member's role.

Chart

Get detailed information about a specific chart including its SQL queries, configuration, and settings.

Chart alert

Get detailed information about a specific chart alert including its configuration, SQL queries, status, and current incident info.

Chart alert help

Get instructions for creating and configuring chart alerts, including alert types, operators, configuration fields, supported chart types, and common mistakes.

Chart alerts

List chart alerts with optional filtering by team, chart, or dashboard.

Chart building help

Get comprehensive instructions for building charts and dashboards, including chart types, units, axis settings, column mapping, legend placement, layout tips, and common mistakes.

Clusters

List all available storage clusters for a specific team.

Create application

Create a new application in Better Stack.

Create chart alert

Create a new chart alert on an existing chart.

Create cloud connection

Create a secure cloud connection for direct ClickHouse query access to logs, spans, and metrics data.

Create dashboard

Create a new dashboard.

Create error issue

Create an issue for an error in Linear, or a work item in Jira, through the team's integration and link the two.

Create heartbeat

Create 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 incident

Create a new incident providing a summary of the issue, requester email, and other optional details

Create incident comment

Create a comment on an incident

Create metric expression

Create a new metric expression (extract-metrics-from-logs rule) on a source.

Create monitor

Create a new monitor that tracks the availability of a website, host, or service.

Create release

Register a release for an errors application, so it appears the moment it deploys instead of when its first error arrives.

Create source

Create a new log source in Better Stack.

Create status page report

Create a new status page report

Create status page report update

Create a new status update for an existing status page report

Create status page resource

Add a resource (monitor, heartbeat, or group) to a status page.

Create status page section

Create a section (resource group) on a status page to group resources under a heading

Dashboard

Get detailed information about a specific dashboard including its charts, sections, layout, template variables, and configuration.

Dashboard query help

Get instructions for writing a ClickHouse query to use inside a Better Stack **Dashboard** chart (or chart alert).

Dashboards

List all available dashboards in a paginated table format.

Dashboard templates

List all available dashboard templates in a paginated table format.

Data regions

List all available data regions and clusters for application and source creation.

Delete chart alert

Delete a chart alert permanently.

Delete metric expression

Delete a metric expression from a source.

Documentation

Search for relevant documentation articles and return their contents

Edit application

Edit an existing application in Better Stack - rename it, pause or resume ingesting, or set its VRL transformations, including the exception grouping program.

Edit chart

Edit an existing chart name, query, type, or settings.

Edit chart alert

Edit an existing chart alert configuration.

Edit dashboard

Edit an existing dashboard's name or source eligibility.

Edit dashboard section

Edit an existing dashboard section.

Error

Get comprehensive details of a specific error including its type, message, call site information, first occurrence, current state (unhandled, unresolved, ignored, resolved, or reoccurred), and linked Linear/Jira issues

Errors

List error patterns for an application with occurrence counts, affected users, current state, and links.

Errors query help

Get comprehensive instructions for building SQL ClickHouse queries for error tracking, including both error patterns (metrics) and individual exceptions.

Escalate incident

Escalate an ongoing incident to a user, team, schedule, or policy

Escalation policies

List all escalation policies with their steps and configuration

Escalation policy

Get detailed information about a specific escalation policy

Exploration

Get detailed information about a specific exploration (saved Explore query) including its sources, chart type, template variables, saved time range, and query.

Explorations

List saved explorations (saved Explore queries) in a paginated table.

Explore logs query help

Get instructions for writing a ClickHouse query to use inside the Better Stack **Explore logs** page (and live-tail charts) for log and span data.

Export dashboard

Export a dashboard configuration as JSON.

Heartbeat

Get details of a specific heartbeat

Heartbeat availability

Get availability summary for a specific heartbeat

Heartbeats

List all heartbeats with filtering and pagination options

Import dashboard

Import a dashboard from JSON configuration.

Incident

Get detailed information about a specific incident

Incident comments

Get comments for an incident

Incidents

List incidents with filtering and pagination options

Incident timeline

Get the timeline of events for an incident

Invite team member

Invite someone to a Better Stack team by e-mail address.

Link error issue

Link an error to an issue or work item that already exists in Linear or Jira.

Metric

Get comprehensive details about a specific metric.

Metric expressions

List the metric expressions (extract-metrics-from-logs rules) on a source.

Metrics query help

Get instructions for building SQL ClickHouse queries for metrics (available metrics, aggregations, examples) to run directly via the query tools (`query` / `render_chart`), using concrete `remote(.

Metrics schema

Get metrics and cardinality for a source.

Monitor

Get details of a specific monitor

Monitor availability

Get availability (SLA) summary for a specific monitor

Monitor response times

Get response time metrics for a specific monitor

Monitors

List monitors with optional filtering and pagination

Move charts

Move one or more charts to new positions on a dashboard.

On call

Get detailed information about a specific on-call calendar or the default calendar

On call event

Get detailed information about a specific on-call event

On call events

List all on-call schedule events for a specific calendar

On call rotation

Get on-call rotation configuration for a specific calendar

On calls

List all on-call calendars for the team

Query

Execute a ClickHouse SQL query to retrieve logs, traces/spans, errors, and metrics from telemetry data.

Query help

Get instructions for building SQL ClickHouse queries for logs and spans (fields, aggregations, examples) to run directly via the query tools (query / render_chart) against the ClickHouse proxy.

Releases

List all releases for a specific application in a paginated table format.

Remove chart

Remove a chart from its dashboard permanently.

Remove dashboard

Remove a dashboard permanently.

Remove dashboard section

Remove a section divider from a dashboard permanently.

Remove dashboard variable

Remove a dashboard template variable by name.

Remove exploration variable

Remove a variable from an exploration (saved Explore query) by name.

Remove release

Remove a release permanently.

Remove status page resource

Remove a resource from a status page

Remove status page section

Remove a section from a status page.

Remove team member

Remove a member from a Better Stack team, or cancel a pending invitation.

Render chart

Execute a ClickHouse SQL query and visualize the result as a chart.

Reopen incident

Reopen a resolved incident (must be within 24 hours of resolution)

Replays query help

Get comprehensive instructions for building SQL ClickHouse queries for session replays.

Resolve incident

Resolve an ongoing incident

Set dashboard variable

Create or update a dashboard template variable — a user-facing filter in the dashboard toolbar, referenced in chart SQL as `{{name}}` (required — the chart errors until it resolves to a value) or `[[ AND col = {{name}} ]]` (optional — the whole `[[ .

Set exploration variable

Create or update a variable on an exploration (saved Explore query), referenced in its query as `{{name}}`.

Severities

List all severities (urgency levels) with their notification settings

Severity

Get detailed information about a specific severity (urgency level)

Source

Get comprehensive details of a specific source including its configuration, retention settings, ingestion details, custom bucket settings (if configured)

Source fields

Get complete field catalog for a logs or spans source.

Sources

List all available sources in a paginated table format.

Status page

Get details of a specific status page

Status page reports

List status reports (incidents/maintenance) for a specific status page

Status page report update

Get details of a specific status page report update

Status page report updates

List status updates for a specific status report

Status page resources

Get resources (monitors/heartbeats) for a specific status page

Status pages

List all status pages with filtering and pagination options

Status page sections

List the sections (resource groups) of a status page

Team members

List the members of a Better Stack team, including pending invitations.

Team roles

List the roles defined in a Better Stack organization, including their role_id and system-role identifier (admin, billing_admin, team_lead, responder, member, or "custom").

Teams

List all available teams in Better Stack Logs.

Toggle chart alert pause

Pause or unpause a chart alert.

Unlink error issue

Remove the link between an error and an issue in Linear, Jira, or GitLab.

Update error state

Update the state of a specific error (mark as resolved, ignored, or unresolved)

Update metric expression

Update an existing metric expression.

Update status page

Update the settings of a status page (company name, contact URL, theme, layout, and more)

Update status page resource

Update a resource on a status page.

Update status page section

Rename a status page section or move it by setting its position

FAQ

Frequently asked questions

Start with Better Stack MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Better Stack MCP tool your agent needs.Free to start.

Start building