SigNoz MCP Server
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.
Power your agent
Yayıncının kendi komutu. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.19.0Claude Code'un yerel komutlar için kurulum bağlantısı yok. Aşağıdaki komutu kopyalayın ve bir terminalde çalıştırın.
claude mcp add signoz-signoz-mcp-server -- docker run -i --rm docker.io/signoz/signoz-mcp-server:v0.19.0Bir terminalde çalıştırın.
{ "mcpServers": { "signoz-signoz-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "docker.io/signoz/signoz-mcp-server:v0.19.0" ] } }}claude_desktop_config.json
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
BaşlatConnect your AI tool to SigNoz Cloud's hosted MCP server. No installation is required; just add the hosted MCP URL and authenticate.
https://mcp.<region>.signoz.cloud/mcp
Make sure you select the correct region that matches your SigNoz Cloud account. Using the wrong region will result in authentication failures.
Find your region under Settings → Ingestion in SigNoz, or see the SigNoz Cloud region reference.
GitHub does not reliably make custom-protocol links like cursor:// and vscode: clickable in README rendering.
Use the documentation page for one-click install buttons:
If you prefer, use the manual configuration examples below in this README.
Add this configuration to .cursor/mcp.json:
{
"mcpServers": {
"signoz": {
"url": "https://mcp.<region>.signoz.cloud/mcp"
}
}
}
Need help? See the Cursor MCP docs.
Add this configuration to .vscode/mcp.json:
{
"servers": {
"signoz": {
"type": "http",
"url": "https://mcp.<region>.signoz.cloud/mcp"
}
}
}
Need help? See the VS Code MCP docs.
Add SigNoz Cloud as a custom connector in Claude Desktop:
https://mcp.<region>.signoz.cloud/mcpWhen prompted, complete the authentication flow.
Run this command to add the hosted SigNoz MCP server:
claude mcp add --scope user --transport http signoz https://mcp.<region>.signoz.cloud/mcp
After configuring the MCP server, authenticate in a terminal:
claude /mcp
Select the signoz server and complete the authentication flow.
Run this command to add the hosted SigNoz MCP server:
codex mcp add signoz --url https://mcp.<region>.signoz.cloud/mcp
Or add this configuration to config.toml:
[mcp_servers.signoz]
url = "https://mcp.<region>.signoz.cloud/mcp"
After adding the server, authenticate:
codex mcp login signoz
Then run /mcp inside Codex to verify the connection.
Run this command to add the hosted SigNoz MCP server:
grok mcp add -t http signoz https://mcp.<region>.signoz.cloud/mcp
Or add this configuration to ~/.grok/config.toml:
[mcp_servers.signoz]
url = "https://mcp.<region>.signoz.cloud/mcp"
enabled = true
Adding the server does not authenticate it. Start Grok Build, run /mcps, select the signoz server, and complete the OAuth flow in your browser:
grok
/mcps
No API key is stored in the config file; credentials are saved separately once the OAuth flow completes.
Use -s project on the add command to write to ./.grok/config.toml instead, so the server is shared with everyone working in that directory.
Verify the connection with:
grok mcp list
grok mcp doctor
When you add the hosted MCP URL to your client, the client initiates an authentication flow. You will be prompted to enter:
your-instance.signoz.cloud). Protocol-less URLs are accepted; paths, query parameters, and fragments are ignored.Create an API key in Settings → API Keys in SigNoz. Only Admin users can create API keys.
Download the latest binary from GitHub Releases:
# 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
This extracts a signoz-mcp-server binary in the current directory. Move it somewhere on your PATH or note the absolute path for the config below.
go install github.com/SigNoz/signoz-mcp-server/cmd/server@latest
The binary is installed as server to $GOPATH/bin/ (default: $HOME/go/bin/server). You may want to rename it:
mv "$(go env GOPATH)/bin/server" "$(go env GOPATH)/bin/signoz-mcp-server"
Docker images are available on Docker Hub:
docker pull signoz/signoz-mcp-server:latest
Run in HTTP mode:
docker run -p 8000:8000 \
-e TRANSPORT_MODE=http \
-e MCP_SERVER_PORT=8000 \
-e SIGNOZ_URL=https://your-signoz-instance.com \
-e SIGNOZ_API_KEY=your-api-key \
signoz/signoz-mcp-server:latest
Use a specific version tag (e.g. v0.1.0) instead of latest for pinned deployments.
git clone https://github.com/SigNoz/signoz-mcp-server.git
cd signoz-mcp-server
make build
The binary is at ./bin/signoz-mcp-server.
signoz-mcp-server binary (see Self-Hosted Installation)Add this to your MCP client config (claude_desktop_config.json, .cursor/mcp.json, etc.). Replace the command path with the absolute path to your signoz-mcp-server binary:
{
"mcpServers": {
"signoz": {
"command": "/absolute/path/to/signoz-mcp-server",
"args": [],
"env": {
"SIGNOZ_URL": "https://your-signoz-instance.com",
"SIGNOZ_API_KEY": "your-api-key-here",
"LOG_LEVEL": "info"
}
}
}
}
HTTP mode listens on all interfaces by default. Set MCP_SERVER_HOST=127.0.0.1 when the server should accept loopback connections only.
The server keeps the SigNoz docs search index in memory. With stemming on titles and headings and a single standard-analyzed body field, the embedded 746-page index used 28 to 36 MiB of resident heap across eight local Go 1.26 whole-package test runs. Build peaks ranged from 97 to 134 MiB above the pre-build heap baseline, using 64-page batches. These are index measurements, not whole-process RSS or container memory guarantees; request handling and refresh work add memory.
A scheduled refresh (default every 6h) first compares the live sitemap with the served one and stops there when it is unchanged. Otherwise it revalidates every page with If-None-Match and touches the index only when at least one page's content changed. A change set covering up to a quarter of the pages is applied to the live index in place; a larger one, the 25th in-place update on the same index, and any forced refresh (default every 24h) that finds changed content rebuild the index from scratch, which also compacts the segments that in-place updates leave behind. Full rebuilds use 64-page batches. In-place updates use one atomic batch bounded by the quarter-of-pages threshold, not the full-build batch size.
Recommendations for containerized HTTP deployments:
512Mi, and monitor memory during refreshes and concurrent requests. The highest measured index-only build peak is 134 MiB above baseline and the resident index is 28 to 36 MiB; rebuilds also retain the serving index. Setting Go's GOMEMLIMIT is optional: it can reclaim garbage earlier but cannot shrink live data inside an index batch.SIGNOZ_DOCS_REFRESH_INTERVAL=0 and SIGNOZ_DOCS_FULL_REFRESH_INTERVAL=0 when you would rather serve the docs snapshot that shipped with the release than pay any refresh. New docs pages then arrive with the next server upgrade. Setting only the first keeps the daily forced refresh.docs refresh starting and ends with a completion or failure line, for example docs refresh no-op; sitemap unchanged, docs refresh found no page changes; index kept, docs refresh applied delta, docs refresh rebuilt index, or a docs refresh failed / docs full refresh failed warning. A refresh normally finishes within a few minutes. A container whose last docs line is docs refresh starting, docs refresh fetching pages, or docs refresh rebuilding index and that then restarted most likely died mid-refresh.Start the server:
TRANSPORT_MODE=http \
MCP_SERVER_PORT=8000 \
OAUTH_ENABLED=true \
OAUTH_TOKEN_SECRET=$(openssl rand -base64 32) \
OAUTH_ISSUER_URL=https://your-public-mcp-url.com \
./signoz-mcp-server
Client config needs just the URL, no keys:
{
"mcpServers": {
"signoz": {
"url": "https://your-public-mcp-url.com/mcp"
}
}
}
The client discovers OAuth endpoints automatically, opens a browser for credentials, and handles token exchange.
The API key and SigNoz URL only need to be provided in one place: the server or the client.
Option A — Credentials on the server (simpler client config):
SIGNOZ_URL=https://your-signoz-instance.com \
SIGNOZ_API_KEY=your-api-key \
TRANSPORT_MODE=http \
MCP_SERVER_PORT=8000 \
./signoz-mcp-server
{
"mcpServers": {
"signoz": {
"url": "http://localhost:8000/mcp"
}
}
}
Option B — API key on the client (server holds the URL, client sends the key):
SIGNOZ_URL=https://your-signoz-instance.com \
TRANSPORT_MODE=http \
MCP_SERVER_PORT=8000 \
./signoz-mcp-server
{
"mcpServers": {
"signoz": {
"url": "http://localhost:8000/mcp",
"headers": {
"SIGNOZ-API-KEY": "your-api-key-here"
}
}
}
}
SigNoz uses the official MCP Go SDK v1.8.0 and supports both current lifecycle models over HTTP and stdio:
The HTTP /mcp endpoint is stateless and sessionless. MCP messages use JSON
POST requests and successful responses use application/json; the server does
not issue or require Mcp-Session-Id. GET /mcp and DELETE /mcp return
405 Method Not Allowed, so deployments need neither sticky routing nor the old
GET listener/heartbeat. Existing client configuration does not change.
Stdio input has a 16 MiB frame limit. Split larger requests into smaller calls.
MCP_MAX_REQUEST_BYTES controls HTTP request bodies only.
The server intentionally does not advertise the deprecated logging capability. Discovery ordering is not a compatibility guarantee. Unknown tools, resources, and prompts use the official SDK's standard invalid-params behavior rather than legacy implementation-specific wording or error codes.
HTTP mode exposes unauthenticated probe endpoints. New Kubernetes deployments should use /livez for livenessProbe and /readyz for readinessProbe.
"Show me all available metrics"
"What's the p99 latency for http_request_duration_seconds?"
"List all active alerts"
"Show me error logs for the paymentservice from the last hour"
"How many errors per service in the last hour?"
"Search traces for the checkout service from the last hour"
"Get details for trace ID abc123"
"Create a dashboard with CPU and memory widgets"
"How do I send Docker logs to SigNoz?"
Tool metadata: every tool accepts
searchContext. Copy the user's entire original request verbatim, including preflight or confirmation context; it is used for MCP observability and is not forwarded to SigNoz APIs.
Input validation: calls are never rejected for schema mismatches. Arguments are validated against each tool's advertised schema; a mismatched call still runs best-effort, and the successful result carries a deterministic appended
Input validation notice:naming the affected top-level parameter when it can be derived safely from the advertised schema. Complex root-only mismatches use a generic fallback. Mismatches are also counted in themcp.tool.validation.mismatchesmetric.
Upstream errors: upstream SigNoz 401 and 403 tool failures carry a stable structured
code(UNAUTHORIZEDorPERMISSION_DENIED) and numericstatus. Recognized SigNoz error envelopes may also include boundedupstreamURL,upstreamSuggestions,upstreamDetails([{message, suggestions}]), andupstreamRetry({delay}in nanoseconds); the same recovery guidance appears in agent-readable text. Unrecognized bodies use the local status-derived coded fallback instead of raw passthrough, and authorization failures still name the failed tool and immediate recovery action. This error-only addition does not change tool names, schemas or descriptions, success payloads, resources or templates, or prompts.
For detailed usage and examples, see the full documentation.
Resource deep links: the resource read tools (
signoz_list_dashboards,signoz_get_dashboard,signoz_list_alerts,signoz_list_alert_rules,signoz_get_alert,signoz_list_services,signoz_search_traces,signoz_get_trace_details) and the dashboard write tools (signoz_create_dashboard,signoz_update_dashboard,signoz_patch_dashboard,signoz_import_dashboard) include awebUrlfield when the request carries a SigNoz instance URL: an absolute deep link to the resource in the SigNoz web UI (per result row forsignoz_search_traces). The MCP server discovers the browser base from each SigNoz backend'sglobal.external_url. API requests keep using the request's backend URL. See Browser links for self-hosted SigNoz.
Use signoz_search_docs for topical discovery when no exact documentation page is selected, then signoz_fetch_doc for the chosen page or heading. Use live data tools for tenant telemetry, alert state, dashboards, saved views, and notification channels.
Docs tools use the same authentication path as other MCP tools.
The live signoz://dashboard/{id}/summary and signoz://alert/{id}/summary
resource templates are retired. resources/templates/list now returns an empty
catalog. Use signoz_get_dashboard for a dashboard definition. For the former
alert summary, call signoz_get_alert, then signoz_get_alert_history; omit the
time range for the same six-hour window and set limit: 10 and order: "desc"
for the closest history result.
signoz_get_org_overviewGet the current status and overall posture of the SigNoz deployment before drilling into exact resources. data.sourceStats is the authoritative complete flat bag containing every key and value reported by the deployment stats endpoint, including current and future fields. Typed convenience projections cover telemetry freshness and volume, infrastructure presence, dashboards, alert rules and runtime, notification channels, saved views, log pipelines, cloud integrations, users, authentication, service accounts, roles, licensing, and configuration.
searchContext for MCP observability.sourceStats preserves every successfully decoded entry from the upstream data object under its original dotted key. Use the grouped fields for convenient interpretation and sourceStats when exact backend coverage or a newly introduced field matters. Counts are deployment aggregates; use signoz_list_dashboards, signoz_list_alert_rules, signoz_list_notification_channels, or signoz_list_views for exact inventories; signoz_list_metrics for metric names; signoz_list_alerts for current alert instances; and signoz_search_logs, signoz_search_traces, or signoz_query_metrics for time-windowed or per-service data.sourceStats was not reported by the upstream collector and must not be interpreted as zero. The endpoint can return a partial HTTP 200 when an individual collector fails. In typed projections, a missing group total produces available: false; a reported zero produces available: true. Expected missing or invalid projection fields set metadata.projectionPartial and add an incompleteGroups entry with affected output paths, reason, next action, and exact fallback tools where available. An invalid projection value is still retained unchanged in sourceStats and named in invalidProjectionFields.cloudIntegrations.sourceAvailability reports whether both current AWS/Azure provider counts were reported. Each provider has its own dataAvailable; an absent provider count is never converted to zero. If neither provider is reported, source availability is unavailable without setting overall metadata.projectionPartial; this can mean cloud integrations are unsupported/edition-gated or both provider queries failed, so do not interpret it as “no cloud integrations configured.” If exactly one is reported, source availability is partial and the missing provider receives non-recursive recovery guidance. connectedAccounts means a non-removed account with an account ID and at least one agent report, not a recent check-in or proof that an integration service is enabled.reportedStatCount is the number of authoritative entries in sourceStats; projectedStatCount counts entries also represented in typed groups; and unprojectedStatCount counts entries available only in sourceStats, including future fields. projectionPartial, incompleteGroups, and invalidProjectionFields describe only typed-projection gaps; they do not indicate data was removed from sourceStats or claim endpoint-wide completeness.signoz_list_metricsDiscover metric names and catalog metadata such as type, temporality, unit, and monotonicity. Use signoz_query_metrics for values or trends. This list has a limit but no offset pagination.
searchText (optional) - Filter metrics by name substring (e.g., 'cpu', 'memory')limit (optional) - Maximum number of metrics to return (default: 50)timeRange (optional) - Relative range: 30m, 1h, 6h, 24h, 7d (default: 1h; ignored when both start and end are provided)start/end (optional) - Unix ms timestamps. When both are provided, they override timeRange.source (optional) - Data-source filter. Use "meter" to list Cost Meter metrics, the usage/billing metrics SigNoz meters on (currently telemetry ingestion volume); omit for the default metrics storehasMore (inferred from returnedRows == limit) so a limit-truncated list is never mistaken for the full set; narrow with searchText for more specificitysignoz_query_metricsQuery a known metric for values, trends, breakdowns, or formulas. The tool applies metric-aware defaults and auto-fetches omitted metadata; call it directly when metricName is known. Use signoz_list_metrics only to discover a name or inspect catalog metadata.
metricName (required) - Metric name to querymetricType (optional) - gauge, sum, histogram, exponential_histogram (auto-fetched if absent)isMonotonic (optional) - Boolean (or the strings "true"/"false"); auto-fetched if absent. An invalid value is rejected rather than silently treated as falsetemporality (optional) - cumulative, delta, unspecified (auto-fetched if absent)timeAggregation (optional) - Aggregation over time (auto-defaulted by type)spaceAggregation (optional) - Aggregation across dimensions (auto-defaulted by type)groupBy (optional) - Comma-separated field names or an array. Resource context is inferred for k8s.*, container.*, host.*, cloud.*, deployment.*, process.*, service.*, telemetry.*, and os.*; other names use attribute contextfilter (optional) - Filter expressiontimeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '7d'; default: '1h'; ignored when both start and end are provided)start/end (optional) - Unix ms timestamps. When both are provided, they override timeRange.stepInterval (optional) - Step in seconds (auto-calculated if omitted)requestType (optional) - Response format. Enum: time_series (default), scalar. Unknown values are rejected.reduceTo (optional) - For scalar: sum, count, avg, min, max, last, medianformula (optional) - Expression over named queries (e.g., "A / B * 100")formulaQueries (optional) - Array or JSON-encoded array string of additional named metric queries for formula. Each object supports name, metricName, metricType, isMonotonic, temporality, timeAggregation, spaceAggregation, groupBy, and filter; name and metricName are required.source (optional) - Data-source filter. Use "meter" to query Cost Meter data; omit for the default metrics storelimit: 100 with __result desc. Every query feeding a formula uses limit: 10000, because component limits are applied before formula evaluation and independent top-100 inputs can discard a high-ratio group. The response decisions note reports both bounds. Narrow the filters/grouping when formula-input cardinality can exceed 10000.missingKeys array in the structured error contentsignoz_get_top_metricsReturn top 100 metrics ranked by ingested sample volume with pre-computed percentages. Use this to identify which metrics are driving the most ingestion volume and cost. Wraps POST /api/v2/metrics/treemap. Response fields: metricName, percentage (share of total sample volume), totalValue (absolute sample count).
timeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '1h', '24h', '3d', '7d', '30d'; default: '7d'; ignored when both start and end are provided). Start with 7d; if the query times out, retry with 3d, then 24hstart/end (optional) - Unix ms timestamps. When both are provided, they override timeRangehasMore)signoz_check_metric_usageGiven a list of metric names, return which dashboards and alerts reference each one. Wraps /api/v3/metrics/dashboards?metricName=... and /api/v2/metrics/alerts?metricName=... per metric.
metricNames (required) - Array of metric name strings to check (max 50 per call). Example: ["system.disk.io", "k8s.node.condition"]. For larger lists, split into batches of 50 and merge results.dashboards (list of dashboard names that reference the metric), alerts (list of alert names that reference the metric), error (non-empty when the lookup failed; do not treat the metric as unused in that case)signoz_check_metric_cardinalityReturn label/attribute keys for one metric with cardinality counts and sample values, sorted highest first. Samples help distinguish unbounded values such as UUIDs from bounded dimensions such as status codes. This tool does not show whether the metric is used; call signoz_check_metric_usage before recommending a drop.
metricName (required) - Metric name to inspect. Example: k8s.container.memory_limittimeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '24h', '3d', '7d'; default: '7d'; ignored when both start and end are provided)start/end (optional) - Unix ms timestamps. When both are provided, they override timeRangesignoz_list_alertsLists currently firing/silenced/inhibited alert instances from Alertmanager, not rule definitions. Use signoz_list_alert_rules for configured rules, signoz_get_alert with an id for one full rule definition, or signoz_get_alert_history for the state timeline.
limit (optional) - Maximum number of alerts per page (default: 50)offset (optional) - Number of results to skip for pagination (default: 0)active / silenced / inhibited (optional) - Tri-state filters. Boolean (or the strings "true"/"false"). Omit to defer to the backend default (all states included). An invalid value is rejected rather than silently droppedfilter (optional) - Comma-separated alert-label comparisons using =, !=, =~ (regex), or !~ (negative regex), e.g. alertname="HighCPU",severity="critical"receiver (optional) - Regex to filter alerts by receiver namesignoz_list_alert_rulesLists configured alert-rule summaries from GET /api/v2/rules, including inactive/OK and disabled rules. Use signoz_get_alert for one full definition; use signoz_list_alerts for current Alertmanager instances.
limit (optional) - Maximum number of rules to return per page (default: 50, max: 1000; higher values are clamped)offset (optional) - Number of rules to skip for pagination (default: 0)signoz_get_alertGets one alert rule's full definition (GET /api/v2/rules/{id}). Use signoz_list_alert_rules to discover IDs. Before signoz_update_alert, call this only when a complete current definition is not already available for the prepared operation; reuse a still-current result and preserve unchanged fields.
id (required) - Alert rule ID (UUIDv7 on v2-capable servers).Rule type with createdAt/updatedAt/createdBy/updatedBy; older servers return GettableRule with createAt/updateAt/createBy/updateBy (no 'd').signoz_list_dashboardsLists paginated tenant-dashboard summaries (name, UUID, description, tags, timestamps). Use signoz_get_dashboard for panel and query definitions, and page by raising offset by limit until you have covered total before concluding a dashboard is absent.
limit (default 50), offset (default 0) – offset-based paginationfilter (optional) – server-side filter DSL over dashboard metadata (name, description, tags, creator, timestamps, locked state)sort (optional) – updated_at (default), created_at, or nameorder (optional) – asc or desc (default desc)Only source: user dashboards can be updated, patched, or deleted. source is
not a server-side list-filter column; filter returned rows locally across pages
when needed.
The filter DSL is a boolean expression of key operator value terms and bare free-text words joined with AND/OR/NOT and parentheses (e.g. name CONTAINS 'overview' AND locked = true). Read signoz://dashboard/list-filter-guide for the full grammar, the filterable keys with their operators, value formats, and worked examples; the list response also echoes the authoritative reserved-key set in reservedKeywords.
signoz_get_dashboardGets one known tenant dashboard's complete layout, variables, panels, and queries. Use signoz_list_dashboards to discover the UUID.
id (required) - Dashboard UUIDsignoz_create_dashboardCreates a custom multi-panel dashboard. Use signoz_import_dashboard when a curated template fits, or signoz_create_view to save one Explorer query. Read signoz://dashboard/instructions, signoz://dashboard/widgets-instructions, and signoz://dashboard/widgets-examples before composing the payload.
schemaVersion (required) – Must be "v6"name (DNS-1123 label) or generateName: true to derive it from spec.display.nametags (required) – Array of key/value tags (may be empty)spec (required) – Perses spec: display, variables (array), panels (map keyed by panel id), layouts (array)Static Markdown panels use signoz/TextPanel with queries: [], plus
plugin.spec.mode: "markdown", text, presentation, and headerOptions.
Include the panel's layout reference. Query-bearing panels still require one
query; Text panels do not need a query dry run. Widget examples and patch
instructions include both kinds. Area charts use signoz/AreaChartPanel with
one time_series query; visualization.stack (none, normal, or
percent) stacks grouped series, and chartAppearance.fillMode is solid or
gradient. Dashboard inputs use canonical id; the
legacy uuid input is rejected on the changed dashboard tools.
signoz_import_dashboardCreates a dashboard from a curated template hosted in the SigNoz/dashboards repo (main branch). The server fetches the template JSON and creates the dashboard in one call.
When the relative template path is unknown, call signoz_list_dashboard_templates first. Pass its path, not a URL or absolute path.
path (required) – Template path within the SigNoz/dashboards repo, e.g. hostmetrics/hostmetrics.jsonsignoz_list_dashboard_templatesReturns the full bundled catalog of curated SigNoz dashboard templates as {"templates": [...], "total": N}, where each entry has id, title, path, description, category, and keywords. It does not list dashboards already created in the tenant; use signoz_list_dashboards for those.
signoz_update_dashboardFully replaces an existing dashboard. Fetch it with signoz_get_dashboard, take the data object out of that response, merge only the requested changes into it, and send that object's fields at the top level, preserving every other field. The {status, data} response envelope is not accepted as input. Use signoz_update_view for a saved Explorer query.
id (required) – Dashboard id (the legacy uuid key is also accepted)schemaVersion, name, tags, spec – the complete post-update state (see the tool's JSON Schema)signoz_patch_dashboardApplies an RFC 6902 JSON Patch to a dashboard: a partial update without re-sending the entire dashboard. Prefer this over signoz_update_dashboard for targeted edits (rename, add/edit one panel or query, tweak a variable). Read signoz://dashboard/patch-instructions for worked recipes and exact paths; notably, adding a panel needs two ops (the panel plus its grid item) or it won't render.
id (required) – Dashboard id (the legacy uuid key is also accepted)patch (required) – Array of {op, path, value} operations; paths are JSON Pointers into the dashboard's postable shape, e.g. /spec/display/name, /spec/panels/<panelId>, /spec/layouts/0/spec/items/-, /tags/-signoz_list_servicesLists paginated APM services with trace activity in a time range. Absence means no trace activity in that window, not that the same service.name never appears in logs; use signoz_get_field_values with signal="logs" for log values.
timeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '7d'; defaults to last 6 hours; ignored when both start and end are provided)start (optional) - Start time in unix milliseconds (defaults to 6 hours ago).end (optional) - End time in unix milliseconds (defaults to now)limit (optional) - Maximum services per page (default: 50, max: 1000; higher values are clamped)offset (optional) - Number of results to skip for pagination (default: 0)signoz_get_service_top_operationsGets the built-in operation table for one traced service, ranked by p99 latency with each operation's p50, p95, p99, call count, and error count. Use signoz_aggregate_traces for custom aggregation, grouping, time series, cross-service comparison, or arbitrary trace filters.
service (required) - Exact traced service name, typically from signoz_list_servicestimeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '7d'; defaults to last 6 hours; ignored when both start and end are provided)start (optional) - Start time in unix milliseconds (defaults to 6 hours ago).end (optional) - End time in unix milliseconds (defaults to now)tags (optional) - JSON-encoded TagQueryParam array passed as a string, for example [{"key":"http.method","tagType":"SpanAttribute","operator":"In","stringValues":["GET"]}]; omit for no tag filtersignoz_get_alert_historyGets one configured rule's firing or state-transition history. Defaults to the last 6 hours. Use state and filter to narrow results. For the next page, pass data.nextCursor as cursor and repeat the original filters, time range, and order.
The response is { "status": "success", "data": { "items": [...], "total": <n>, "nextCursor": "<opaque>" } }; nextCursor is omitted on the final page.
id (required) - Alert rule ID from signoz_list_alert_rulestimeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '7d'; defaults to last 6 hours; ignored when both start and end are provided)start (optional) - Start timestamp in unix milliseconds (defaults to 6 hours ago).end (optional) - End timestamp in unix milliseconds (defaults to now)state (optional) - Filter by alert state: inactive, pending, recovering, firing, nodata, or disabled (omit for all transitions)filter (optional) - SigNoz query-builder expression over timeline labels. Combine conditions with AND, OR, and parentheses; quote strings with single quotes. Example: severity = 'critical' AND (team = 'payments' OR service.name = 'checkout'). To discover keys, first call without a filter and inspect data.items[].labels[].key.name. The backend-shaped filterExpression alias remains accepted for compatibility, but filter is canonical.cursor (optional) - Opaque continuation cursor. Repeat the original time range, state, filter, and order when fetching the next page. Omit cursor for the first page.limit (optional) - Rows per page. Default: 20; max: 10000 (higher values are clamped).order (optional) - Sort order. Enum: asc, desc (default: 'asc')offset: no longer supported; use the returned cursor instead.hasMore from data.nextCursor and names the cursor for the next page.signoz_list_viewsList saved Explorer views or discover a view UUID for one Logs, Traces, Metrics, or Cost Meter page. A view stores one reusable Explorer query spec; it is not a multi-panel dashboard. Apply name filters before pagination and follow pagination.nextOffset while pagination.hasMore is true.
source (optional) - Explorer to filter by, for example traces, logs, metrics, or meter (Cost Meter, a distinct Explorer page); SigNoz validates the value. Omit to list views from every Explorername (optional) - Partial-match filter on view name (server-side)limit (optional) - Page size (default: 50, max: 1000; higher values are clamped)offset (optional) - Number of results to skip (default: 0)signoz_get_viewGet one saved Explorer view's complete definition by UUID. Call this before signoz_update_view, which fully replaces the view.
id (required) - Saved view UUIDsignoz_search_docsSearch official SigNoz documentation and return ranked pages with URLs and snippets for product, setup, instrumentation, configuration, API, deployment, or troubleshooting questions. Send 2 to 6 keywords for one topic and keep product and technology names as the user wrote them; split multi-intent questions into separate calls. If the top result is off-topic, retry with fewer or different terms. Do not use for live tenant data; use signoz_fetch_doc for the full content of a selected result or exact docs URL.
searchText (required) - 2 to 6 keywords for one topic, for example "Kubernetes pod logs". Keep product and technology names as the user wrote them.limit (optional) - Maximum results to return as a string (default: 10, max: 25; a numeric value is also accepted). The 25 ceiling is deliberate: each result hydrates document text out of the in-process docs index, so a larger limit inflates this server's resident memory.section_slug (optional) - Exact top-level docs section filter, such as setup, logs-management, apm-distributed-tracing, metrics, alerts, dashboards, signoz-apis, querying, or collection-agents. Reuse the section_slug from an earlier result when narrowing; an unknown slug returns zero resultssearchContext - User's original questionDocs search telemetry counts executed searches in signoz_docs_searches_total with
outcome=ok|error. Only successful searches have result_count_bucket (0, 1-4,
5-9, or 10+). signoz_docs_search_top_score records the top hit's raw Bleve score
only for successful non-empty searches. Scores are uncalibrated and depend on query
terms, boosts, and analyzer settings; they are not relevance probabilities or thresholds.
Search spans record mcp.docs.search_text (the executed query, truncated to 256 Unicode
runes), mcp.docs.section_slug, and mcp.docs.result_count. Successful non-empty searches
also record mcp.docs.top_score. These span attributes distinguish the client's keyword
query from the user's original request in mcp.search_context; query text is not a metric
attribute. If the query is invalid Bleve query-string syntax, search drops that clause,
continues with text matching, and records mcp.docs.query_string_dropped=true. Empty or
whitespace-only queries remain validation errors.
signoz_fetch_docFetch one known official SigNoz docs page's full Markdown or a requested heading. Use signoz_search_docs to discover a page first; accepted inputs are https://signoz.io/docs/... URLs or /docs/... paths.
url (required) - Docs page URL or pathheading (optional) - Heading anchor ID or heading textsearchContext - User's original questionsignoz_create_viewSave one reusable Explorer query spec. Use signoz_create_dashboard for a multi-panel dashboard. Cost Meter views use source="meter" with signal="metrics" and builder-spec source="meter".
name (optional) - View name (DNS-1123 label). Required unless generateName is truegenerateName (optional) - When true, the server generates name from spec.displayName and name must be emptysource (required) - Which Explorer this view belongs to, for example traces, logs, metrics, or meter; SigNoz validates the valuespec (required) - Typed view content: displayName, panelType, requestType, queries, selectedFields, displayschemaVersion (optional) - Always v2; defaults when omittedsignoz://view/instructions and signoz://view/examples before composing any payload.signoz_update_viewFully replace an existing saved Explorer view. Fetch it with signoz_get_view, modify its returned data object, preserve every unrequested field, and pass that full object as view. Upstream keeps name immutable on update; the display label lives in spec.displayName.
id (required) - UUID of the view to replaceview (required) - Full source/spec pair (required); drop name and server-populated fieldssignoz://view/instructions and signoz://view/examples when changing source or spec. Skip them for a pass-through of the fetched body. Call signoz_get_view first; partial bodies wipe unspecified fields.signoz_delete_viewPermanently delete a confirmed saved Explorer view by UUID. Use signoz_list_views to discover the ID; use signoz_delete_dashboard for a dashboard.
id (required) - Saved view UUIDsignoz_aggregate_logsReturn aggregate statistics over logs (counts, rates, averages, percentiles, or grouped/top-N breakdowns) rather than individual records. Use signoz_search_logs for log rows and message inspection.
aggregation (required) - Aggregation function: count, count_distinct, avg, sum, min, max, p50, p75, p90, p95, p99, rateaggregateOn (optional) - Field to aggregate on (required for all except count and rate)groupBy (optional) - Comma-separated fields to group by (e.g., 'service.name, severity_text')filter (optional) - Filter expression using SigNoz search syntax. Combine conditions with AND, OR, and parentheses. Unknown keys hard-error; ambiguous keys default to resource context. Log keys are workspace-specific; even service.name is only present when the log pipeline sets it. See signoz://logs/query-builder-guideservice (optional) - Shortcut filter for service name (adds service.name = '<value>'; fails with key service.name not found when the workspace's logs lack that attribute)severity (optional) - Exact severity_text; DEBUG, INFO, WARN, ERROR, and FATAL are common examples, not an exhaustive enum. Discover values with signoz_get_field_values(signal="logs", name="severity_text", fieldContext="log")orderBy (optional) - Order expression and direction (e.g., 'count() desc')limit (optional) - Maximum number of groups to return (default: 100, max: 10000; higher values are clamped to bound server memory)timeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '24h', '7d'; default: '1h'; ignored when both start and end are provided)start / end (optional) - Start/end time in unix milliseconds. When both are provided, they override timeRange.requestType (optional) - scalar (default; one aggregate value over the whole range) or time_series (one value per time bucket). Unknown values are rejected.stepInterval (optional) - Time bucket size in seconds for time_series mode. Accepts a number or numeric string (backend auto-selects when omitted)missingKeys array in the structured error contentsignoz_search_logsReturn individual paginated log records matching text, service, severity, or field filters. Use signoz_aggregate_logs for counts, trends, or grouped breakdowns.
Calls using only searchText, service, severity, time, or pagination parameters need no guide read. Read signoz://logs/query-builder-guide only before composing filter with unfamiliar workspace fields.
filter (optional) - Filter expression using SigNoz search syntax. Combine conditions with AND, OR, and parentheses (e.g., "(severity_text = 'ERROR' OR body CONTAINS 'panic') AND service.name = 'payment-svc'"). Log keys are workspace-specific; even service.name is only present when the log pipeline sets it. See signoz://logs/query-builder-guideservice (optional) - Service name to filter by (adds service.name = '<value>'; fails with key service.name not found when the workspace's logs lack that attribute)severity (optional) - Exact severity_text; DEBUG, INFO, WARN, ERROR, and FATAL are common examples, not an exhaustive enum. Discover values with signoz_get_field_values(signal="logs", name="severity_text", fieldContext="log")searchText (optional) - Literal text to find, escaped automatically; combines with filter using ANDsearchScope (optional) - Where searchText matches: body (default, body CONTAINS), attribute or resource (keys and values), or all (unscoped search(), slow on wide time ranges)timeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '24h', '7d'; default: '1h'; ignored when both start and end are provided)start / end (optional) - Start/end time in unix milliseconds. When both are provided, they override timeRange.limit (optional) - Maximum number of logs to return (default: 100, max: 10000; higher values are clamped; paginate with offset)offset (optional) - Offset for pagination (default: 0)timestamp desc, then id desc, so offset pagination is deterministic when multiple rows share a timestamp.hasMore (inferred from returnedRows == limit) and the nextOffset to fetch, so a truncated page is never mistaken for the full result setmissingKeys array in the structured error contentUse filter: "search('timeout')" when the field containing a term is unknown.
Use search('checkout', body) to scope it, or combine the function with field
predicates using AND/OR/NOT. Scopes are body, attribute, resource, and
log. Once the field is known, prefer a field predicate. searchText with
searchScope builds these predicates for you. Escape backslashes and apostrophes
inside expression literals; explicit filters are passed through, not rewritten.
The same expressions work in log aggregations and saved-query specs.
signoz_get_field_keysDiscover field names available for filtering or grouping metrics, traces, or logs. This returns keys, not observed values; use signoz_get_field_values after selecting a key. A data.complete of false means SigNoz truncated the key list; narrow with searchText or fieldContext.
signal (required) - Signal type. Enum: metrics, traces, logssearchText (optional) - Filter field keys by name substringmetricName (optional) - Filter by metric name (relevant for metrics signal)fieldContext (optional) - Restrict to a field context. Enum: resource, attribute, scope, log/span/metric (intrinsic columns), body (JSON log body). Use attribute, not the legacy Query Builder context tag, which SigNoz ignores here.fieldDataType (optional) - Restrict to a data type: string, bool, int64, float64, number. An array form like []string is treated as its element type.source (optional) - For metrics, use meter for Cost Meter fields; omit for the default metrics storesignoz_get_field_valuesGet observed values for a known field key. Use signoz_get_field_keys when the key is unknown, and match signal and fieldContext to the query that will use the value. A data.complete of false means SigNoz truncated the value list; narrow with searchText.
signal (required) - Signal type. Enum: metrics, traces, logsname (required) - Field key name to get values for (e.g., service.name, http.method)searchText (optional) - Filter values by substringmetricName (optional) - Filter by metric name (relevant for metrics signal)fieldContext (optional) - Restrict the lookup to a field context (resource, attribute, scope, log/span/metric, body) when the same key name exists in more than one. Use attribute, not the legacy Query Builder context tag; SigNoz returns no values for tag.source (optional) - For metrics, use meter for Cost Meter values; omit for the default metrics storesignoz_search_tracesReturn individual paginated span rows matching service, operation, error, duration, or field filters, and use them to discover trace IDs. Use signoz_aggregate_traces for statistics or signoz_get_trace_details for one known trace.
filter (optional) - Filter expression using SigNoz search syntax. Combine conditions with AND, OR, and parentheses (e.g., "service.name = 'payment-svc' AND (has_error = true OR attribute.http.response.status_code >= 500)"). Legacy query is still accepted for backward compatibility, but filter is canonical. See signoz://traces/query-builder-guideservice (optional) - Service name to filter byoperation (optional) - Operation/span name to filter byerror (optional) - Filter by error status. Boolean (or the strings "true"/"false"). An invalid value is rejected rather than silently droppedminDuration / maxDuration (optional) - Min/max span duration in nanoseconds (e.g., '500000000' for 500ms)timeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '24h', '7d'; default: '1h'; ignored when both start and end are provided)start / end (optional) - Start/end time in unix milliseconds. When both are provided, they override timeRange.limit (optional) - Maximum span rows to return (default: 100, max: 10000; higher values are clamped; paginate with offset)offset (optional) - Number of span rows to skip (default: 0)selectFields (optional) - Extra fields to return on each row, added to the default set. An array of field names or a comma-separated string, at most 50. Names can be span columns (db_name), resource attributes (k8s.pod.name), or span attributes (http.route); a resource., attribute., or span. prefix picks the context. Discover names with signoz_get_field_keys (signal="traces")timestamp, trace_id, span_id, parent_span_id, name, service.name, kind_string, duration_nano, has_error, status_code_string, status_message, response_status_code, and http_method, plus any selectFields. Every field is a flat row key; a field missing from a row was not selectedtimestamp desc.hasMore (inferred from returnedRows == limit) and the nextOffset to fetch, so a truncated page is never mistaken for the full result settrace_id, span_id, duration_nano, has_error). Legacy caller-provided filters such as hasError still pass through to the backend alias layer, but new response parsers should read the canonical snake_case keys.missingKeys array in the structured error contentsignoz_aggregate_tracesReturn custom aggregate statistics over spans (counts, rates, latency percentiles, grouped/top-N breakdowns, or time series) rather than individual rows or a full trace hierarchy. For one traced service's built-in operation table ranked by p99, use signoz_get_service_top_operations. Read signoz://traces/query-builder-guide before calling this tool.
aggregation (required) - Aggregation function: count, count_distinct, avg, sum, min, max, p50, p75, p90, p95, p99, rateaggregateOn (optional) - Field to aggregate on (e.g., 'duration_nano'). Required for all except count and rategroupBy (optional) - Comma-separated fields to group by (e.g., 'service.name, name')filter (optional) - Filter expression using SigNoz search syntax. Combine conditions with AND, OR, and parentheses. Unknown keys hard-error; ambiguous keys default to resource context. See signoz://traces/query-builder-guideservice (optional) - Shortcut filter for service nameoperation (optional) - Shortcut filter for span/operation nameerror (optional) - Shortcut filter for error spans. Boolean (or the strings "true"/"false"). An invalid value is rejected rather than silently droppedorderBy (optional) - Order expression and direction (e.g., 'avg(duration_nano) desc')limit (optional) - Maximum number of groups to return (default: 100, max: 10000; higher values are clamped to bound server memory)timeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '24h', '7d'; default: '1h'; ignored when both start and end are provided)start / end (optional) - Start/end time in unix milliseconds. When both are provided, they override timeRange.requestType (optional) - scalar (default; one aggregate value over the whole range) or time_series (one value per time bucket). Unknown values are rejected.stepInterval (optional) - Time bucket size in seconds for time_series mode. Accepts a number or numeric string (backend auto-selects when omitted)missingKeys array in the structured error contentsignoz_get_trace_detailsFor a known trace ID, return its spans, metadata, and hierarchy. Use signoz_search_traces first when the ID is unknown, and choose a time window that contains the trace; the default last six hours can miss older traces.
traceId (required) - Known trace ID, usually discovered with signoz_search_tracestimeRange (optional) - Relative time range <number><unit> where unit is m/h/d (e.g. '30m', '1h', '6h', '7d'; defaults to last 6 hours; ignored when both start and end are provided)start (optional) - Start time in unix milliseconds (defaults to 6 hours ago).end (optional) - End time in unix milliseconds (defaults to now)includeSpans (optional) - Include detailed span information. Boolean (or the strings "true"/"false"), default: truesignoz_create_alertCreate a new alert rule in SigNoz via POST /api/v2/rules.
ruleType:
threshold_rule / promql_rule → v2alpha1 (structured condition.thresholds, evaluation, notificationSettings).anomaly_rule → v1, metrics only: top-level evalWindow/frequency, condition anomaly fields, and direct top-level preferredChannels. Omit thresholds, evaluation, notificationSettings, and schemaVersion; policy routing is unsupported.signoz_list_notification_channels result only from the same still-current prepared operation; otherwise call it, refreshing only if state may have changed. V2 needs an exact returned displayName on every tier: SigNoz rejects a tier with no channels or a channel name that does not exist, and top-level preferredChannels plays no part in v2 routing. V1 anomaly uses direct top-level preferredChannels. If none fits, ask the user or offer signoz_create_notification_channel with user-provided config; never create automatically. Confirmed v2 policy routing may omit tier channels.signoz://alert/instructions and signoz://alert/examples. For PromQL, read signoz://promql/instructions when needed.signoz_update_alertUpdate an existing alert rule via PUT /api/v2/rules/{id}. This fully replaces the rule: reuse signoz_get_alert, signoz://alert/instructions, signoz://alert/examples, and fully paginated signoz_list_notification_channels results only from the same still-current prepared operation; otherwise read/call them, refreshing only if state may have changed, then preserve unchanged fields. Direct v2 needs an exact listed displayName on every tier; confirmed v2 policy routing may omit them. V1 anomalies use direct top-level preferredChannels and cannot use policy routing.
id (required) - UUIDv7 of the rule to update (obtain from signoz_list_alert_rules / signoz_get_alert).signoz_create_alert).signoz_delete_alertDelete an alert rule via DELETE /api/v2/rules/{id}. Irreversible: discover the ID with signoz_list_alert_rules and confirm the exact rule first. When both steps are already complete, call the delete tool directly without repeating list/get preflight.
id (required) - UUIDv7 of the rule to delete. The server rejects non-UUIDv7 values with invalid_input.signoz_delete_dashboardPermanently delete a confirmed tenant dashboard by ID. The deletion is irreversible; use signoz_list_dashboards to discover the UUID. Use signoz_delete_view for a saved Explorer view.
id (required) - Dashboard UUID to deletesignoz_list_notification_channelsList paginated v2 channel summaries (id, name, displayName, kind, timestamps).
Alert routing uses displayName; name is the immutable machine identifier.
Results omit provider settings and credentials. Use signoz_get_notification_channel
for the complete configuration, and cover every page before declaring a channel absent.
query searches display names; kind filters provider kind;
sort is updated_at, created_at, or name; order is asc or desc.
limit defaults to 20 and is capped at 200; offset defaults to 0.pagination.nextOffset while
pagination.hasMore is true; pagination.limit reports the effective cap.signoz_create_notification_channelCreate a notification channel from config: {kind, spec}. Check existing
display names before creating a channel.
config is required. Supply a DNS1123 name, or use
generateName: true with a displayName. SigNoz defaults displayName from
an explicit name when omitted. Both names become immutable after creation.
Alert routing references use displayName, not name.slack, email, webhook, pagerduty,
opsgenie, msteams, googlechat, jira, jsmops, and incidentio;
SigNoz validates the value and its rejection lists the kinds it accepts.
SigNoz also rejects an unknown or missing config.spec field with the exact
requirement, and a duplicate name with already-exists. Slack also accepts
message settings: color, titleLink, pretext, fallback, footer,
fields, and actions.config.spec.sendResolved uses the provider's
default when omitted. Get returns its effective value; preserve it on update.test defaults to false. Set test: true only when a test
notification is intended. A failed test does not undo the created channel;
inspect its reported status before retrying. Post-write authorization errors
include mutationCommitted: true and the known ID so callers can authenticate
and inspect the existing channel without creating another one.Example without a test send:
{
"name": "checkout-oncall",
"displayName": "Checkout on-call",
"config": {
"kind": "webhook",
"spec": {"url": "https://alerts.example.com/signoz", "sendResolved": true}
},
"test": false
}
signoz_update_notification_channelFully replace one channel's config using id and the complete canonical
config: {kind, spec} object. Fetch the channel, copy its config, change only
requested fields, then submit the complete object. Names cannot be changed.
Preserve every untouched setting and credential without echoing secrets. A
fetched config is writable as-is; to unset an optional field, omit it, because
SigNoz rejects an empty string for template-backed fields such as titles and
messages.
test defaults to false; an explicit true sends a test after the update.
A test failure does not undo the update. Do not replay an ambiguous write or
an opt-in test automatically.
signoz_get_notification_channelGet one channel's canonical id, machine name, displayName, timestamps,
and full config. The config.spec can contain plaintext credentials; use it
for updates without displaying or logging secrets. Parameter: id.
signoz_delete_notification_channelPermanently delete a confirmed channel by id. Resolve and confirm the exact
channel first; call directly when those steps are already complete. The backend
may reject deletion while a routing policy references the channel. Propagate
that dependency error and resolve references before retrying.
signoz_execute_builder_queryRuns a SigNoz Query Builder v5 request that the dedicated tools cannot express, including multi-query requests, formulas, PromQL, and ClickHouse SQL. Prefer signoz_search_logs / signoz_search_traces for rows, signoz_aggregate_logs / signoz_aggregate_traces for grouped results, and signoz_query_metrics for ordinary metrics.
query (required) - Complete SigNoz Query Builder v5 JSON objectcompositeQuery.queries[i].type selects the spec shape:
builder_query: signal-specific spec (logs/traces/metrics) with filter, aggregations, groupBy, etc.builder_formula: formula expression referencing other query names (e.g. A / B * 100).promql: {name, query, disabled, step?, legend?}. PromQL for OTel metrics requires the Prometheus 3.x UTF-8 quoted-selector form {"metric.name.with.dots"}; read the signoz://promql/instructions resource for details.clickhouse_sql: {name, query, disabled, legend?}.spec.limit and non-empty v5 spec.order (not dashboard/editor orderBy) on every builder_query and builder_formula. When omitted, null, or zero, standalone limits and formula-result limits default to 100; a builder query referenced by a formula defaults to 10000 because base-query limits are applied before formula evaluation. Raw logs order by timestamp desc, id desc; raw traces by timestamp desc; metric scalar/time-series queries and formulas by __result desc; and log/trace scalar/time-series queries by the primary aggregation descending. Caller-supplied values are forwarded unchanged. The response appends a decisions note when defaults are inserted.requestType has no default (raw, trace, time_series, or scalar), and start and end are required Unix-millisecond timestamps.signoz://logs/query-builder-guide for logs, signoz://traces/query-builder-guide for traces, signoz://metrics-aggregation-guide for metrics/formulas, and signoz://promql/instructions for PromQL.missingKeys array in the structured error contentMCP Server for SigNoz
{ "mcpServers": { "signoz-signoz-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "docker.io/signoz/signoz-mcp-server:v0.19.0" ] } }}Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
Signoz yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-11-17. MCP Server for SigNoz