SigNoz
MCP Server for SigNoz
What is SigNoz?
SigNoz is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for signoz
MCP Server for SigNoz
This server falls under the Monitoring & Observability category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP Server for SigNoz
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx signozConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use SigNoz
The SigNoz MCP Server connects AI assistants directly to your SigNoz observability instance, exposing over 40 tools that cover metrics queries, distributed trace search, log aggregation, alert management, dashboard creation, and notification channel configuration. SigNoz is an open-source OpenTelemetry-native observability platform, and this server lets you query your production telemetry, investigate incidents, and manage alerting rules through natural language rather than the SigNoz UI. It supports both stdio mode for Claude Desktop and HTTP mode with OAuth 2.1 for team deployments and SigNoz Cloud.
Prerequisites
- A running SigNoz instance (self-hosted or SigNoz Cloud at https://signoz.io)
- A SigNoz API key generated from Settings > API Keys in the SigNoz UI
- The signoz-mcp-server binary (downloaded from GitHub Releases or installed via Go)
- An MCP-compatible client such as Claude Desktop or Cursor
Download the signoz-mcp-server binary
Download the pre-built binary for your platform from the GitHub Releases page, or install it via Go. The binary is a single self-contained executable with no additional runtime dependencies.
# macOS Apple Silicon
curl -L https://github.com/SigNoz/signoz-mcp-server/releases/latest/download/signoz-mcp-server_darwin_arm64.tar.gz | tar xz
# macOS Intel
curl -L https://github.com/SigNoz/signoz-mcp-server/releases/latest/download/signoz-mcp-server_darwin_amd64.tar.gz | tar xz
# Linux amd64
curl -L https://github.com/SigNoz/signoz-mcp-server/releases/latest/download/signoz-mcp-server_linux_amd64.tar.gz | tar xz
# Or via Go
go install github.com/SigNoz/signoz-mcp-server/cmd/server@latestObtain your SigNoz API key
Log in to your SigNoz instance and navigate to Settings > API Keys. Generate a new key and copy it — this is what authenticates the MCP server to your SigNoz instance.
Move the binary to a permanent location
Move the extracted binary to a directory on your PATH or to a known absolute path, as you will reference this path in your Claude Desktop configuration.
mv signoz-mcp-server /usr/local/bin/signoz-mcp-server
chmod +x /usr/local/bin/signoz-mcp-serverConfigure Claude Desktop
Edit claude_desktop_config.json to add the SigNoz server in stdio mode. Replace the URL and API key with your actual values. For SigNoz Cloud you can also use the hosted HTTP endpoint.
{
"mcpServers": {
"signoz": {
"command": "/usr/local/bin/signoz-mcp-server",
"env": {
"SIGNOZ_URL": "https://your-signoz-instance.com",
"SIGNOZ_API_KEY": "your-signoz-api-key"
}
}
}
}Restart Claude Desktop and verify
Quit and relaunch Claude Desktop. Ask Claude to list available SigNoz tools or run a simple query like 'Show me all available metrics' to confirm the connection is working.
SigNoz Examples
Client configuration
Claude Desktop configuration for SigNoz MCP server in stdio mode with the required environment variables.
{
"mcpServers": {
"signoz": {
"command": "/usr/local/bin/signoz-mcp-server",
"env": {
"SIGNOZ_URL": "https://your-signoz-instance.com",
"SIGNOZ_API_KEY": "your-signoz-api-key",
"LOG_LEVEL": "info"
}
}
}
}Prompts to try
These prompts exercise the metrics, traces, logs, alerts, and dashboard capabilities of the SigNoz MCP server.
- "Show me all available metrics in my SigNoz instance"
- "What is the p99 latency for http_request_duration_seconds over the last hour?"
- "Show me error logs for the payment service from the last 30 minutes"
- "Search traces for the checkout service that took longer than 2 seconds"
- "List all active alert rules"
- "Create a dashboard with CPU utilization and memory usage widgets"Troubleshooting SigNoz
Authentication error: 401 Unauthorized
Verify that SIGNOZ_API_KEY matches a valid key in your SigNoz instance (Settings > API Keys). Keys are scoped — ensure the key has read permissions for metrics, traces, and logs. For SigNoz Cloud, the key must match the correct region endpoint.
Cannot connect to SIGNOZ_URL
Confirm that SIGNOZ_URL is reachable from the machine running the binary. For self-hosted SigNoz, use the full URL including protocol (e.g., http://localhost:3301 or https://signoz.mycompany.com). Do not include a trailing slash.
Binary not found or permission denied
Run 'chmod +x /usr/local/bin/signoz-mcp-server' to ensure the binary is executable. If using a path with spaces, wrap it in quotes in the args array. On macOS, you may need to allow the binary in System Settings > Privacy & Security > Security if it is blocked as an unidentified developer app.
Frequently Asked Questions about SigNoz
What is SigNoz?
SigNoz is a Model Context Protocol (MCP) server that mcp server for signoz It connects AI assistants to external tools and data sources through a standardized interface.
How do I install SigNoz?
Follow the installation instructions on the SigNoz GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with SigNoz?
SigNoz works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is SigNoz free to use?
Yes, SigNoz is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
SigNoz Alternatives — Similar Monitoring & Observability Servers
Looking for alternatives to SigNoz? Here are other popular monitoring & observability servers you can use with Claude, Cursor, and VS Code.
Netdata
★ 78.9kReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Kubeshark
★ 11.9keBPF-powered network observability for Kubernetes. Indexes L4/L7 traffic with full K8s context, decrypts TLS without keys. Queryable by AI agents via MCP and humans via dashboard.
Mission Control
★ 4.9kSelf-hosted AI agent orchestration platform: dispatch tasks, run multi-agent workflows, monitor spend, and govern operations from one mission control dashboard.
Grafana
★ 3.0kThis MCP server enables natural-language querying of Grafana logs by automatically detecting log sources and service labels. It provides read-only access to log data with intelligent caching for efficient repeat queries.
Sentrux
★ 2.4kReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.
OpenInference
★ 986OpenTelemetry Instrumentation for AI Observability
Browse More Monitoring & Observability MCP Servers
Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up SigNoz in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use SigNoz?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.