signoz-mcp-server

Overview

The SigNoz MCP server allows AI assistants to query observability data including metrics, traces, logs, alerts, dashboards, and services using natural language. It supports both SigNoz Cloud and self-hosted deployments with multiple transport modes (stdio and HTTP) and authentication options. The server provides comprehensive tooling for monitoring and observability tasks, including querying metrics, managing alerts, working with dashboards, and searching through traces and logs.

Try asking AI

After installing, here are 4 things you can ask your AI assistant:

• signoz_list_metrics

  Search and list available metrics

  Try:Show me all available metricsTry:List metrics containing 'http'
• signoz_query_metrics

  Query metrics with smart aggregation defaults

  Try:What's the p99 latency for http_request_duration_seconds?Try:Get average CPU usage by service
• signoz_list_alerts

  List firing/silenced/inhibited Alertmanager alert instances

  Try:List all active alertsTry:Show me silenced alerts
• signoz_list_alert_rules

  List configured alert rules, including inactive and disabled rules

  Try:Show all alert rulesTry:List disabled alert rules
• signoz_get_alert

  Get an alert rule definition by ID

  Try:Get details for alert rule abc123Try:Retrieve alert rule with ID rule-456
• signoz_create_alert

  Create a new alert rule

  Try:Create an alert for high memory usageTry:Create a Prometheus alert for CPU over 80%
• signoz_list_dashboards

  List all dashboards with summaries

  Try:Show me all dashboardsTry:List available dashboards
• signoz_get_dashboard

  Get full dashboard configuration

  Try:Get dashboard details for ID dash-123Try:Show me the CPU dashboard
• signoz_create_dashboard

  Create a new dashboard

  Try:Create a new dashboard with CPU and memory widgetsTry:Make a dashboard for service metrics
• signoz_search_logs

  Search logs with flexible filtering

  Try:Show me error logs for paymentserviceTry:Find logs with 'timeout' in the last hour
• signoz_search_traces

  Search traces with flexible filtering

  Try:Search traces for checkout serviceTry:Find traces with errors in the last hour
• signoz_get_trace_details

  Get full trace with all spans

  Try:Get details for trace ID abc123Try:Show me the full trace xyz789

Comparable tools

Installation

{
  "mcpServers": {
    "signoz": {
      "url": "https://mcp.<region>.signoz.cloud/mcp"
    }
  }
}

curl -L https://github.com/SigNoz/signoz-mcp-server/releases/latest/download/signoz-mcp-server_linux_amd64.tar.gz | tar xz

SIGNOZ_URL=https://your-signoz-instance.com \
SIGNOZ_API_KEY=your-api-key \
./signoz-mcp-server

{
  "mcpServers": {
    "signoz": {
      "command": "/absolute/path/to/signoz-mcp-server",
      "env": {
        "SIGNOZ_URL": "https://your-signoz-instance.com",
        "SIGNOZ_API_KEY": "your-api-key-here"
      }
    }
  }
}

FAQ

What versions of SigNoz are supported?

Alert rule tools require SigNoz v0.120.0 or newer. Older versions will return HTTP 404 for alert-related tools.

What authentication methods are supported?

The server supports both direct API key authentication and OAuth for multi-tenant/cloud deployments.

Compare signoz-mcp-server with