This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.

Documentation Grafana documentation Developer resources OSS MCP server Configure

Configure the Grafana MCP server

Configure the open source Grafana MCP server: how it connects to Grafana, which tools are enabled, and how clients connect to the server.

• Authentication
  Authenticate the Grafana MCP server to Grafana using a service account token or username and password.
• Transports and addresses
  Choose how the Grafana MCP server communicates with clients: stdio, SSE, or streamable-http.
• Enable and disable tools
  Control which MCP tools the Grafana MCP server exposes and use read-only mode.
• Client TLS (Grafana connection)
  Use TLS certificates when the Grafana MCP server connects to Grafana (mTLS or custom CA).
• Proxied tools
  Additional MCP tools loaded through Grafana’s datasource proxy; today only Grafana Tempo.
• Server TLS (streamable-http)
  Serve the Grafana MCP server over HTTPS when using streamable-http transport.
• Multi-organization and headers
  Target a specific Grafana organization and send custom HTTP headers from the MCP server.
• Command-line flags
  CLI flags for the mcp-grafana binary, including transports, tools, TLS, and read-only mode.
• Health check endpoint
  HTTP health check for SSE and streamable-http transports.