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 Grafana MCP server Configure Transports and addresses

Transports and addresses

The Grafana MCP server supports three transports: stdio (default for local use), SSE, and streamable-http. Choose the one that matches how your MCP client connects.

What you’ll achieve

You run the server with the right transport and, for SSE or streamable-http, the correct address and path so your client can connect.

Before you begin

• The server installed (for example, Install with uvx or Install with Docker).

Use stdio transport

With stdio (the default when you run the binary or uvx), the server talks to the client over standard input and output. Use this when the client launches the server as a subprocess (for example, Claude Desktop, Cursor). No --address or port is needed.

Bash Copy

mcp-grafana
# or
uvx mcp-grafana

Use SSE or streamable-http transport

With -t sse or -t streamable-http, the server listens on an address (default localhost:8000). Use --address to change host and port, and optionally --base-path or --endpoint-path for path configuration.

Bash Copy

mcp-grafana -t sse
mcp-grafana -t streamable-http --address :9090

Clients connect to the server URL (for example, http://localhost:8000/sse for SSE). For streamable-http, the default endpoint path is /mcp (override with --endpoint-path if your client expects a different path).

Next steps

• Server TLS (streamable-http) if you need HTTPS for the MCP server.
• Client TLS if Grafana is behind mTLS or custom certificates.