Add support for using story ID as input for preview and test tools

.changeset/smart-clouds-glow.md

@@ -0,0 +1,8 @@
+---
+'@storybook/mcp': patch
+'@storybook/addon-mcp': patch
+---
+
+Add story ID based inputs for preview/testing workflows and surface story IDs in docs outputs.
+
+This change keeps existing path-based story inputs (`absoluteStoryPath` + `exportName`) while adding a `storyId` input shape for `preview-stories` and `run-story-tests`. It also adds `withStoryIds` to `list-all-documentation` and includes story IDs in `get-documentation` story sections, so agents can discover and reuse IDs directly without extra filesystem lookup steps.

apps/internal-storybook/tests/mcp-composition-auth.e2e.test.ts

@@ -146,6 +146,8 @@ describe('MCP Composition Auth E2E Tests', () => {
 
 				### Primary
 
+				Story ID: example-button--primary
+
 				\`\`\`
 				import { Button } from "@my-org/my-component-library";
 
@@ -154,6 +156,8 @@ describe('MCP Composition Auth E2E Tests', () => {
 
 				### Secondary
 
+				Story ID: example-button--secondary
+
 				\`\`\`
 				import { Button } from "@my-org/my-component-library";
 
@@ -162,6 +166,8 @@ describe('MCP Composition Auth E2E Tests', () => {
 
 				### Large
 
+				Story ID: example-button--large
+
 				\`\`\`
 				import { Button } from "@my-org/my-component-library";
 
@@ -170,8 +176,8 @@ describe('MCP Composition Auth E2E Tests', () => {
 
 				### Other Stories
 
-				- Small
-				- With A 11 Y Violation
+				- Small (example-button--small)
+				- With A 11 Y Violation (example-button--with-a-11-y-violation)
 
 				## Props
 

apps/internal-storybook/tests/mcp-composition.e2e.test.ts

@@ -88,6 +88,8 @@ describe('MCP Composition E2E Tests', () => {
 
 				### Primary
 
+				Story ID: example-button--primary
+
 				\`\`\`
 				import { Button } from "@my-org/my-component-library";
 
@@ -96,6 +98,8 @@ describe('MCP Composition E2E Tests', () => {
 
 				### Secondary
 
+				Story ID: example-button--secondary
+
 				\`\`\`
 				import { Button } from "@my-org/my-component-library";
 
@@ -104,6 +108,8 @@ describe('MCP Composition E2E Tests', () => {
 
 				### Large
 
+				Story ID: example-button--large
+
 				\`\`\`
 				import { Button } from "@my-org/my-component-library";
 
@@ -112,8 +118,8 @@ describe('MCP Composition E2E Tests', () => {
 
 				### Other Stories
 
-				- Small
-				- With A 11 Y Violation
+				- Small (example-button--small)
+				- With A 11 Y Violation (example-button--with-a-11-y-violation)
 
 				## Props
 

eval/tasks/914-preview-story-by-path/README.md

@@ -0,0 +1,32 @@
+# 914 – Preview Story By Path
+
+## Purpose
+
+Tests whether the agent chooses the **path-based preview input** after reading story-file context directly from disk.
+
+## Setup
+
+- Pre-seeded Button component and existing stories.
+- Prompt first asks the agent to read `stories/Button.stories.tsx` and report its imports.
+- Prompt then asks the agent to preview existing `Primary` and `Secondary` stories.
+- No file edits are expected.
+
+## Prompt
+
+Asks the agent to inspect story file imports first, then preview `Primary` and `Secondary`.
+
+## Quality Signal
+
+| Metric                                               | Weight |
+| ---------------------------------------------------- | ------ |
+| MCP tools coverage (`preview-stories` called)        | 10 %   |
+| Preview input strategy (path + exportName preferred) | 60 %   |
+| Avoid unnecessary docs fetches for button            | 30 %   |
+
+## Expected MCP Tools
+
+- `preview-stories` (at least 1 call)
+
+For strategy quality credit, at least one preview invocation should pass `stories` using `absoluteStoryPath` + `exportName` and should not rely exclusively on `storyId`.
+
+For docs-avoidance quality credit, the agent should not call `get-documentation` with `id: "button"` in this task.

eval/tasks/914-preview-story-by-path/config.json

@@ -0,0 +1,7 @@
+{
+	"expectedMcpTools": {
+		"preview-stories": {
+			"minCalls": 1
+		}
+	}
+}