# Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).







## [0.4.1] - 2026-05-20

### Fixed
- preserve PromQL & ClickHouse SQL queries through typed round-trip ([#180](https://github.com/SigNoz/signoz-mcp-server/pull/180))

## [0.4.0] - 2026-05-13

### Added
- tag MCP traffic with assistant correlation headers ([#167](https://github.com/SigNoz/signoz-mcp-server/pull/167))
- add signoz_create_dashboard_from_template MCP tool ([#157](https://github.com/SigNoz/signoz-mcp-server/pull/157))
- add signoz_search_docs and signoz_fetch_doc MCP tools ([#143](https://github.com/SigNoz/signoz-mcp-server/pull/143))

### Fixed
- omit null tags and drop unused category filter ([#166](https://github.com/SigNoz/signoz-mcp-server/pull/166))
- parse having expression strings into clause arrays ([#160](https://github.com/SigNoz/signoz-mcp-server/pull/160))

### Documentation
- track plan files for assistant-correlation-headers + correct CLAUDE.md ([#168](https://github.com/SigNoz/signoz-mcp-server/pull/168))
- clarify threshold format and operator constraints ([#164](https://github.com/SigNoz/signoz-mcp-server/pull/164))
- document alert rule version floor ([#156](https://github.com/SigNoz/signoz-mcp-server/pull/156))

### CI
- add workflow to refresh bundled dashboard template catalog ([#161](https://github.com/SigNoz/signoz-mcp-server/pull/161))

### Other
- improve MCP auth failure telemetry ([#170](https://github.com/SigNoz/signoz-mcp-server/pull/170))
- [codex] Fix OAuth auth form URL normalization ([#165](https://github.com/SigNoz/signoz-mcp-server/pull/165))
- Accept notification channel UUIDs in MCP tools ([#163](https://github.com/SigNoz/signoz-mcp-server/pull/163))
- refresh bundled dashboard template catalog ([#162](https://github.com/SigNoz/signoz-mcp-server/pull/162))

## [0.3.0] - 2026-04-28

### Added
- normalize GET/write shape quirks and reject filter i… ([#144](https://github.com/SigNoz/signoz-mcp-server/pull/144))
- add OTel dotted-name guidance and generalize the resour… ([#142](https://github.com/SigNoz/signoz-mcp-server/pull/142))
- migrate to v2 rules API and refresh schema per SigNoz P… ([#140](https://github.com/SigNoz/signoz-mcp-server/pull/140))
- add CRUD MCP tools for saved explorer views ([#138](https://github.com/SigNoz/signoz-mcp-server/pull/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](https://github.com/SigNoz/signoz-mcp-server/pull/148))

### Other
- [codex] Expose searchContext in MCP schemas ([#150](https://github.com/SigNoz/signoz-mcp-server/pull/150))
- [codex] add alert rules listing tool ([#147](https://github.com/SigNoz/signoz-mcp-server/pull/147))
- [codex] fix internal otel exporter defaults ([#149](https://github.com/SigNoz/signoz-mcp-server/pull/149))
- [codex] Fix timestamp precedence over timeRange ([#146](https://github.com/SigNoz/signoz-mcp-server/pull/146))
- [codex] Normalize advertised MCP tool schemas ([#145](https://github.com/SigNoz/signoz-mcp-server/pull/145))
- enrich tool-call observability with protocol version, error type, and result size ([#141](https://github.com/SigNoz/signoz-mcp-server/pull/141))

## [0.2.1] - 2026-04-21

### Added
- move to slog + pkg/otel + custom meters ([#137](https://github.com/SigNoz/signoz-mcp-server/pull/137))
- attach name on analytics identity events ([#134](https://github.com/SigNoz/signoz-mcp-server/pull/134))

### CI
- bump version pre-release instead of after publish ([#132](https://github.com/SigNoz/signoz-mcp-server/pull/132))

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

## [0.2.0] - 2026-04-18

### Added
- support custom HTTP headers via SIGNOZ_CUSTOM_HEADERS env var ([#129](https://github.com/SigNoz/signoz-mcp-server/pull/129))
- validate notification channels before creating alerts ([#128](https://github.com/SigNoz/signoz-mcp-server/pull/128))
- add signoz_create_alert MCP tool with v2 schema validation ([#123](https://github.com/SigNoz/signoz-mcp-server/pull/123))
- add signoz_list_notification_channels MCP tool ([#126](https://github.com/SigNoz/signoz-mcp-server/pull/126))
- add signoz_update_notification_channel MCP tool ([#125](https://github.com/SigNoz/signoz-mcp-server/pull/125))
- add signoz_create_notification_channel MCP tool ([#124](https://github.com/SigNoz/signoz-mcp-server/pull/124))
- add signoz_delete_dashboard MCP tool ([#122](https://github.com/SigNoz/signoz-mcp-server/pull/122))
- add dashboard validation pipeline with builder and panel validator ([#121](https://github.com/SigNoz/signoz-mcp-server/pull/121))
- add Segment analytics for session and tool call tracking ([#120](https://github.com/SigNoz/signoz-mcp-server/pull/120))
- add OTel GenAI semantic instrumentation and standardize log att… ([#116](https://github.com/SigNoz/signoz-mcp-server/pull/116))

### Other
- post-release v0.1.2 ([#114](https://github.com/SigNoz/signoz-mcp-server/pull/114))
- improve logs ([#115](https://github.com/SigNoz/signoz-mcp-server/pull/115))

## [0.1.2] - 2026-04-09

### Fixed
- use service account endpoint for API key validation ([#112](https://github.com/SigNoz/signoz-mcp-server/pull/112))

### Other
- simplify MCP link guidance and goimports setup ([#109](https://github.com/SigNoz/signoz-mcp-server/pull/109))
- add signoz cloud setup to readme ([#107](https://github.com/SigNoz/signoz-mcp-server/pull/107))
- bump version to v0.1.0 and update manifest ([#106](https://github.com/SigNoz/signoz-mcp-server/pull/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](https://github.com/SigNoz/signoz-mcp-server/pull/86))

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

### Fixed
- Set `destructiveHint=false` on all read-only tools ([#102](https://github.com/SigNoz/signoz-mcp-server/pull/102))
- Remove `selectFields` params in logs ([#72](https://github.com/SigNoz/signoz-mcp-server/pull/72))
- Remove hardcoded `scalar` resultType from trace and logs aggregate tools ([#82](https://github.com/SigNoz/signoz-mcp-server/pull/82))

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

### Documentation
- Add jsonschema description for legend field ([#83](https://github.com/SigNoz/signoz-mcp-server/pull/83))
- Update `SIGNOZ_URL` example in README for clarity ([#57](https://github.com/SigNoz/signoz-mcp-server/pull/57))

### CI
- Split builds of binary and docker ([#78](https://github.com/SigNoz/signoz-mcp-server/pull/78))
- Add main branch to build workflow triggers ([#77](https://github.com/SigNoz/signoz-mcp-server/pull/77))
- Push images to GCP repository ([#75](https://github.com/SigNoz/signoz-mcp-server/pull/75))

## [0.0.5] - 2026-02-20

### Added
- Aggregate logs and generic log search tools ([#54](https://github.com/SigNoz/signoz-mcp-server/pull/54))
- Support for getting real metrics/logs/trace fields and options
- Create and update dashboard tools ([#43](https://github.com/SigNoz/signoz-mcp-server/pull/43))
- SigNoz MCP Server as Claude Desktop extension ([#33](https://github.com/SigNoz/signoz-mcp-server/pull/33))
- `server.json` for MCP registry ([#47](https://github.com/SigNoz/signoz-mcp-server/pull/47))

### Fixed
- Allow `time_series` aggregations for logs ([#55](https://github.com/SigNoz/signoz-mcp-server/pull/55))
- Trim trailing slashes from `SIGNOZ_URL` to prevent double-slash issues ([#50](https://github.com/SigNoz/signoz-mcp-server/pull/50))

### Changed
- Prefix all tool names with `signoz_` ([#48](https://github.com/SigNoz/signoz-mcp-server/pull/48))

## [0.0.4] - 2025-11-10

### Added
- Pagination support for client ([#44](https://github.com/SigNoz/signoz-mcp-server/pull/44))

### Fixed
- Query builder for metrics ([#45](https://github.com/SigNoz/signoz-mcp-server/pull/45))
- Golang CI lint issues ([#46](https://github.com/SigNoz/signoz-mcp-server/pull/46))

## [0.0.3] - 2025-10-31

### Fixed
- Metric search by text ([#42](https://github.com/SigNoz/signoz-mcp-server/pull/42))

### Changed
- Address community feedback ([#41](https://github.com/SigNoz/signoz-mcp-server/pull/41))

## [0.0.2] - 2025-10-24

### Changed
- Add MCP registry label ([#39](https://github.com/SigNoz/signoz-mcp-server/pull/39))

### CI
- Add Docker build workflow ([#38](https://github.com/SigNoz/signoz-mcp-server/pull/38))
- Add additional CI workflows ([#37](https://github.com/SigNoz/signoz-mcp-server/pull/37))
- Fix id-token permission ([#40](https://github.com/SigNoz/signoz-mcp-server/pull/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

[0.1.0]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.0.5...v0.1.0
[0.0.5]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.0.4...v0.0.5
[0.0.4]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.0.3...v0.0.4
[0.0.3]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.0.2...v0.0.3
[0.0.2]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.0.1...v0.0.2
[0.0.1]: https://github.com/SigNoz/signoz-mcp-server/releases/tag/v0.0.1
[0.1.2]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.1.0...v0.1.2
[0.2.0]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.1.2...v0.2.0
[0.2.1]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.2.0...v0.2.1
[0.3.0]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.2.1...v0.3.0
[0.4.0]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.3.0...v0.4.0
[0.4.1]: https://github.com/SigNoz/signoz-mcp-server/compare/v0.4.0...v0.4.1
