Sourced from @storybook/addon-mcp's changelog.
0.7.0
Minor Changes
#357
4a19151Thanks@kasperpeulen! - Added thedisplay-reviewtool. The agent pushes a curated review of current changes and returns the review-page URL. Pairs with the@storybook/addon-reviewStorybook addon.#357
4a19151Thanks@kasperpeulen! - Add theget-stories-by-componenttool. Maps component source files to the stories that render them via Storybook's live reverse dependency graph, returning grounded story IDs ranked by import distance. Also hardens change detection:get-changed-storiesnow surfaces working-tree files that are unreachable from any story, and story-index resolution and reverse-graph lookups are normalized for cross-platform (Windows) path handling.#357
4a19151Thanks@kasperpeulen! - Introduced theget-changed-storiestool to retrieve metadata for stories marked as new, modified, or affected. Updateddev-instructions.mdandstorybook-story-instructions.mdto reflect the new workflow for callingget-changed-storiesbeforepreview-stories.#357
4a19151Thanks@kasperpeulen! - Enabled the review workflow by default for thestorybook aiCLI channel (the Claude/Codex plugins). Requests carrying the trusted local-client header getdisplay-reviewand the review instructions without settingexperimentalReview; direct MCP clients keep the opt-in flag, andexperimentalReview: falseturns review off for both channels.#357
4a19151Thanks@kasperpeulen! - Add an optional MCP endpoint setting for the addon dev server.#357
4a19151Thanks@kasperpeulen! - Make the review tooling opt-in via the newexperimentalReviewfeature flag. Previouslydisplay-review(and the review-mode behavior ofpreview-stories/get-changed-stories) was enabled whenever thechangeDetectionfeature flag was on — which is Storybook's default. Now review requires explicitly enablingfeatures.experimentalReviewin.storybook/main.ts(on top ofchangeDetection), so change detection stays on by default while review ships disabled by default.With the flag off, the server instructions are byte-identical to the previous release; the review-flavored instructions are only served with the flag on.
#357
4a19151Thanks@kasperpeulen! - Expose serverless Storybook AI metadata from addon-mcp presets. The new preset returns MCP-shaped instructions and tool descriptors, plus a localget-storybook-story-instructionsrunner that shares the same builders as the live MCP server.#357
4a19151Thanks@kasperpeulen! - Support v0 (inline) and v1 (split/ref) Storybook manifest formats.@storybook/mcpfollows$refpointers into siblingservices/payloads for static and remote sources;@storybook/addon-mcpadds an in-process manifest provider forexperimentalDocgenServerdev mode and fixes composition so local docgen-server and remote v0/v1 composed sources all work.Patch Changes
#359
4eb4a2eThanks@huang-julien! - Add a schema description to thecollectionsargument of thedisplay-reviewtool. The field now documents that collections are groups of stories to show in the review, ordered most-relevant-first, with a preferred 2-5 range. Previously it carried no description, so MCP clients and thestorybook ai display-reviewhelp had no guidance on the argument's shape or intent.#357
4a19151Thanks@kasperpeulen! - Make display-review the single ending for visual work: the after-change instruction step now feeds story discovery into the review instead of ending at preview URLs, preview-stories is framed as a mid-loop tool, the "or you skipped it" escape is removed (non-visual changes say so plainly instead of listing links), and get-changed-stories results append a "publish the review now" next-step hint when review is enabled. Fixes agents completing visual changes but handing back preview links instead of the review.The preview-stories tool also closes the review exit ramp: when review is enabled its description states display-review's availability as fact instead of hedging with "when available" (which let an agent that wrongly believed the tool was missing treat raw links as a sanctioned fallback), and its results append a recovery nudge pointing finished visual work and browse requests back to display-review. When review is disabled, the description no longer mentions display-review at all — the tool is not registered in those sessions.
The get-storybook-story-instructions story-linking workflow gets the same review-aware rewrite: with review enabled it now routes discovered story IDs into display-review and forbids constructing IDs from file names or memory, instead of framing get-changed-stories as a preview-stories helper. The
storybook ai --helpoutput embeds the same server instructions, so on the CLI/plugin path the two channels contradicted each other — this tool, billed as the source of truth for story work, still pointed discovery at previews, and agents were observed resolving the conflict by publishing reviews with hand-derived story IDs and zero discovery calls.#357
4a19151Thanks@kasperpeulen! - Refine the review/preview workflow so agents reuse the running Storybook and present a single set of links:
- Reuse the running Storybook. A successful tool call proves Storybook is already running, so the agent is instructed never to start another instance (no
storybook dev, launcher, or new port) just to view a review — a busy port is the instance to reuse, not a conflict to route around.display-reviewtriggers on insight requests too. Beyond post-change reviews, it now fires when the user wants to browse stories/components (e.g. "show me all badge components"), rendering exactly those stories with no diff (changedFilesomitted).- One set of links in the final response. When
display-reviewis available, the response links only the curated review page ("You can see a curated summary of stories in the Storybook review page"); otherwise it lists the individual preview URLs — never both.#357
4a19151Thanks@kasperpeulen! - Show private composed Storybooks as own-MCP guidance when accessed through the local MCP proxy.#357
4a19151Thanks@kasperpeulen! - Add Storybook 10.5 prerelease packages to the supported peer dependency range.The
display-reviewtool schema now requireschangedFiles: pass the paths of the files you changed (most central first), or an empty array[]for browse requests where no code changed. Payloads that previously omitted the field will fail validation.#357
4a19151Thanks@kasperpeulen! - Gate thedisplay-reviewtool solely on thechangeDetectionfeature flag. The previous@storybook/addon-reviewpackage-presence check is removed, since review is now built into Storybook core.
... (truncated)
de73c2c
Version Packages54e08b6
chore: reduce descriptionf50fbf6
fix(addon-mcp): add display-review escription01d6be2
Merge branch 'main' into docs--fix-linkd365aa5
docs(addon-mcp): correct documentation linkfcc5504
Enable review by default for the plugin (storybook ai CLI channel) (#341)32bb854
Bump Storybook catalog to 10.5.0-beta.0e729175
Add tools-api doc generator scriptd18712b
Bump Storybook catalog to 10.5.0-alpha.1145d268a
Extend the story-instructions trigger list to shared UI files