# SigNoz MCP Server (MCP server)

> SigNoz MCP Server is an 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. It has 125 GitHub stars, is released under the Apache-2.0 license and runs locally with docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.15.0.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/SigNoz/signoz-mcp-server |
| GitHub stars | 125 |
| License | Apache-2.0 |
| Language | Go |
| Transport | stdio |
| Packages | docker: docker.io/signoz/signoz-mcp-server:v0.15.0 |
| Remote URL | none |
| Needs API key | no |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Cloud & DevOps |
| Latest release | v0.15.0 (Sep 25, 2026) |
| Last commit | Oct 5, 2026 |
| MCP registry name | io.github.SigNoz/signoz-mcp-server |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "signoz-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/signoz/signoz-mcp-server:v0.15.0"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio signoz-mcp-server -- docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.15.0
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "signoz-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/signoz/signoz-mcp-server:v0.15.0"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "signoz-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/signoz/signoz-mcp-server:v0.15.0"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `signoz_get_org_overview`: Get the current status and overall posture of the SigNoz deployment, with typed projections plus sourceStats…
- `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…
- `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
- `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/AI Observability 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 spec
- `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 IDs, names, and display names without provider settings
- `signoz_get_notification_channel`: Get all provider-specific settings for one channel by ID

## Similar MCP servers

- [Worldmonitor](https://appsgit.com/mcp-servers/worldmonitor): Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface. (87,920 stars, AGPL-3.0)
- [Netdata](https://appsgit.com/mcp-servers/netdata): Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection. (80,817 stars, GPL-3.0, needs API key)
- [openstatus](https://appsgit.com/mcp-servers/openstatus): Manage monitors, status pages, incidents and maintenances in your openstatus workspace. (9,171 stars, AGPL-3.0, official)
- [MCP Server Cloudflare](https://appsgit.com/mcp-servers/mcp-server-cloudflare): Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. (4,360 stars, Apache-2.0, official, needs API key)
- [Dagu](https://appsgit.com/mcp-servers/dagu): Self-hostable workflow orchestrator for teams whose main work isn't orchestration. (4,289 stars, GPL-3.0)
- [Azure MCP Server](https://appsgit.com/mcp-servers/azure-mcp-server): All Azure MCP tools to create a seamless connection between AI agents and Azure services. (3,738 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/signoz-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
