# SigNoz MCP Server

Gives your AI assistant access to SigNoz observability data: metrics, traces, logs, alerts and dashboards. Handy when you're chasing an incident without leaving the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 128
- Author: SigNoz
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SigNoz/signoz-mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/signoz-mcp-server

## What it does

The server wires an assistant into SigNoz so you can query observability data in plain language. Metrics, traces, logs, alerts, dashboards and services all come back into the conversation instead of the web UI.

Two ways in. SigNoz Cloud exposes a hosted endpoint at `https://mcp.<region>.signoz.cloud/mcp` — nothing to install, just add the URL to your client config and finish the auth flow with your instance URL and API key. You create the key under `Settings → API Keys`, and only Admin users can do that. The other route is self-hosted: a release binary, `go install`, or the `signoz/signoz-mcp-server` Docker image. Self-hosted needs a running SigNoz instance.

The region in that URL has to match your SigNoz Cloud account, otherwise authentication fails outright. Find yours under `Settings → Ingestion`.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add signoz-mcp-server -- docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.16.0
```

### Codex

**Platform CLI**
```bash
codex mcp add signoz-mcp-server -- docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.16.0
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "signoz-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/signoz/signoz-mcp-server:v0.16.0"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "signoz-mcp-server": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/signoz/signoz-mcp-server:v0.16.0"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add signoz-mcp-server docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.16.0
```

## When to use it
- check a service's metrics without opening a browser
- track down a slow trace from a fresh incident
- pull logs for a time window into the chat
- see which alerts are firing right now
- inspect a dashboard and explain its panels

## Example prompts
- Show me metrics for the `checkout` service over the last hour
- Find the slowest traces from today
- Which alerts are currently firing?

## Similar
- [groundcover-cli](https://affpapa.org/en/nevibecode/skills/groundcover-cli.md) — skill · 8900 installs
- [sentry-instrumentation-guide](https://affpapa.org/en/nevibecode/skills/sentry-instrumentation-guide.md) — skill · 1200 installs
- [observability-and-instrumentation](https://affpapa.org/en/nevibecode/skills/observability-and-instrumentation.md) — skill · 54800 installs
- [python-observability](https://affpapa.org/en/nevibecode/skills/python-observability.md) — skill · 11547 installs
- [opentelemetry](https://affpapa.org/en/nevibecode/skills/opentelemetry.md) — skill · 6100 installs
- [otel-instrumentation](https://affpapa.org/en/nevibecode/skills/dash0-otel-instrumentation.md) — skill · 972 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md