search_components

read-only

Searches 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

NameTypeNotes
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.
querystringSection intent or name. Default "".
categorystringOptional. atoms | marketing | dashboard.
sectionCategorystringOptional exact section role, such as hero.
tonestring[]Preferred tones; boosts metadata matches.
useCasestringDesired use case; matches bestFor and checks avoidFor.
visualWeightstringOptional preference: low | medium | high.
limitinteger1–50, default 8.
offsetintegerNon-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.

Request
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.