search_components
read-onlySearches names, tags, descriptions, purpose, and design metadata. Returns ranked index entries with match scores, evidence, conflicts, and missing metadata. Scores are lexical hints; compare source, layout, and all avoidFor warnings before selecting. Without both brief answers, returns status: "needs_brief" and discovery questions instead of this result. Answer from existing context, ask the user only for material gaps, and retry with the same brief on every call.
Arguments
| Name | Type | Notes |
|---|---|---|
| brief | { intent?: string; visualDirection?: string } | Both answers are needed for catalogue data: what you are building, for whom, and the desired action; then the brand's tone, references, assets, and styles to avoid. Missing/blank answers return questions. Reuse across this task. |
| query | string | Section intent or name. Default "". |
| category | string | Optional. atoms | marketing | dashboard. |
| sectionCategory | string | Optional exact section role, such as hero. |
| tone | string[] | Preferred tones; boosts metadata matches. |
| useCase | string | Desired use case; matches bestFor and checks avoidFor. |
| visualWeight | string | Optional preference: low | medium | high. |
| limit | integer | 1–50, default 8. |
| offset | integer | Non-negative, default 0. Advance by limit for later results. |
Direct HTTP request
These examples use the original JSON API. Connected MCP clients call this tool through tools/call; results arrive as JSON text in content. Invalid arguments return a tool error in MCP or HTTP 400 in this API.
curl -X POST https://jabkit.joseadrianbuctuanon.dev/mcp \
-H "Content-Type: application/json" \
-d '{
"tool": "search_components",
"arguments": {
"brief": {
"intent": "Photography portfolio for art directors; show projects and invite enquiries.",
"visualDirection": "Restrained editorial layout with supplied photography; avoid dashboard chrome."
},
"query": "hero",
"category": "marketing",
"tone": [
"editorial",
"restrained"
],
"useCase": "creative portfolios",
"visualWeight": "medium",
"limit": 12
}
}'Response 200
[
{ "name": "…", "tone": [ … ], "bestFor": [ … ], "avoidFor": [ … ],
"match": { "score": 24, "matches": [ … ], "conflicts": [ … ],
"missingMetadata": [ … ] }, … },
… // up to limit; [] when exhausted
]Errors
None specific to this tool. An unknown tool name returns 400.