Make get-component-documentation tool only accept a single component ID instead of multiple

[JReinhold]

Update the get-component-documentation functionality to handle only one component ID at a time, simplifying the input structure and related telemetry. Clean up code and documentation to reflect this change.

We saw through our evals, that often the agent would request documentation from so many components that the tool result exceeded the maximum token count, for Claude Code that is 25K. Forcing the agent to do a single call for each component mitigates this problem.

See the following eval conversations where it now correctly calls the tool multiple times, in parallel, without taking more time:

https://6916512dc7d0d3267c8cc898-unxmprivkz.chromatic.com/?path=/docs/conversation--docs
https://6916512dc7d0d3267c8cc898-ntuxttwlmk.chromatic.com/?path=/docs/conversation--docs
https://6916512dc7d0d3267c8cc898-pzkisoiady.chromatic.com/?path=/docs/conversation--docs

[changeset-bot]

🦋 Changeset detected

Latest commit: 5512ad2

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

💥 An error occurred when fetching the changed packages and changesets in this PR

Some errors occurred when validating the changesets config:
The package or glob expression "@storybook/mcp-eval" is specified in the `ignore` option but it is not found in the project. You may have misspelled the package name or provided an invalid glob expression. Note that glob expressions must be defined according to https://www.npmjs.com/package/micromatch.
The package or glob expression "@storybook/mcp-eval--*" is specified in the `ignore` option but it is not found in the project. You may have misspelled the package name or provided an invalid glob expression. Note that glob expressions must be defined according to https://www.npmjs.com/package/micromatch.

[codecov]

Bundle Report

Changes will decrease total bundle size by 523 bytes (-1.4%) ⬇️. This is within the configured threshold ✅

Detailed changes

Bundle name	Size	Change
@storybook/mcp-esm	19.51kB	-442 bytes (-2.21%) ⬇️
@storybook/addon-mcp-esm*	17.44kB	-81 bytes (-0.46%) ⬇️

ℹ️ *Bundle size includes cached data from a previous commit

Affected Assets, Files, and Routes:

view changes for bundle: @storybook/addon-mcp-esm

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
preset.js	-81 bytes	17.44kB	-0.46%

Files in preset.js:

• ./src/types.ts → Total Size: 614 bytes

• ./src/mcp-handler.ts → Total Size: 3.67kB

view changes for bundle: @storybook/mcp-esm

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
index.js	-418 bytes	12.73kB	-3.18%
index.d.ts	-24 bytes	6.79kB	-0.35%

Files in index.js:

• ./src/types.ts → Total Size: 756 bytes

• ./src/tools/get-component-documentation.ts → Total Size: 1.36kB

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 78.68%. Comparing base (28d675e) to head (c052778).
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##             next      #79      +/-   ##
==========================================
- Coverage   79.15%   78.68%   -0.48%     
==========================================
  Files          15       15              
  Lines         331      319      -12     
  Branches       98       94       -4     
==========================================
- Hits          262      251      -11     
  Misses         38       38              
+ Partials       31       30       -1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[Copilot]

Pull Request Overview

This PR simplifies the get-component-documentation MCP tool to accept a single component ID instead of an array of component IDs. This change prevents token limit issues when AI agents request documentation for many components simultaneously, forcing them to make parallel individual requests instead.

Key changes:

• Updated tool schema from array of strings to single string (componentId instead of componentIds)
• Simplified error handling with clearer messaging
• Updated telemetry to track single component lookups instead of batch counts

Reviewed Changes

Copilot reviewed 14 out of 15 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
packages/mcp/src/tools/get-component-documentation.ts	Tool implementation changed from batch to single component processing
packages/mcp/src/types.ts	Handler signature updated to reflect single component lookup
packages/mcp/src/tools/get-component-documentation.test.ts	Tests updated to remove batch scenarios, verify single component behavior
packages/addon-mcp/src/mcp-handler.ts	Telemetry tracking changed from counts to boolean found flag
packages/addon-mcp/README.md	User documentation updated to explain single-component usage
.github/instructions/*.md	Internal documentation updated for consistency
.changeset/petite-toes-dig.md	Changeset added for patch version bump
.changeset/config.json	Eval packages added to ignore list
pnpm-lock.yaml	Dependency lock file updated (eval experiment dependencies)
eval/evals/130-flight-booking-rsuite/hooks.ts	Unused imports removed (cleanup)
eval/evals/*/expected/stories/*.ts(x)	Spelling corrections in test expectations

[kasperpeulen]

LGTM

[Copilot]

Pull Request Overview

Copilot reviewed 29 out of 30 changed files in this pull request and generated no new comments.