Grafana MCP SSE Server

Grafana MCP SSE Server

3.1

If you are the rightful owner of Grafana MCP SSE Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The aimiox MCP Grafana SSE Server allows querying Grafana dashboards using the Model Context Protocol (MCP) for natural language querying and real-time data extraction.

๐Ÿ“Š aimiox Grafana MCP

The aimiox MCP Grafana SSE Server provides an easy way to query Grafana dashboards and panels using the Model Context Protocol (MCP) โ€” enabling natural language querying, monitoring dashboards, and real-time data extraction.

Itโ€™s a lightweight container that connects your MCP-compatible clients (like amx-chat) to Grafanaโ€™s API.


๐Ÿš€ Quick Start (via Docker)

sudo docker run -p 8010:8010 \
  -e GRAFANA_API_KEY="YOUR_KEY" \
  -e GRAFANA_URL="https://grafana.example.com" \
  aimiox/amx-mcp-grafana:latest

๐Ÿง  You can use a Grafana service account API key with read-only access.

๐Ÿ”‘ Learn how to create a Grafana API key using a service account

โš™๏ธ Environment Variables

VariableDescription
GRAFANA_URLThe full URL to your Grafana instance (e.g., https://grafana.example.com)
GRAFANA_API_KEYA valid API key (created via a service account)

๐Ÿง  What You Can Do

With this MCP plugin, you can:

  • ๐Ÿ”Ž Search dashboards by name
  • ๐Ÿ“‹ List panels inside any dashboard
  • ๐Ÿ“Š Query panel data using natural language
  • โœ… Supports Prometheus panel queries on free tier

๐Ÿ’Ž Premium Features

The free version supports querying Prometheus panels only.

The paid version adds support for:

  • PostgreSQL
  • Loki
  • MySQL
  • InfluxDB
  • Elasticsearch
  • ...and more!

๐Ÿ› ๏ธ For paid access or custom integration,

๐Ÿงฉ Example Integration

To connect your MCP-compatible client to the Grafana MCP server, use the following configuration:

  url: "http://mcp-docker-server-ip:8010/sse?amx_mcp_key=aimiox-public-mcp-key"

๐Ÿ’ก Replace mcp-docker-server-ip with the actual IP or hostname of your MCP server container.

This configuration allows real-time interaction with your Grafana instance via MCP SSE.

๐Ÿ’ฌ Sample Prompts

Here are some example natural language queries you can use with MCP clients:

  • ๐Ÿ” "List all dashboards containing CPU in their name."
  • ๐Ÿ“Š "Query CPU usage panel from the Mobile Core dashboard."

๐Ÿค– Example Response (via GPT-4.1-mini)

User Prompt:

Query CPU usage panel from the Mobile Core dashboard

AI Response:

The CPU usage panel ("CPU 5-min Load") from the Mobile Core dashboard shows the 5-minute load values of the CPU over the last 6 hours, sampled every 5 minutes.

Here are some key data points from the timeframe:

  • The load values fluctuate with instances of 10, 11, 24, 23, and up to 34 at some points.
  • The latest data point at "2025-04-17 15:50:00" shows a load value of 23.

If you want specific value details or further analysis, please let me know!

๐Ÿ“ฃ Support

For questions, issues, or contributions, open an issue on github.com/aimiox, or