Documentation Grafana documentation Developer resources Grafana 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.