@withpica/mcp-server 2.87.0 → 2.88.1

package/CHANGELOG.md

@@ -11,6 +11,47 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.88.1] - 2026-07-04
+
+### Added
+
+- `TEMPLATE_RENDER_FAILED` recovery hint for `pica_agreements_create_from_template`
+  — the backing route now returns a typed 400 (bad `template_id` / missing
+  required variables) instead of a generic 500, so the tool surfaces an
+  actionable next step (query templates via `pica_agreement_types_query`).
+
+### Removed
+
+- `expires_in_days` on `pica_agreements_create_from_template` (it was a
+  documented no-op). A draft has no signing window; set the expiry at
+  `pica_agreements_send_for_signature`, which keeps its own `expires_in_days`.
+
+## [2.88.0] - 2026-07-04
+
+### Added
+
+- `pica_agreements_create_from_template` — the missing entry point of the
+  e-signature flow. `pica_agreements_send_for_signature` (ADR-289 Wave A)
+  could email a draft agreement's required signers, but no tool could
+  create that draft WITH `required_signers` set — the backing route,
+  `POST /admin/agreements/create-from-template`, was the only API path that
+  accepts it, and had no MCP tool at all. Renders an agreement template
+  against real variables and creates the resulting agreement in `draft`
+  status; success message names the agreement id, points at
+  `/inspect/agreements/<id>`, and recommends
+  `pica_agreements_send_for_signature` as the next step.
+
+### Changed
+
+- MCP discoverability wave (ADR-289 follow-up): reworked `pica_discover`
+  ranking so the right tool wins each query class — importing a
+  Spotify/ISRC link now routes to `pica_import_streaming_link`, and money
+  questions route to the tool that actually answers them. Added a
+  `pica_discover` query filter and surfaced gate visibility in
+  `pica_tool_details`; rewrote the 15 worst tool descriptions with jargon
+  glosses; swept stale copy (real tool count, free-runway language); purged
+  phantom tool-name references and added a lint that blocks them permanently.
+
 ## [2.87.0] - 2026-07-04
 
 ### Added