SigNoz MCP Server

SigNoz MCP server: access metrics, traces, logs, alerts, and dashboards via AI assistants

Remote serverstreamable-httpGo

What is the SigNoz MCP server?

SigNoz MCP server: access metrics, traces, logs, alerts, and dashboards via AI assistants. That is what the signoz mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

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.

Getting it running

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • 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
  • signoz_create_alert — Create a v2 direct/policy-routed alert or a direct-routed v1 anomaly alert

What it needs from you

Configuration is passed through the environment: SIGNOZ_URL, SIGNOZ_API_KEY, LOG_LEVEL, MCP_SERVER_HOST, OAUTH_TOKEN_SECRET, OAUTH_ISSUER_URL. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

  • A running SigNoz instance - SigNoz v0.135.0 or newer for the dashboard tools (create/get/update/patch/list/delete/import), which use the v2/Perses dashboards API - SigNoz v0.135.0 or newer for signoz_check_metric_usage (it reads v2/Perses dashboards for dashboard usage; on older versions the dashboard half is silently empty, though alert usage alone works from v0.131.0) -

Things to watch

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch SigNoz.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

This sits in the monitoring and observability group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. SigNoz's toolset — signoz_list_metrics, signoz_query_metrics, signoz_get_top_metrics and 11 more — is a fair guide to whether it matches your workflow. It is maintained by SigNoz; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
signoz_list_metricsDiscover active metric names and catalog metadata
signoz_query_metricsQuery known metrics for values, trends, breakdowns, or formulas
signoz_get_top_metricsReturn top 100 metrics ranked by ingested sample volume with pre-computed percentages for cost and volume analysis
signoz_check_metric_usageGiven a list of metric names (up to 50 per call), return which dashboards and alerts reference each one
signoz_check_metric_cardinalityReturn label/attribute keys for a single metric with cardinality counts and sample values, sorted highest-cardinality first
signoz_get_field_keysDiscover available field keys for metrics, traces, or logs
signoz_get_field_valuesGet possible values for a field key
signoz_list_alertsList firing/silenced/inhibited Alertmanager alert *instances* (not rule definitions)
signoz_list_alert_rulesList configured alert-rule summaries, including inactive/OK and disabled rules
signoz_get_alertGet one alert rule's full definition by id
signoz_get_alert_historyGet one rule's firing or state-transition history
signoz_create_alertCreate a v2 direct/policy-routed alert or a direct-routed v1 anomaly alert
signoz_update_alertFully replace an existing alert rule by id
signoz_delete_alertPermanently delete a confirmed alert rule by UUIDv7 id

How to install the SigNoz MCP server

```json
{
    "mcpServers": {
        "signoz": {
            "url": "http://localhost:8000/mcp"
        }
    }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • A running SigNoz instance - SigNoz v0.135.0 or newer for the dashboard tools (create/get/update/patch/list/delete/import), which use the v2/Perses dashboards API - SigNoz v0.135.0 or newer for signoz_check_metric_usage (it reads v2/Perses dashboards for dashboard usage; on older versions the dashboard half is silently empty, though alert usage alone works from v0.131.0) -
VariableDescriptionRequired
SIGNOZ_URLEndpoint or connection string the server talks to.Yes
SIGNOZ_API_KEYCredential the server authenticates with.Yes
LOG_LEVELConfiguration value read at startup.Optional
MCP_SERVER_HOSTEndpoint or connection string the server talks to.Optional
OAUTH_TOKEN_SECRETCredential the server authenticates with.Yes
OAUTH_ISSUER_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use SigNoz to signoz list metrics.
  • Use SigNoz to signoz query metrics.
  • Use SigNoz to signoz get top metrics.

Frequently asked questions

It connects SigNoz to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (signoz_list_metrics, signoz_query_metrics, signoz_get_top_metrics, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with SigNoz directly.