SigNoz Agent Skills

Official SigNoz skills and MCP configuration for Claude Code, Codex, Cursor, Gemini CLI, and the skills.sh ecosystem. The MCP setup skill also includes client-specific recipes for VS Code/GitHub Copilot, Claude Desktop, Gemini CLI, Windsurf, Zed, Antigravity, OpenCode, and generic HTTP MCP clients.

Skills

Skill	Description
signoz-mcp-setup	Initialize or repair the SigNoz MCP server configuration for Claude Code, Codex, Cursor, VS Code/GitHub Copilot, Claude Desktop, Gemini CLI, Windsurf, Zed, Antigravity, OpenCode, or another MCP client.
signoz-creating-alerts	Create SigNoz alert rules for threshold breaches, error rates, latency, anomaly detection, and absent-data conditions across metrics, logs, and traces.
signoz-explaining-alerts	Explain and interpret an existing SigNoz alert rule's configuration, evaluation behavior, notification routing, and recent fire frequency.
signoz-investigating-alerts	Diagnose why a SigNoz alert fired by correlating its signal with neighbor metrics, traces, and logs around the fire window, and ranking likely causes.
signoz-creating-dashboards	Create a new SigNoz dashboard from a natural-language intent — import a curated template (PostgreSQL, Redis, JVM, k8s, APM, LLM, etc.) when one fits, or build a custom dashboard with metric, trace, and log panels.
signoz-explaining-dashboards	Explain panels, queries, and layout of an existing SigNoz dashboard.
signoz-modifying-dashboards	Modify an existing SigNoz dashboard: add, remove, or edit panels, variables, queries, and layout.
signoz-generating-queries	Generate queries against SigNoz observability data (traces, logs, metrics).
signoz-writing-clickhouse-queries	Optimized ClickHouse queries for SigNoz OpenTelemetry traces and logs.
signoz-searching-docs	SigNoz docs guidance for instrumentation, setup, querying, alerts, and APIs.
signoz-managing-views	Create, list, inspect, update, or delete SigNoz saved Explorer views (logs, traces, metrics) via the SigNoz MCP server.
signoz-setting-up-observability	Orchestrate the full post-ingestion observability setup for a service — SLI/SLO capture, RED/USE exploration, focused dashboards, saved views, burn-rate and absent-data alerts, and a tuning loop — sequencing the single-artifact skills into one SLO-aware workflow.

Installation

The Claude Code, Codex, and Cursor plugins ship with MCP registration files so users do not have to hand-edit MCP configuration. Claude Code asks for the MCP endpoint URL during install. Codex and Cursor can use signoz-mcp-setup when an endpoint needs to be initialized or repaired; it accepts a SigNoz Cloud region such as us, us2, eu, eu2, in, or in2, any hosted MCP URL, or a self-hosted HTTP /mcp endpoint. Plugin updates can reset bundled MCP registration files to the placeholder; if that happens, rerun signoz-mcp-setup.

The skills are authored against the current SigNoz MCP server contract. If a tool call fails because a parameter or schema looks different from what a skill describes, update or reconfigure the SigNoz MCP server before changing the workflow.

See the full setup guide in the SigNoz MCP Server docs.

Claude Code

/plugin marketplace add SigNoz/agent-skills
/plugin install signoz@signoz-skills

On install, Claude Code prompts for your SigNoz MCP endpoint. For SigNoz Cloud, keep the default https://mcp.us.signoz.cloud/mcp or edit the region segment to your region (us, us2, eu, eu2, in, or in2). Find your region under Settings -> Ingestion in SigNoz, or see the region reference. For a self-hosted SigNoz, enter your own HTTP /mcp URL, for example http://localhost:8000/mcp.

Then run /mcp, select the signoz server, and complete the authentication flow if prompted. To change the endpoint later, reconfigure the plugin's options or run signoz-mcp-setup with the new region or MCP URL.

Update:

/plugin marketplace update
/plugin update signoz@signoz-skills

The plugin ships a PreToolUse hook that auto-allows WebFetch to signoz.io domains. This does not affect Bash-based network calls (curl, wget), which follow the normal permission flow.

Codex

codex plugin marketplace add SigNoz/agent-skills

Then, in a Codex session started from your project:

1. Run /plugins, open the SigNoz marketplace, and install signoz.

2. Run signoz-mcp-setup <region> with your SigNoz Cloud region (us, us2, eu, eu2, in, in2) or a self-hosted HTTP MCP URL. This rewrites the bundled .mcp.json placeholder used by the Codex plugin to a concrete endpoint.

3. Authenticate the MCP server over OAuth:

   codex mcp login signoz

   Complete the browser flow with your SigNoz instance URL and a service account API key.

4. Verify the connection:

   codex mcp list   # signoz -> enabled, Auth = logged in

   or run /mcp in a session, then call any signoz_* tool. Restart Codex if the signoz server does not appear.

The Codex plugin declares mcpServers: "./.mcp.json", so normal plugin installs do not need a separate native Codex MCP entry. To use in another repo, copy plugins/signoz into the target repo's plugins/ directory, add a marketplace entry in $REPO_ROOT/.agents/plugins/marketplace.json, and repeat the setup step for that workspace.

Cursor

Not yet on the public Cursor Marketplace. Install via a Team Marketplace:

1. Add https://github.com/SigNoz/agent-skills as a team marketplace in Settings -> Plugins.
2. Install the signoz plugin from the marketplace panel.

On install, Cursor prompts for your SigNoz Region. The picker offers the SigNoz Cloud regions (us, us2, eu, eu2, in, in2) plus a self-hosted option:

• SigNoz Cloud — select your region. The bundled MCP config fills it into https://mcp.<region>.signoz.cloud/mcp and Cursor starts the OAuth login. Find your region under Settings -> Ingestion in SigNoz, or see the region reference.
• Self-hosted — choose self-hosted. This skips the Cloud OAuth and leaves the MCP endpoint unconfigured. After install you must run /signoz-mcp-setup with your own HTTP /mcp URL (next step) to point Cursor at your instance.

3. Self-hosted only: run /signoz-mcp-setup in an agent chat with your self-hosted HTTP MCP URL (for example /signoz-mcp-setup http://localhost:8000/mcp). This updates the bundled .signoz_cursor_mcp.json placeholder used by the Cursor plugin. (SigNoz Cloud users can skip this — the region picker already configured the endpoint.)
4. Reload Cursor, then open MCP settings and complete authentication for the signoz server if prompted.

If you picked the wrong region or need to change a self-hosted HTTP MCP endpoint, run /signoz-mcp-setup again with the correct region or URL and reload Cursor.

Gemini CLI

gemini extensions install https://github.com/SigNoz/agent-skills

When prompted for the SigNoz MCP endpoint, enter:

• SigNoz Cloud: https://mcp.<region>.signoz.cloud/mcp — replace <region> with your region (us, us2, eu, eu2, in, or in2). The default is the us Cloud endpoint.
• Self-hosted SigNoz: your own /mcp URL, for example http://localhost:8000/mcp.

Then authenticate:

/mcp auth signoz

Follow the prompts to enter your SigNoz instance URL and API key.

Other MCP Clients

The setup skill includes native config recipes for VS Code/GitHub Copilot, Claude Desktop, Gemini CLI, Windsurf, Zed, Antigravity, OpenCode, and generic HTTP MCP clients. These clients do not all consume this plugin automatically; install or copy the skill where your client supports skills, or use the client-specific setup snippets in the skill as a reference.

For SigNoz Cloud, prefer the hosted MCP URL and client OAuth flow. For self-hosted SigNoz, the skill supports HTTP /mcp endpoints and stdio local-binary recipes. It avoids writing API keys into tracked project files.

skills.sh

npx skills add SigNoz/agent-skills                                   # all skills
npx skills add SigNoz/agent-skills --skill signoz-searching-docs                # specific skill
npx skills add SigNoz/agent-skills --skill signoz-writing-clickhouse-queries    # specific skill

Repository Structure

.
├── .agents/plugins/marketplace.json        # Codex marketplace
├── .claude-plugin/marketplace.json         # Claude Code marketplace
├── .cursor-plugin/marketplace.json         # Cursor marketplace
├── gemini-extension.json                   # Gemini CLI extension manifest
├── skills -> plugins/signoz/skills         # Gemini CLI skills (symlink)
├── plugins/signoz/
│   ├── .codex-plugin/plugin.json           # Codex plugin manifest
│   ├── .claude-plugin/plugin.json          # Claude Code plugin manifest
│   ├── .cursor-plugin/plugin.json          # Cursor plugin manifest
│   ├── .signoz_claude_mcp.json             # Claude Code MCP config
│   ├── .mcp.json                           # Codex MCP config
│   ├── .signoz_cursor_mcp.json             # Cursor MCP config
│   ├── hooks/                              # Auto-allow hooks
│   └── skills/
│       ├── signoz-mcp-setup/
│       │   └── references/                 # Endpoint mapping and client recipes
│       ├── signoz-creating-alerts/
│       ├── signoz-explaining-alerts/
│       ├── signoz-investigating-alerts/
│       ├── signoz-writing-clickhouse-queries/
│       ├── signoz-explaining-dashboards/
│       ├── signoz-modifying-dashboards/
│       ├── signoz-searching-docs/
│       ├── signoz-generating-queries/
│       └── signoz-managing-views/
└── README.md

ID	Value
Marketplace	signoz-skills
Plugin	signoz
Repository	SigNoz/agent-skills
Versioning	CalVer (YYYY.MM.DD) — auto-bumped

Contributing

See CONTRIBUTING.md.

License

MIT. See LICENSE.