OfficialDeveloper Tools

Grafana

by Grafana Labs

Search dashboards, query Prometheus and Loki, and work with incidents in a Grafana instance from an assistant.

Best for

Engineers who investigate with Grafana: finding the right dashboard, running PromQL or LogQL, and checking incidents from the same assistant session.

Connect Grafana

Recommended setup

Local

The README's quick start uses uvx and a service account token, and lists Docker, binary and Helm options too.

Important

The registry also lists a hosted endpoint, mcp.grafana.com/mcp. Grafana documents that as a separate product, the Grafana Cloud MCP server: Grafana Cloud only, OAuth sign-in, and its use counts toward Grafana Assistant usage. This page covers the server you run yourself.

Connection details

Hosted endpoint
https://mcp.grafana.com/mcp
Package

Docker image · stdio
docker.io/grafana/mcp-grafana:2.1.1

Overview

Grafana's MCP server connects an assistant to a Grafana instance and the data behind it. It can search dashboards, run PromQL queries against Prometheus and LogQL queries against Loki, and search, create and update incidents in Grafana Incident. Other data sources, including SQL, CloudWatch and Elasticsearch, have tools that are switched off by default and enabled with the --enabled-tools flag. It starts with uvx or a Docker image and signs in with a service account token and the instance URL. Grafana 9.0 or later is required for full functionality, and anonymous usage statistics are on unless you disable them.

What it can do

  • Searches dashboards by title, folder, tag or starred status and retrieves a dashboard by its UID.
  • Runs PromQL queries against Prometheus data sources and LogQL log and metric queries against Loki data sources.
  • Searches, creates and updates incidents in Grafana Incident.
  • Tools for SQL, CloudWatch, Elasticsearch and several other data sources are off by default and enabled one by one with --enabled-tools.

What you need

Sign-in and credentials

A Grafana service account token (GRAFANA_SERVICE_ACCOUNT_TOKEN) and the instance address (GRAFANA_URL), which can be a Grafana Cloud URL.

Environment variables

Set these before the server starts.

  • GRAFANA_URL
  • GRAFANA_SERVICE_ACCOUNT_TOKENsecret
  • GRAFANA_USERNAME
  • GRAFANA_PASSWORDsecret
  • GRAFANA_ORG_ID
  • GRAFANA_EXTRA_HEADERS
  • GRAFANA_FORWARD_HEADERS
Request headers

The hosted endpoint asks for these headers.

  • X-Grafana-URL
Runs as

Docker image

Sources

MCP Registry
Listed in the MCP Registry as io.github.grafana/mcp-grafana
Last checked
Oct 31, 2026
Record reviewed
Oct 31, 2026

Statements on this page come from

Why is this labelled Official?

Registry name io.github.grafana/mcp-grafana. The registry only lets an organization's owners publish under its io.github.<org> namespace (registry authentication docs, read 2026-10-30). The repository is in the grafana organization, and its README says the server can report anonymous usage statistics to Grafana Labs and links Grafana's own documentation (read 2026-10-31).

Listing on HistChat is not an endorsement or a security review. MCP servers can access data or perform actions, so review the source and permissions before connecting.

  • Sentry

    SentryOfficial

    Search errors and traces, triage issues and debug failures in Sentry from a coding assistant.

    Category
    Developer Tools
    Connection
    Remote · Local
  • Chrome DevTools

    GoogleOfficial

    Let a coding agent drive a live Chrome browser to debug pages, inspect network traffic and record performance traces.

    Category
    Developer Tools
    Connection
    Local
    GitHub stars
    55k
  • GitHub

    GitHubOfficial

    Let an assistant browse repositories, triage issues, handle pull requests and check Actions runs on GitHub.

    Category
    Developer Tools
    Connection
    Remote · Local
    GitHub stars
    34k
  • GitLab

    GitLabOfficial

    Connect an assistant to GitLab projects, issues and merge requests through the MCP endpoint built into GitLab itself.

    Category
    Developer Tools
    Connection
    Remote
  • Filesystem

    Model Context ProtocolReference

    Let an assistant read, search and edit files in the folders you choose on your own machine.

    Category
    Developer Tools
    Connection
    Local
  • Azure MCP Server

    MicrosoftOfficial

    Work across many Azure services from an assistant through one local server that uses your existing Azure sign-in.

    Category
    Cloud & Infrastructure
    Connection
    Local