mcp-grafana

# Grafana MCP server [](https://github.com/grafana/mcp-grafana/actions/workflows/unit.yml) [](https://github.com/grafana/mcp-grafana/actions/workflows/integration.yml) [](https://github.com/grafana/mcp-grafana/actions/workflows/e2e.yml) [](https://pkg.go.dev/github.com/grafana/mcp-grafana) [](https://archestra.ai/mcp-catalog/grafana__mcp-grafana) A [Model Context Protocol][mcp] (MCP) server for Grafana. This provides access to your Grafana instance and the surrounding ecosystem. ## Requirements - **Grafana version 9.0 or later** is required for full functionality. Some features, particularly datasource-related operations, may not work correctly with earlier versions due to missing API endpoints. ## Features _The following features are currently available in MCP server. This list is for informational purposes only and does not represent a roadmap or commitment to future features._ ### Dashboards - **Search for dashboards:** Find dashboards by title or other metadata - **Get dashboard by UID:** Retrieve full dashboard details using its unique identifier. _Warning: Large dashboards can consume significant context window space._ - **Get dashboard summary:** Get a compact overview of a dashboard including title, panel count, panel types, variables, and metadata without the full JSON to minimize context window usage - **Get dashboard property:** Extract specific parts of a dashboard using JSONPath expressions (e.g., `$.title`, `$.panels[*].title`) to fetch only needed data and reduce context window consumption - **Update or create a dashboard:** Modify existing dashboards or create new ones. _Warning: Requires full dashboard JSON which can consume large amounts of context window space._ - **Patch dashboard:** Apply specific changes to a dashboard without requiring the full JSON, significantly reducing context window usage for targeted modifications - **Get panel queries and datasource info:** Get the title, query string, and datasource information (including UID and type, if available) from every panel in a dashboard #### Context Window Management The dashboard tools now include several strategies to manage context window usage effectively ([issue #101](https://github.com/grafana/mcp-grafana/issues/101)): - **Use `get_dashboard_summary`** for dashboard overview and planning modifications - **Use `get_dashboard_property`** with JSONPath when you only need specific dashboard parts - **Avoid `get_dashboard_by_uid`** unless you specifically need the complete dashboard JSON ### Datasources - **List and fetch datasource information:** View all configured datasources and retrieve detailed information about each. - _Supported datasource types: Prometheus, Loki._ ### Prometheus Querying - **Query Prometheus:** Execute PromQL queries (supports both instant and range metric queries) against Prometheus datasources. - **Query Prometheus metadata:** Retrieve metric metadata, metric names, label names, and label values from Prometheus datasources. ### Loki Querying - **Query Loki logs and metrics:** Run both log queries and metric queries using LogQL against Loki datasources. - **Query Loki metadata:** Retrieve label names, label values, and stream statistics from Loki datasources. ### Incidents - **Search, create, and update incidents:** Manage incidents in Grafana Incident, including searching, creating, and adding activities to incidents. ### Sift Investigations - **List Sift investigations:** Retrieve a list of Sift investigations, with support for a limit parameter. - **Get Sift investigation:** Retrieve details of a specific Sift investigation by its UUID. - **Get Sift analyses:** Retrieve a specific analysis from a Sift investigation. - **Find error patterns in logs:** Detect elevated error patterns in Loki logs using Sift. - **Find slow requests:** Detect slow requests using Sift (Tempo). ### Alerting - **List and fetch alert rule information:** View alert rules and their statuses (firing/normal/error/etc.) in Grafana. Supports both Grafana-managed rules and datasource-managed rules from Prometheus or Loki datasources. - **List contact points:** View configured notification contact points in Grafana. Supports both Grafana-managed contact points and receivers from external Alertmanager datasources (Prometheus Alertmanager, Mimir, Cortex). ### Grafana OnCall - **List and manage schedules:** View and manage on-call schedules in Grafana OnCall. - **Get shift details:** Retrieve detailed information about specific on-call shifts. - **Get current on-call users:**