byok-observability-mcp

Check Grafana connectivity and retrieve version and database status. Use this to verify the Grafana integration is working.

List all datasources configured in Grafana (name, type, UID). Use this to find the UID needed for grafana_query_metrics.

Execute a PromQL expression via a Grafana Prometheus datasource and return the results. Use grafana_list_datasources first to find the datasource UID.

List dashboards in Grafana with an optional search query. Returns UID, title, folder, and tags.

Get full details of a Grafana dashboard including all panels, by its UID. Use grafana_list_dashboards to find the UID.

List active (or filtered) alerts from Grafana Alertmanager. Supports filtering by state and label selectors. Returns alert name, state, severity, labels, annotations, and start time. Use this to answer 'are there any firing alerts right now?'

List all configured Grafana alert rules from the provisioning API. Returns rule UID, title, condition, labels, annotations, folder, and rule group. Use this to see what alert rules are defined.

Check Prometheus connectivity. Returns healthy/unhealthy status.

Execute an instant PromQL query and return the current value(s). Best for checking current state of a metric (e.g. CPU usage right now).

Execute a PromQL range query and return a time series. Use this to see how a metric changed over time.

List all available metric names in Prometheus. Useful for discovery when you don't know the exact metric name.

Get help text, type, and unit for a specific Prometheus metric. Omit metric_name to list all metadata.

List all Kafka clusters configured in Kafka UI. Returns name, status, broker count, topic count, and partition info.

List topics in a Kafka cluster with partition count, replication factor, and under-replicated partition count.

Get detailed information about a specific Kafka topic including partition layout, replication, and segment info.

List consumer groups in a Kafka cluster with their state and member count.

Get consumer lag for a specific consumer group — per-partition offset, end offset, and lag. Highlights partitions with non-zero lag.

Get broker health for a Kafka cluster — broker IDs, hosts, ports, and disk usage.

List currently open OpsGenie alerts. Returns ID, tinyId, message, priority, and acknowledged status.

List current on-call participants for all schedules. Helps you find who to page.

Acknowledge an open OpsGenie alert to prevent escalations.

Run a health check across all configured observability backends (Grafana, Prometheus, Kafka UI, Datadog) in parallel and return a status summary table. Use this to answer 'are all systems up?'

Meta-tool that performs parallel root cause analysis (RCA) queries across all enabled backends. Automatically checks Grafana for firing alerts, Prometheus for offline endpoints (up==0), and Kafka clusters for offline brokers.