Skip to content

BetterStackHQ/cursor-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Better Stack plugin for Cursor

Connect Cursor to your Better Stack Uptime and Telemetry data through the Model Context Protocol (MCP). Your agent can query logs and metrics, build dashboards, manage uptime monitors, and respond to incidents, all in natural language.

Install

Add Better Stack to Cursor

Or add it manually to your Cursor mcp.json:

{
  "mcpServers": {
    "better-stack": {
      "type": "http",
      "url": "https://mcp.betterstack.com"
    }
  }
}

The first tool call opens a browser for OAuth sign-in. No token configuration needed.

What you can do

Try asking your agent things like:

  • "Show me all monitors that are currently down."
  • "What's the availability of my website this month?"
  • "What incidents occurred yesterday?"
  • "Who's on-call right now?"
  • "Acknowledge incident #1234 and add a comment about the fix."
  • "Build an explore query to find HTTP 500 errors in the last hour."
  • "Create a dashboard showing error rates for my API service."

Tools

The plugin exposes the full Better Stack MCP toolset:

  • Uptime: monitors, incidents, on-call schedules and escalation, heartbeats, status pages.
  • Telemetry: dashboards, charts, alerts, log/metric/error queries, sources and applications.
  • Documentation: search Better Stack docs from within Cursor.

The complete tool reference and example prompts live in the Better Stack MCP integration docs.

Authentication

OAuth is the recommended flow and works out of the box with Cursor. If you prefer an API token, you can pass it via the Authorization header instead. See API authentication:

{
  "mcpServers": {
    "better-stack": {
      "type": "http",
      "url": "https://mcp.betterstack.com",
      "headers": {
        "Authorization": "Bearer $TOKEN"
      }
    }
  }
}

Limiting available tools

Restrict which tools the agent can use with one of these headers:

  • X-MCP-Tools-Only: allowlist (only the listed tools are available)
  • X-MCP-Tools-Except: blocklist (all tools except the listed ones)
{
  "mcpServers": {
    "better-stack": {
      "type": "http",
      "url": "https://mcp.betterstack.com",
      "headers": {
        "X-MCP-Tools-Only": "uptime_list_monitors,uptime_get_monitor_tool,uptime_list_incidents"
      }
    }
  }
}

Useful for giving your agent read-only access, scoping it to a workflow, or trimming the initial context size.

Links

License

MIT. See LICENSE.

About

Better Stack plugin for Cursor: observability for AI agents (logs, metrics, dashboards, uptime, incidents).

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors