{"slug": "signoz-mcp-server", "title": "SigNoz MCP Server", "summary": "SigNoz has released an MCP server that allows AI assistants to query observability data including metrics, traces, logs, alerts, and dashboards through natural language. The server implements the Model Context Protocol and is available as a hosted service on SigNoz Cloud, requiring only a URL and authentication to connect. The tool supports integration with multiple AI platforms including Cursor, VS Code, Claude Desktop, Gemini CLI, and Windsurf.", "body_md": "The SigNoz MCP Server implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) — an open standard that lets AI assistants interact with your SigNoz observability data. Query metrics, traces, logs, alerts, and dashboards through natural language.\n\nConnect to SigNoz's MCP server\n\nConnect your AI tool to SigNoz Cloud's hosted MCP server. No installation required — just add the URL and authenticate.\n\n```\nhttps://mcp.<region>.signoz.cloud/mcp\n```\n\nMake sure you select the correct region that matches your SigNoz Cloud account. Using the wrong region will result in authentication failures.\n\n`<region>`\n\n: Your SigNoz Cloud region. Find your region under**Settings → Ingestion** in SigNoz, or see the[region reference](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint).\n\nInstall in one click\n\nManual Configuration\n\nAdd this configuration to `.cursor/mcp.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"url\": \"https://mcp.<region>.signoz.cloud/mcp\"\n    }\n  }\n}\n```\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)\n\nNeed help? See the [Cursor MCP docs ↗](https://docs.cursor.com/context/model-context-protocol)\n\nInstall in one click\n\nManual Configuration\n\nAdd this configuration to `.vscode/mcp.json`\n\n:\n\n```\n{\n  \"servers\": {\n    \"signoz\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.<region>.signoz.cloud/mcp\"\n    }\n  }\n}\n```\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)\n\nNeed help? See the [VS Code MCP docs ↗](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)\n\nConfigure\n\nYou can add SigNoz Cloud as a **custom connector** in Claude Desktop:\n\n- Open Claude Desktop.\n- Go to\n**Settings**→** Developer**(or** Features**depending on your version). - Click\n**Add Custom Connector** or**Add Remote MCP Server**. - Enter your SigNoz MCP URL:\n`https://mcp.<region>.signoz.cloud/mcp`\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)\n\nWhen prompted, complete the authentication flow.\n\nConfigure\n\nRun this command to add the SigNoz MCP server:\n\n```\nclaude mcp add --scope user --transport http signoz https://mcp.<region>.signoz.cloud/mcp\n```\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)\n\nAfter configuring the MCP server, you need to authenticate. In a terminal run:\n\n```\nclaude /mcp\n```\n\nSelect the **signoz** server and complete the authentication flow.\n\nConfigure\n\nRun this command to add the SigNoz MCP server:\n\n```\ncodex mcp add signoz --url https://mcp.<region>.signoz.cloud/mcp\n```\n\nOr add this configuration to `config.toml`\n\n:\n\n```\n[mcp_servers.signoz]\nurl = \"https://mcp.<region>.signoz.cloud/mcp\"\n```\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)\n\nAfter adding the server, authenticate:\n\n```\ncodex mcp login signoz\n```\n\nThen run `/mcp`\n\ninside Codex to verify the connection.\n\nConfigure\n\nAdd the MCP server via CLI:\n\n```\ngemini mcp add -t http signoz https://mcp.<region>.signoz.cloud/mcp\n```\n\nOr add this configuration to `~/.gemini/settings.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"httpUrl\": \"https://mcp.<region>.signoz.cloud/mcp\"\n    }\n  }\n}\n```\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)\n\nAfter installation, start Gemini CLI and authenticate:\n\n```\n/mcp auth signoz\n```\n\nConfigure\n\nAdd this configuration to `~/.codeium/windsurf/mcp_config.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"serverUrl\": \"https://mcp.<region>.signoz.cloud/mcp\"\n    }\n  }\n}\n```\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)\n\nWhen prompted, complete the authentication flow.\n\nConfigure\n\n- Open the\n**MCP Store** via the`...`\n\nmenu in the agent panel. - Click\n**Manage MCP Servers**. - Add a new server with the SigNoz MCP URL:\n`https://mcp.<region>.signoz.cloud/mcp`\n\nOr manually add to `mcp_config.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"serverUrl\": \"https://mcp.<region>.signoz.cloud/mcp\"\n    }\n  }\n}\n```\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)\n\nAfter saving the config, it will prompt you to complete the OAuth flow. To edit the config from within Antigravity, click the `...`\n\nmenu at the top of the Agent pane → **MCP Servers** → **Manage MCP Servers** → **View raw config**.\n\nIf you run into authentication issues, open the command palette and run **Authentication: Remove Dynamic Authentication Providers** to clear cached OAuth credentials and re-authenticate.\n\nAuthenticate from your client\n\nWhen you add the hosted MCP URL to your client, the MCP client will initiate an authentication flow. You will be prompted to enter:\n\n- Your\n**SigNoz instance URL**(e.g.,`https://your-instance.signoz.cloud`\n\n) - Your\n**API key**— go to** Settings → Service Accounts**in SigNoz, create a service account, and generate an API key (requires** Admin**role). See[Service Accounts](https://signoz.io/docs/manage/administrator-guide/iam/service-accounts/)for details.\n\nOnly **Admin** users can create API keys. If you don't see the option, contact your workspace administrator.\n\nHeader-Based Authentication\n\nSome MCP clients (like Cursor Automations) run entirely in the cloud and cannot perform interactive OAuth authentication. For these clients, use header-based authentication by passing your API key and instance URL directly in the request headers.\n\nIf your MCP client doesn't support OAuth flows or stdio transport — for example, Cursor Automations: use this header-based configuration instead.\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"url\": \"https://mcp.<region>.signoz.cloud/mcp\",\n      \"headers\": {\n        \"SIGNOZ-API-KEY\": \"<your-api-key>\",\n        \"X-SigNoz-URL\": \"<your-signoz-instance-url>\"\n      }\n    }\n  }\n}\n```\n\n`<region>`\n\n: Your SigNoz Cloud[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)`<your-api-key>`\n\n: API key from[SigNoz Service accounts](https://signoz.io/docs/manage/administrator-guide/iam/service-accounts/)`<your-signoz-instance-url>`\n\n: Your SigNoz Cloud instance URL\n\nKeep your API key secure — never commit `mcp.json`\n\nto version control when it contains secrets.\n\nFor self-hosted SigNoz, you run the MCP server locally. The server supports two transport modes: **Stdio** (local binary, launched by the client) and **HTTP** (standalone server the client connects to over the network).\n\nFetch your API key\n\n- Log in to your SigNoz instance.\n- Go to\n**Settings**→** Service Accounts**. - Create a service account, open its\n**Keys** tab, click**Add Key**, and copy the generated key. See[Service Accounts](https://signoz.io/docs/manage/administrator-guide/iam/service-accounts/)for details.\n\nOnly **Admin** users can create API keys. Keep your key secure — never commit it to version control.\n\nInstall the MCP server\n\nDownload the latest binary from [GitHub Releases](https://github.com/SigNoz/signoz-mcp-server/releases):\n\n```\n# macOS (Apple Silicon)\ncurl -L https://github.com/SigNoz/signoz-mcp-server/releases/latest/download/signoz-mcp-server_darwin_arm64.tar.gz | tar xz\n\n# macOS (Intel)\ncurl -L https://github.com/SigNoz/signoz-mcp-server/releases/latest/download/signoz-mcp-server_darwin_amd64.tar.gz | tar xz\n\n# Linux (amd64)\ncurl -L https://github.com/SigNoz/signoz-mcp-server/releases/latest/download/signoz-mcp-server_linux_amd64.tar.gz | tar xz\n```\n\nThis extracts a `signoz-mcp-server`\n\nbinary in the current directory. Move it somewhere on your `PATH`\n\nor note the absolute path for the config below.\n\n```\ngo install github.com/SigNoz/signoz-mcp-server/cmd/server@latest\n```\n\nThe binary is installed as `server`\n\nto `$GOPATH/bin/`\n\n(default: `$HOME/go/bin/server`\n\n). You may want to rename it:\n\n```\nmv \"$(go env GOPATH)/bin/server\" \"$(go env GOPATH)/bin/signoz-mcp-server\"\ndocker pull signoz/signoz-mcp-server:latest\n```\n\nRun in HTTP mode:\n\n```\ndocker run -p 8000:8000 \\\n  -e TRANSPORT_MODE=http \\\n  -e MCP_SERVER_PORT=8000 \\\n  -e SIGNOZ_URL=<your-signoz-url> \\\n  -e SIGNOZ_API_KEY=<your-api-key> \\\n  signoz/signoz-mcp-server:latest\n```\n\n`<your-signoz-url>`\n\n: Your self-hosted SigNoz instance URL (e.g.,`http://localhost:3301`\n\n)`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\nDocker always runs in HTTP transport mode. Use the **HTTP** tabs in the client setup below.\n\n```\ngit clone https://github.com/SigNoz/signoz-mcp-server.git\ncd signoz-mcp-server\nmake build\n```\n\nThe binary is at `./bin/signoz-mcp-server`\n\n.\n\nConfigure your MCP client\n\nAdd the following to `.cursor/mcp.json`\n\nin your project root, or use **Cursor → Settings → Tools & Integrations → + New MCP Server**:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"command\": \"<path-to-binary>/signoz-mcp-server\",\n      \"args\": [],\n      \"env\": {\n        \"SIGNOZ_URL\": \"<your-signoz-url>\",\n        \"SIGNOZ_API_KEY\": \"<your-api-key>\",\n        \"LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\n- Start the MCP server in HTTP mode:\n\n```\nSIGNOZ_URL=<your-signoz-url> \\\nSIGNOZ_API_KEY=<your-api-key> \\\nTRANSPORT_MODE=http \\\nMCP_SERVER_PORT=8000 \\\nLOG_LEVEL=info \\\n./signoz-mcp-server\n```\n\n- Add to\n`.cursor/mcp.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"url\": \"http://localhost:8000/mcp\"\n    }\n  }\n}\n```\n\nOpen Command Palette (`Cmd+Shift+P`\n\n/ `Ctrl+Shift+P`\n\n) → ** MCP: Open User Configuration**, then add:\n\n```\n{\n  \"servers\": {\n    \"signoz\": {\n      \"type\": \"stdio\",\n      \"command\": \"<path-to-binary>/signoz-mcp-server\",\n      \"args\": [],\n      \"env\": {\n        \"SIGNOZ_URL\": \"<your-signoz-url>\",\n        \"SIGNOZ_API_KEY\": \"<your-api-key>\",\n        \"LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\nOpen Copilot Chat in **Agent mode** and confirm you trust the server.\n\n- Start the MCP server in HTTP mode.\n- Add to VS Code MCP config:\n\n```\n{\n  \"servers\": {\n    \"signoz\": {\n      \"type\": \"http\",\n      \"url\": \"http://localhost:8000/mcp\"\n    }\n  }\n}\n```\n\nOpen Copilot Chat in **Agent mode** and confirm you trust the server.\n\nGo to **Settings → Developer → Edit Config** and add to `claude_desktop_config.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"command\": \"<path-to-binary>/signoz-mcp-server\",\n      \"args\": [],\n      \"env\": {\n        \"SIGNOZ_URL\": \"<your-signoz-url>\",\n        \"SIGNOZ_API_KEY\": \"<your-api-key>\",\n        \"LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\n- Start the MCP server in HTTP mode:\n\n```\nSIGNOZ_URL=<your-signoz-url> \\\nSIGNOZ_API_KEY=<your-api-key> \\\nTRANSPORT_MODE=http \\\nMCP_SERVER_PORT=8000 \\\nLOG_LEVEL=info \\\n./signoz-mcp-server\n```\n\n- Add to\n`claude_desktop_config.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"url\": \"http://localhost:8000/mcp\"\n    }\n  }\n}\nclaude mcp add --scope user signoz \"<path-to-binary>/signoz-mcp-server\" \\\n  -e SIGNOZ_URL=\"<your-signoz-url>\" \\\n  -e SIGNOZ_API_KEY=\"<your-api-key>\" \\\n  -e LOG_LEVEL=info\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\nUse `--scope project`\n\nto limit to the current project. Remove with `claude mcp remove signoz`\n\n.\n\n- Start the MCP server in HTTP mode.\n- Add via CLI:\n\n```\nclaude mcp add --scope user --transport http signoz http://localhost:8000/mcp\ncodex mcp add signoz \\\n  --env SIGNOZ_URL=\"<your-signoz-url>\" \\\n  --env SIGNOZ_API_KEY=\"<your-api-key>\" \\\n  --env LOG_LEVEL=info \\\n  -- \"<path-to-binary>/signoz-mcp-server\"\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\nEdit `~/.codex/config.toml`\n\n(global) or `.codex/config.toml`\n\n(project):\n\n```\n[mcp_servers.signoz]\ncommand = \"<path-to-binary>/signoz-mcp-server\"\nargs = []\n\n[mcp_servers.signoz.env]\nSIGNOZ_URL = \"<your-signoz-url>\"\nSIGNOZ_API_KEY = \"<your-api-key>\"\nLOG_LEVEL = \"info\"\n```\n\nAdd this configuration to `~/.codeium/windsurf/mcp_config.json`\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"command\": \"<path-to-binary>/signoz-mcp-server\",\n      \"args\": [],\n      \"env\": {\n        \"SIGNOZ_URL\": \"<your-signoz-url>\",\n        \"SIGNOZ_API_KEY\": \"<your-api-key>\",\n        \"LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\n- Start the MCP server in HTTP mode.\n- Edit\n`~/.codeium/windsurf/mcp_config.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"serverUrl\": \"http://localhost:8000/mcp\"\n    }\n  }\n}\n```\n\nAdd to `~/.gemini/settings.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"command\": \"<path-to-binary>/signoz-mcp-server\",\n      \"args\": [],\n      \"env\": {\n        \"SIGNOZ_URL\": \"<your-signoz-url>\",\n        \"SIGNOZ_API_KEY\": \"<your-api-key>\",\n        \"LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\n- Start the MCP server in HTTP mode.\n- Add to\n`~/.gemini/settings.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"httpUrl\": \"http://localhost:8000/mcp\"\n    }\n  }\n}\n```\n\nOpen Zed settings (`Cmd+,`\n\n) and add:\n\n```\n{\n  \"context_servers\": {\n    \"signoz\": {\n      \"command\": \"<path-to-binary>/signoz-mcp-server\",\n      \"args\": [],\n      \"env\": {\n        \"SIGNOZ_URL\": \"<your-signoz-url>\",\n        \"SIGNOZ_API_KEY\": \"<your-api-key>\",\n        \"LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\nAdd to `mcp_config.json`\n\n(open via `...`\n\nmenu → **MCP Servers** → **Manage MCP Servers** → **View raw config**):\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"command\": \"<path-to-binary>/signoz-mcp-server\",\n      \"args\": [],\n      \"env\": {\n        \"SIGNOZ_URL\": \"<your-signoz-url>\",\n        \"SIGNOZ_API_KEY\": \"<your-api-key>\",\n        \"LOG_LEVEL\": \"info\"\n      }\n    }\n  }\n}\n```\n\n`<path-to-binary>`\n\n: Absolute path to the`signoz-mcp-server`\n\nbinary`<your-signoz-url>`\n\n: Your SigNoz instance URL`<your-api-key>`\n\n: The API key from[Fetch your API key](#fetch-your-api-key)\n\n- Start the MCP server in HTTP mode.\n- Add to\n`mcp_config.json`\n\n:\n\n```\n{\n  \"mcpServers\": {\n    \"signoz\": {\n      \"serverUrl\": \"http://localhost:8000/mcp\"\n    }\n  }\n}\n```\n\nConfiguration Reference\n\nEnvironment variables for the self-hosted MCP server. SigNoz Cloud users do not need to set these.\n\n| Variable | Description | Default |\n|---|---|---|\n`SIGNOZ_URL` | URL of your SigNoz instance | (required for stdio; optional for http with OAuth) |\n`SIGNOZ_API_KEY` | API key for authenticating with SigNoz | (required for stdio; optional for http with OAuth) |\n`TRANSPORT_MODE` | Transport protocol: `stdio` or `http` | `stdio` |\n`MCP_SERVER_PORT` | Port for HTTP server (when `TRANSPORT_MODE=http` ) | `8000` |\n`LOG_LEVEL` | Logging verbosity: `debug` , `info` , `warn` , `error` | `info` |\n`SIGNOZ_CUSTOM_HEADERS` | Extra HTTP headers added to every SigNoz API request, such as reverse-proxy auth headers. Format: `Key1:Value1,Key2:Value2` | (optional) |\n`SIGNOZ_DOCS_REFRESH_INTERVAL` | Refresh interval for the embedded docs sitemap used by `signoz_search_docs` / `signoz_fetch_doc` (Go duration) | `6h` |\n`SIGNOZ_DOCS_FULL_REFRESH_INTERVAL` | Full refresh interval for the embedded docs corpus (Go duration) | `24h` |\n`OAUTH_ENABLED` | Enable OAuth 2.1 authentication (`true` /`false` ) | `false` |\n`OAUTH_TOKEN_SECRET` | Encryption key for OAuth tokens (min 32 bytes) | (required when `OAUTH_ENABLED=true` ) |\n`OAUTH_ISSUER_URL` | Public URL of this MCP server | (required when `OAUTH_ENABLED=true` ) |\n`OAUTH_ACCESS_TOKEN_TTL_MINUTES` | Access token lifetime in minutes | `60` |\n`OAUTH_REFRESH_TOKEN_TTL_MINUTES` | Refresh token lifetime in minutes | `43200` (30d) |\n`OAUTH_AUTH_CODE_TTL_SECONDS` | Authorization code lifetime in seconds | `600` (10min) |\n\nValidate\n\nAfter connecting, verify the server is working:\n\n- Open your AI assistant.\n- Ask:\n*\"List all alerts\"*or*\"Show me all available services\"*. - The assistant should return structured results from your SigNoz instance.\n\nAvailable Tools\n\n[Available Tools](#available-tools)\n\nThe MCP server exposes the following tools to your AI assistant:\n\nAlert-rule and notification-channel tools use newer SigNoz rules and channels APIs. Use SigNoz v0.120.0 or later for full compatibility with the latest MCP server. Older SigNoz deployments may return HTTP 404 for those tools.\n\n| Tool | Description |\n|---|---|\n`signoz_list_metrics` | Search and list available metrics |\n`signoz_query_metrics` | Query metrics with smart aggregation defaults |\n`signoz_get_field_keys` | Discover available field keys for metrics, traces, or logs |\n`signoz_get_field_values` | Get possible values for a field key |\n`signoz_list_alerts` | List firing, silenced, or inhibited Alertmanager alert instances |\n`signoz_list_alert_rules` | List configured alert rules, including inactive or disabled rules |\n`signoz_get_alert` | Get an alert rule definition by ID |\n`signoz_get_alert_history` | Get alert history timeline for a rule |\n`signoz_create_alert` | Create an alert rule using v2 schema validation |\n`signoz_update_alert` | Update an existing alert rule |\n`signoz_delete_alert` | Delete an alert rule |\n`signoz_list_dashboards` | List all dashboards with summaries |\n`signoz_get_dashboard` | Get full dashboard configuration |\n`signoz_create_dashboard` | Create a new dashboard |\n`signoz_update_dashboard` | Update an existing dashboard |\n`signoz_delete_dashboard` | Delete a dashboard by UUID |\n`signoz_list_dashboard_templates` | List the bundled SigNoz dashboard template catalog so the model can pick one |\n`signoz_import_dashboard` | Create a dashboard from a curated SigNoz dashboard template by path |\n`signoz_list_services` | List services within a time range |\n`signoz_get_service_top_operations` | Get top operations for a service |\n`signoz_list_views` | List saved Explorer views for traces, logs, or metrics |\n`signoz_get_view` | Get a saved Explorer view by UUID |\n`signoz_create_view` | Create a saved Explorer view |\n`signoz_update_view` | Replace an existing saved Explorer view |\n`signoz_delete_view` | Delete a saved Explorer view |\n`signoz_aggregate_logs` | Aggregate logs (count, avg, p99, etc.) with grouping |\n`signoz_search_logs` | Search logs with flexible filtering |\n`signoz_aggregate_traces` | Aggregate trace statistics with grouping |\n`signoz_search_traces` | Search traces with flexible filtering |\n`signoz_get_trace_details` | Get full trace with all spans |\n`signoz_execute_builder_query` | Execute a raw Query Builder v5 query |\n`signoz_search_docs` | Search official SigNoz docs for product, setup, instrumentation, config, API, deployment, or troubleshooting questions |\n`signoz_fetch_doc` | Fetch full markdown for one official SigNoz docs page or heading |\n`signoz_list_notification_channels` | List notification channels |\n`signoz_get_notification_channel` | Get a single notification channel by ID |\n`signoz_create_notification_channel` | Create a notification channel and send a test notification |\n`signoz_update_notification_channel` | Update a notification channel and send a test notification |\n`signoz_delete_notification_channel` | Delete a notification channel by ID |\n\nFor detailed parameter reference, see the [GitHub repository README](https://github.com/SigNoz/signoz-mcp-server?tab=readme-ov-file#available-tools).\n\nTroubleshooting\n\n[Troubleshooting](#troubleshooting)\n\nTools not appearing in the AI client\n\n- Verify the binary path is correct and the file is executable (self-hosted only).\n- Set\n`LOG_LEVEL=debug`\n\nfor detailed server logs.\n\nAuthentication errors\n\n- For SigNoz Cloud: ensure you are using the correct\n[region](https://signoz.io/docs/ingestion/signoz-cloud/overview/#endpoint)in the MCP URL. - Confirm your API key is valid and has not expired.\n- For self-hosted HTTP mode where the client sends the key, use the\n`SIGNOZ-API-KEY: <your-api-key>`\n\nheader.\n\nSigNoz Cloud connection issues\n\n- Verify the region in the URL matches your account (\n`https://mcp.<region>.signoz.cloud/mcp`\n\n). - Check your network can reach\n`mcp.<region>.signoz.cloud`\n\n. - Make sure you completed the authentication flow when prompted.\n\nServer not starting (self-hosted HTTP mode)\n\n- Ensure port\n`8000`\n\nis not already in use. - Check that\n`TRANSPORT_MODE=http`\n\nis set. - Review server logs for startup errors.", "url": "https://wpnews.pro/news/signoz-mcp-server", "canonical_source": "https://signoz.io/docs/ai/signoz-mcp-server", "published_at": "2026-05-27 00:00:00+00:00", "updated_at": "2026-05-28 15:43:09.681477+00:00", "lang": "en", "topics": ["ai-tools", "ai-infrastructure", "large-language-models", "artificial-intelligence", "ai-agents"], "entities": ["SigNoz", "Model Context Protocol", "MCP", "SigNoz Cloud", "Cursor", "VS Code"], "alternates": {"html": "https://wpnews.pro/news/signoz-mcp-server", "markdown": "https://wpnews.pro/news/signoz-mcp-server.md", "text": "https://wpnews.pro/news/signoz-mcp-server.txt", "jsonld": "https://wpnews.pro/news/signoz-mcp-server.jsonld"}}