Search components
search_componentsSearches the components of every package assigned to the project by use case, behavior, or description, and returns up to 10 ranked matches with a relevance score. Read-only. Use it when you can describe what the UI must do but do not know the component name. The query is free-text describing the need, such as "date range picker" or "dismissible inline warning" - not a component name, not a glob, and not a props expression. Do not use it when the exact name is known (get_component is direct and returns the full spec) or when you want the complete catalog (list_components). Semantic ranking needs AI features on the Team plan or above; on other plans it falls back to name and import-path matching and the score is null. No close match returns an empty result list, not an error. Null scores or no results do not mean the component is missing: in that mode a use-case phrase often matches nothing, so choose from list_components by name and use note, or retry with a plain component word such as "button".
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Free-text description of the need - a use case, behavior, or purpose, e.g. "date range picker". Not a component name and not a glob. | |
| project_id | Yes | UUID as returned by list_projects - not the project name, title, or slug, and not guessable. Fetch it once and reuse the same id across tools. An id outside the caller's organization returns "Project not found or access denied" rather than empty data, and a project withheld by a plan limit returns a plan error that retrying cannot clear. It bounds the search to the packages assigned to this project, so the same query returns different matches for different projects. |