SigNoz MCP Server

A Model Context Protocol (MCP) server that provides seamless access to SigNoz observability data through AI assistants and LLMs. Query metrics, traces, logs, alerts, dashboards, and services using natural language. Its 40 documented tools cover signoz, dashboard, alert, metrics.

People who need DevOps & monitoring tools inside Claude, Cursor, VS Code, or another MCP client. The project is written in Go.

VERIFIED ACTIVE

LAST COMMIT 2026-08-21 · ★ 115 · #66 OF 101 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-08-25

Apache-2.0 · Go servers · how we verify → /methodology

01 · Install SigNoz MCP Server

before you install - you'll need

Set SIGNOZ_URL, SIGNOZ_API_KEY, LOG_LEVEL, TRANSPORT_MODE, MCP_SERVER_PORT, OAUTH_ENABLED, OAUTH_TOKEN_SECRET, OAUTH_ISSUER_URL before connecting.

Docker

docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.13.0

Claude Desktop - add to config

{
  "mcpServers": {
    "signoz-signoz-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/signoz/signoz-mcp-server:v0.13.0"
      ]
    }
  }
}
Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as container (OCI image) - can be sandboxed away from your filesystem

license Apache-2.0 - declared in the repository

registry namespace io.github.SigNoz is GitHub-verified and matches the repo owner

03 · What SigNoz MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can discover active metric names and catalog metadata, query known metrics for values, trends, breakdowns, or formulas, read top 100 metrics ranked by ingested sample volume with pre-computed percentages for cost and volume analysis, and read label/attribute keys for a single metric with cardinality counts and sample values, sorted highest-cardinality first.

The 40 tools it gives your agent

Extracted from the project's README - what SigNoz MCP Server lets an agent do.

signoz_get_org_overview
- Get the current status and overall posture of the SigNoz deployment, with typed projections plus sourceStats containing every reported stats field
signoz_list_metrics
- Discover active metric names and catalog metadata
signoz_query_metrics
- Query known metrics for values, trends, breakdowns, or formulas
signoz_get_top_metrics
- Return top 100 metrics ranked by ingested sample volume with pre-computed percentages for cost and volume analysis
signoz_check_metric_usage
- Given a list of metric names (up to 50 per call), return which dashboards and alerts reference each one
signoz_check_metric_cardinality
- Return label/attribute keys for a single metric with cardinality counts and sample values, sorted highest-cardinality first
signoz_get_field_keys
- Discover available field keys for metrics, traces, or logs
signoz_get_field_values
- Get possible values for a field key
signoz_list_alerts
- List firing/silenced/inhibited Alertmanager alert instances (not rule definitions)
signoz_list_alert_rules
- List configured alert-rule summaries, including inactive/OK and disabled rules
signoz_get_alert
- Get one alert rule's full definition by id
signoz_get_alert_history
- Get one rule's firing or state-transition history
show all 40 tools
signoz_create_alert
- Create a v2 direct/policy-routed alert or a direct-routed v1 anomaly alert
signoz_update_alert
- Fully replace an existing alert rule by id
signoz_delete_alert
- Permanently delete a confirmed alert rule by UUIDv7 id
signoz_list_dashboards
- List tenant-dashboard summaries and discover UUIDs
signoz_get_dashboard
- Get one dashboard's full layout, variables, panels, and queries
signoz_create_dashboard
- Create a custom multi-panel dashboard
signoz_update_dashboard
- Fully replace a fetched dashboard while preserving unrequested fields
signoz_patch_dashboard
- Apply a partial RFC 6902 JSON Patch without resending the whole dashboard
signoz_delete_dashboard
- Permanently delete a confirmed dashboard by id
signoz_import_dashboard
- Create a dashboard from a known curated template path
signoz_list_dashboard_templates
- List curated templates and discover an import path
signoz_list_services
- List APM services with trace activity in a time range
signoz_get_service_top_operations
- Get ranked operations for one traced service
signoz_list_views
- List saved Explorer views for traces/logs/metrics/Cost Meter and discover UUIDs
signoz_get_view
- Get one saved Explorer view's complete definition by id
signoz_search_docs
- Find ranked official-doc matches when no exact page is selected
signoz_fetch_doc
- Fetch one known official-doc page or heading as Markdown
signoz_create_view
- Save one reusable Explorer query
signoz_update_view
- Fully replace a fetched saved view while preserving unrequested fields
signoz_delete_view
- Permanently delete a confirmed saved view by id
signoz_aggregate_logs
- Aggregate log statistics and grouped or top-N breakdowns
signoz_search_logs
- Return individual log records matching filters
signoz_aggregate_traces
- Aggregate span statistics and grouped or top-N breakdowns
signoz_search_traces
- Return individual span rows or discover trace IDs
signoz_get_trace_details
- Get one known trace with all spans and hierarchy
signoz_execute_builder_query
- Query Builder v5 requests the dedicated tools cannot express
signoz_list_notification_channels
- List channel summaries for name verification and ID discovery
signoz_get_notification_channel
- Get all provider-specific settings for one channel by ID

Latest releases

v0.13.0 · 2026-08-19

migrate to the official Go SDK and support 2026-07-28 MCP spec · add selected official conformance · preserve recognized backend error guidance · upgrade to go 1.26 · add Grok Build MCP configuration · pre-release…

v0.12.0 · 2026-08-12

validate credentials via service_accounts/me only · pre-release v0.12.0 · New Contributors · @claude[bot] made their first contribution in

v0.11.0 · 2026-08-05

support policy routing and preflight reuse · add organization overview and auth recovery · capture failed MCP requests · pre-release v0.11.0

04 · Who maintains SigNoz MCP Server

SigNoz MCP Server is maintained by signoz. It's the only MCP server we track from this author; the repo dates to Aug 2025.

05 · Facts

category
DevOps & monitoring - ranked #66 of 101 actively-maintained DevOps & monitoring servers as of 2026-08-25.
release cadence
10+ releases in the last 90 days (latest 2026-08-19)
registry
io.github.SigNoz/signoz-mcp-server (active, first published 2025-10-28 · 9 versions)
packages
oci:docker.io/signoz/signoz-mcp-server:v0.13.0

06 · SigNoz MCP Server FAQ

Is SigNoz MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-21 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can SigNoz MCP Server do?

With this server connected, an agent can discover active metric names and catalog metadata, query known metrics for values, trends, breakdowns, or formulas, read top 100 metrics ranked by ingested sample volume with pre-computed percentages for cost and volume analysis, and read label/attribute keys for a single metric with cardinality counts and sample values, sorted highest-cardinality first.

How do I install SigNoz MCP Server?

Run `docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.13.0`. The README documents 8 environment variables (SIGNOZ_URL, SIGNOZ_API_KEY, LOG_LEVEL…) to set first. Set SIGNOZ_URL, SIGNOZ_API_KEY, LOG_LEVEL, TRANSPORT_MODE, MCP_SERVER_PORT, OAUTH_ENABLED, OAUTH_TOKEN_SECRET, OAUTH_ISSUER_URL before connecting. You can also paste the ready-made client config above.

07 · Alternatives to SigNoz MCP Server

More DevOps & monitoring MCP servers · HomeLab Monitor · Fleet MCP · Mcpproxy · Agentburn

More Go MCP servers · Ckb · Snyk MCP Server · Backscroll · see all