CHANGELOG.md

Changelog

All notable changes to the SigNoz MCP Server will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.11.0 - 2026-08-05

Added

• capture failed MCP requests (#276)
• add organization overview and auth recovery (#267)

Fixed

• support policy routing and preflight reuse (#264)

0.10.0 - 2026-07-27

Changed

• Breaking change: dashboard tools now use the v2 Perses APIs and require SigNoz v0.135.0 or later (#260)

Documentation

• streamline CLAUDE.md and extract plan templates (#258)

Other

• bump google.golang.org/grpc from 1.79.3 to 1.82.1 (#259)

0.9.0 - 2026-07-22

Added

• add tier 1 MCP contract guardrails (#249)
• accurate MCP tool annotations — explicit readOnly/destructive/idempotent triples with pinned inventory test (#245)
• add key-not-found recovery guidance and missingKeys error field (#244)
• add explicit limits and ordering (#241)

Fixed

• code tool error results (#256)
• enforce wire-contract budgets (#247)
• classify expired-workspace 404s as permanent instance-not-found errors (#243)
• stop logging expected subscribe rejections and client cancellations at ERROR (#242)
• align service version across signals (#240)

Changed

• clarify full catalog metadata (#248)

Documentation

• add best-practices guide (#255)

Other

• add Inspector protocol CI (#254)
• pre-release v0.8.0 (#239)

0.8.0 - 2026-07-15

Added

• migrate get_alert_history to v2 rule-history API (#235)
• upgrade mcp-go to v0.56.0 with shadow-mode schema validation (#231)

Fixed

• align MCP telemetry and OAuth guidance (#237)
• deduplicate docs corpus and improve ranking (#233)

0.7.0 - 2026-07-07

Added

• add signoz_check_metric_cardinality tool (#208)
• add signoz_check_metric_usage tool (#205)

Fixed

• classify upstream authz errors (#227)
• migrate trace fields to snake_case (#225)

Other

• bump golang.org/x/net from 0.51.0 to 0.55.0 (#228)

0.6.0 - 2026-06-25

Added

• resolve K1-K5 — units, window, limit, requestType, id naming (Family E, #366) (#221)
• harmonize param schema, types & descriptions (Family D, #367) (#220)
• JSON-first output + structuredContent + error codes (Family C, #365) (#219)
• fix silent-failures across read/write tools (Family A, #363) (#217)
• add signoz_get_top_metrics tool for ingestion cost analysis (#196)
• add per-row webUrl deep links to signoz_search_traces (#206)

Fixed

• emit VALIDATION_FAILED on remaining read-tool validation paths (#222)
• honor ingress header for user/session tokens (#223)
• author typed-struct field descriptions in the native jsonschema tag (#214)
• standardize filter-expression param on filter (accept legacy query alias) (#213)
• prevent nil-Arguments panic in MCP tool handlers (#207)

Changed

• converge error/validation strings onto shared helpers (Family B, #364) (#218)

Documentation

• add agent-skills sync check and Git/PR conventions to CLAUDE.md (#215)

CI

• auto-publish server.json to the MCP Registry on release (#209)

0.5.1 - 2026-06-17

Other

• [codex] Align docs tool registration parity (#203)
• post-release v0.5.0 (#202)

0.5.0 - 2026-06-16

Added

• add webUrl resource deep links to tool outputs (#197)

Fixed

• file Cost Meter saved views under sourcePage "meter" (#200)

Other

• [codex] Add instant API key help tooltip (#198)

0.4.1 - 2026-05-20

Fixed

• preserve PromQL & ClickHouse SQL queries through typed round-trip (#180)

0.4.0 - 2026-05-13

Added

• tag MCP traffic with assistant correlation headers (#167)
• add signoz_create_dashboard_from_template MCP tool (#157)
• add signoz_search_docs and signoz_fetch_doc MCP tools (#143)

Fixed

• omit null tags and drop unused category filter (#166)
• parse having expression strings into clause arrays (#160)

Documentation

• track plan files for assistant-correlation-headers + correct CLAUDE.md (#168)
• clarify threshold format and operator constraints (#164)
• document alert rule version floor (#156)

CI

• add workflow to refresh bundled dashboard template catalog (#161)

Other

• improve MCP auth failure telemetry (#170)
• [codex] Fix OAuth auth form URL normalization (#165)
• Accept notification channel UUIDs in MCP tools (#163)
• refresh bundled dashboard template catalog (#162)

0.3.0 - 2026-04-28

Added

• normalize GET/write shape quirks and reject filter i… (#144)
• add OTel dotted-name guidance and generalize the resour… (#142)
• migrate to v2 rules API and refresh schema per SigNoz P… (#140)
• add CRUD MCP tools for saved explorer views (#138)

Changed

• Self-hosted SigNoz users must run SigNoz v0.120.0 or newer for alert rule tools that use the /api/v2/rules APIs.

Fixed

• accept typed-slice filter items in normalizers and co… (#148)

Other

• [codex] Expose searchContext in MCP schemas (#150)
• [codex] add alert rules listing tool (#147)
• [codex] fix internal otel exporter defaults (#149)
• [codex] Fix timestamp precedence over timeRange (#146)
• [codex] Normalize advertised MCP tool schemas (#145)
• enrich tool-call observability with protocol version, error type, and result size (#141)

0.2.1 - 2026-04-21

Added

• move to slog + pkg/otel + custom meters (#137)
• attach name on analytics identity events (#134)

CI

• bump version pre-release instead of after publish (#132)

Other

• bump google.golang.org/grpc from 1.79.2 to 1.79.3 (#71)
• bump github.com/buger/jsonparser from 1.1.1 to 1.1.2 (#76)
• bump go.opentelemetry.io/otel/sdk from 1.42.0 to 1.43.0 (#111)
• Add CONTRIBUTING/CLAUDE docs, update README and manifest for new MCP tools (#135)
• Align analytics identity tracking (#131)
• post-release v0.2.0 (#130)

0.2.0 - 2026-04-18

Added

• support custom HTTP headers via SIGNOZ_CUSTOM_HEADERS env var (#129)
• validate notification channels before creating alerts (#128)
• add signoz_create_alert MCP tool with v2 schema validation (#123)
• add signoz_list_notification_channels MCP tool (#126)
• add signoz_update_notification_channel MCP tool (#125)
• add signoz_create_notification_channel MCP tool (#124)
• add signoz_delete_dashboard MCP tool (#122)
• add dashboard validation pipeline with builder and panel validator (#121)
• add Segment analytics for session and tool call tracking (#120)
• add OTel GenAI semantic instrumentation and standardize log att… (#116)

Other

• post-release v0.1.2 (#114)
• improve logs (#115)

0.1.2 - 2026-04-09

Fixed

• use service account endpoint for API key validation (#112)

Other

• simplify MCP link guidance and goimports setup (#109)
• add signoz cloud setup to readme (#107)
• bump version to v0.1.0 and update manifest (#106)

0.1.0 - 2026-03-25

Deprecated

• Authorization: Bearer <key> header for API key authentication. Use the SIGNOZ-API-KEY header instead. The Authorization header will stop working in the next release. (#86)

Added

• JWT token support and SIGNOZ-API-KEY header for authentication (#86)
• Stateless OAuth 2.1 authentication for MCP clients (#84)
• searchContext param and session ID enrichment for logs (#103)
• State filter param for signoz_get_alert_history tool (#100)
• Server-side filtering params for signoz_list_alerts tool (#99)
• signoz_query_metrics tool with smart aggregation defaults (#88)
• Consolidated metrics tools and generic field discovery tools (#85)
• Filter support for signoz_get_trace_error_analysis (#80)
• signoz_execute_builder_query docs as MCP resource (#79)
• Prompts, resource templates, hooks, and retry with backoff (#95)
• selectFields for spans (#74)
• Handler unit tests, mock client, and integration tests (#96)

Fixed

• Set destructiveHint=false on all read-only tools (#102)
• Remove selectFields params in logs (#72)
• Remove hardcoded scalar resultType from trace and logs aggregate tools (#82)

Changed

• Remove signoz_get_logs_for_alert tool (#104)
• Merge redundant tools (26 → 22) (#92)
• Split handler.go, add Client interface and middleware (#94)
• Add tool annotations, extract doRequest helper, name constants (#93)
• Delegate step interval to backend and enhance server instructions (#97)
• Clarify signal before querying if not clear (#91)
• Enhance context handling for API key and SigNoz URL in middleware (#63)
• Feature brainstorming and CLAUDE.md (#87)

Documentation

• Add jsonschema description for legend field (#83)
• Update SIGNOZ_URL example in README for clarity (#57)

CI

• Split builds of binary and docker (#78)
• Add main branch to build workflow triggers (#77)
• Push images to GCP repository (#75)

0.0.5 - 2026-02-20

Added

• Aggregate logs and generic log search tools (#54)
• Support for getting real metrics/logs/trace fields and options
• Create and update dashboard tools (#43)
• SigNoz MCP Server as Claude Desktop extension (#33)
• server.json for MCP registry (#47)

Fixed

• Allow time_series aggregations for logs (#55)
• Trim trailing slashes from SIGNOZ_URL to prevent double-slash issues (#50)

Changed

• Prefix all tool names with signoz_ (#48)

0.0.4 - 2025-11-10

Added

• Pagination support for client (#44)

Fixed

• Query builder for metrics (#45)
• Golang CI lint issues (#46)

0.0.3 - 2025-10-31

Fixed

• Metric search by text (#42)

Changed

• Address community feedback (#41)

0.0.2 - 2025-10-24

Changed

• Add MCP registry label (#39)

CI

• Add Docker build workflow (#38)
• Add additional CI workflows (#37)
• Fix id-token permission (#40)

0.0.1 - 2025-10-23

Added

• Initial release of SigNoz MCP Server
• Query builder tool for metrics, logs, and traces
• Alert listing and alert history tools
• Log search and error log tools
• Trace search, detail, error analysis, and span hierarchy tools
• Service listing and top operations tools
• Dashboard listing and retrieval tools
• Saved log views listing and retrieval
• HTTP transport support for remote MCP server
• API key authentication via Authorization header
• Enhanced time input handling for LLM-to-API calls
• LLM-friendly error messages and logging

CI

• Primus workflow for publishing artifacts