Official server by SigNoz
SigNoz MCP server
Query metrics, logs and traces, and manage alerts, dashboards, saved views and notification channels in SigNoz.
Install
Pick your agent and copy one line. Remote servers ask you to sign in on first use.
claude mcp add signoz -- docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.18.0
# ~/.codex/config.toml [mcp_servers.signoz] command = "docker" args = ["run", "-i", "--rm", "docker.io/signoz/signoz-mcp-server:v0.18.0"]
gemini mcp add signoz docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.18.0
{
"mcpServers": {
"signoz": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/signoz/signoz-mcp-server:v0.18.0"
]
}
}
}code --add-mcp '{"name":"signoz","command":"docker","args":["run","-i","--rm","docker.io/signoz/signoz-mcp-server:v0.18.0"]}'What it can do
From SigNoz's own MCP documentation.
Sign in
SigNoz Cloud uses OAuth 2.1 (Dynamic Client Registration with PKCE), where you enter your instance URL and a service account API key. Clients without OAuth can send SIGNOZ-API-KEY and X-SigNoz-URL headers. Self-hosted stdio takes SIGNOZ_URL and SIGNOZ_API_KEY.
Tools (43 documented tools)
Options
- Self-host with a release binary, go install or the signoz/signoz-mcp-server Docker image. Stdio is recommended, HTTP is also supported.
- Also exposes read-only MCP resources under signoz:// URIs.
- Self-hosted settings include TRANSPORT_MODE, MCP_SERVER_PORT (default 8000), LOG_LEVEL and optional OAuth.
Good to know
- Using the wrong Cloud region causes authentication failures.
- Only Admin users can create API keys.
- Several tools need recent SigNoz versions (dashboard tools v0.135.0+, alert rule tools v0.120.0+). Older deployments may return HTTP 404.
- Docker always runs in HTTP mode.
- signoz_check_metric_usage takes up to 50 metric names per call, and signoz_get_top_metrics returns the top 100.
Details
- Registry name
- io.github.SigNoz/signoz-mcp-server
- Latest version
- 0.18.0 (updated 2026-11-05)
- Packages
docker.io/signoz/signoz-mcp-server:v0.18.0 (oci)
- Links
- SigNoz docsSource
More in Observability & incidents
Reviewed Oct 21, 2026. Official means published under SigNoz's namespace in the MCP registry. It is not a security audit.
Built an MCP server? Get it listed everywhere →
Shipping an Android app? Google Play needs 12 testers for 14 days first. Get them with Tester Exchange →