Skip to content

0.3.0 / 2026-11-17

Latest

Choose a tag to compare

@github-actions github-actions released this 17 Nov 14:47
v0.3.0
e16a85b

Welcome to the v0.3.0 release!

This release is about helping LLMs do more with Perses, while using fewer tokens and making fewer mistakes.

The highlight is a new set of Prometheus tools. Instead of calling the Prometheus API through the raw datasource proxy, the LLM can now discover the metric names, the label names and values, and the metadata of the metrics, then run a PromQL query and get a compact result: the value of each series for an instant query, and statistics per series (min, max, avg, last...) for a range query. For example, a range query over 6 hours returning 61 series is now about 3 KB instead of 240 KB. The MCP server also sends instructions to the MCP clients explaining how to combine these tools.

On the dashboard side, reading a dashboard returns a compact outline by default, and three new tools edit the panels, the variables or the layout of a dashboard without sending the complete dashboard again. To write valid dashboards, the LLM can also read the CUE schemas of the plugins installed in Perses, and validate a dashboard or a variable without saving it. Finally, Grafana dashboards can be migrated to Perses.

Except for the dashboard edit tools, all the new tools are read-only and stay available in read-only mode. They belong to four new resources, prometheus, schema, validate and migrate: if you restrict the tools with resources, add them to your configuration to use these tools.

This release also comes with breaking changes in the dashboard tools and in the datasource query tools. If your prompts, scripts or agents rely on their parameters or their responses, please read the [BREAKINGCHANGE] entries below.

The MCP server now has its own documentation, covering the installation, the setup of the MCP clients, the deployment, the configuration and all the tools.

  • [FEATURE] Add the resource migrate with the tool perses_migrate_dashboard to convert a Grafana dashboard into a Perses dashboard. When the MCP client supports elicitation, the user chooses whether to keep the datasources of the Grafana dashboard or to use the default datasource of Perses (#104)
  • [FEATURE] Add the resource schema with the tools perses_list_plugin_schemas and perses_get_plugin_schema to get the CUE schemas of the plugins installed in Perses. Requires Perses v0.55 or later (#114)
  • [FEATURE] Add the resource validate with the tools perses_validate_dashboard and perses_validate_variable to validate a resource without saving it (#115)
  • [FEATURE] Add the tools perses_set_dashboard_panels, perses_set_dashboard_variables and perses_set_dashboard_layout to add, replace or remove panels, variables or panel groups without sending the complete dashboard (#118)
  • [FEATURE] Add the resource prometheus with the tools perses_list_prometheus_metric_names, perses_list_prometheus_label_names, perses_list_prometheus_label_values, perses_get_prometheus_metric_metadata and perses_query_prometheus to discover and query the metrics of the Prometheus datasources with compact results (#135)
  • [FEATURE] Send instructions to the MCP clients on how to combine the tools, in particular the Prometheus ones. They only mention the registered tools (#136)
  • [ENHANCEMENT] perses_create_dashboard and perses_update_dashboard: add dry_run to validate the dashboard without saving it, and expected_version (update only) to detect a dashboard modified in the meantime (#117)
  • [ENHANCEMENT] Tool responses no longer escape <, > and &, so PromQL queries are returned as written (#131)
  • [BUGFIX] Docker images: expose the port 8000 used by the HTTP transport instead of 8080 (#110)
  • [BUGFIX] perses_create_project: accept descriptions with spaces (#111)
  • [BUGFIX] perses_create_project_variable: set the value of the variable with the new parameter value, instead of the name of the variable (#112)
  • [BUGFIX] Return a tool error instead of crashing the MCP server when a tool panics (#132)
  • [BUGFIX] Exit with the status code 1 when the MCP transport fails, for example when the HTTP address is already in use (#133)
  • [BREAKINGCHANGE] perses_create_dashboard and perses_update_dashboard: the parameter dashboard is a JSON object instead of a JSON string, and the response is a short summary instead of the saved dashboard. Set include_dashboard: true to get the saved dashboard (#117)
  • [BREAKINGCHANGE] perses_get_dashboard_by_name returns an outline of the dashboard by default: set summary: false to get the complete dashboard, or panels to get only some panels. perses_list_dashboards returns a summary of each dashboard instead of the complete dashboards (#117)
  • [BREAKINGCHANGE] perses_query_project_datasource and perses_query_global_datasource return the response body of the datasource unchanged, instead of the object {status_code, headers, body}. An HTTP error status is now returned as a tool error (#126)
  • [DOC] Add the documentation of the MCP server (overview, installation, MCP clients, deployment, configuration and tools) and fix the configuration example of the README (#109)

What's Changed

  • build(deps): Bump the gomod group across 1 directory with 2 updates by @dependabot[bot] in #101
  • build(deps): Bump the gomod group with 2 updates by @dependabot[bot] in #102
  • [FEATURE]: Add dashboard migration tool with elicitation support by @ibakshay in #104
  • ci: bump golangci-lint to v2.14.0 and fix deprecated MCP server options by @ibakshay in #106
  • build(deps): Bump perses/github-actions from 0.12.0 to 0.13.0 in the actions group across 1 directory by @dependabot[bot] in #103
  • build(deps): Bump the gomod group across 1 directory with 2 updates by @dependabot[bot] in #105
  • [IGNORE] bump perses/spec and perses/perses by @Nexucis in #108
  • [DOC] Add the documentation of the MCP server by @Nexucis in #109
  • [BUGFIX] Docker images: expose the port 8000 used by the HTTP transport by @Nexucis in #110
  • [BUGFIX] perses_create_project: accept descriptions with spaces by @Nexucis in #111
  • [BUGFIX] perses_create_project_variable: set the value of the variable by @Nexucis in #112
  • fix(datasource): return the datasource response body unchanged from query tools by @ibakshay in #126
  • Use shared helpers to build tool results by @ibakshay in #131
  • feat: add plugin schema tools by @ibakshay in #114
  • build(deps): Bump github.com/perses/common from 0.31.2 to 0.32.0 in the gomod group by @dependabot[bot] in #133
  • feat: add dashboard and variable validation tools by @ibakshay in #115
  • [IGNORE] bump perses/common to v0.33.0 by @Nexucis in #134
  • fix(server): turn panics in tool handlers into tool errors by @ibakshay in #132
  • feat: compact dashboard reads and safer create/update by @ibakshay in #117
  • feat(dashboard): add incremental dashboard edit tools by @ibakshay in #118
  • [FEATURE] add Prometheus discovery and query tools by @ibakshay in #135
  • [FEATURE] add server instructions by @ibakshay in #136

Full Changelog: v0.2.0...v0.3.0