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

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.

What it needs from you

  • 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) -

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

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

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

SigNoz MCP server: access metrics, traces, logs, alerts, and dashboards via AI assistants Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.