Find widget
MCP
find_widgetREADno token needed
Features
Search the Docsbook widget catalog for an interactive UI widget matching the user's request. Returns matching widget ids and summaries. 'dark mode toggle', 'analytics chart', 'search bar'). After finding a widget, use the returned resourceUri to read its HTML bundle via the ui:// resource.
Input2
Your API key, for the REST call. Sent from your browser straight to the API — never to Docsbook, never stored.
Free-text description of what the user wants, e.g. 'dark mode toggle' or 'analytics dashboard'.
Restrict matches to widgets available in this mode (admin or user). One of:
admin, user.Output3
{ id, name, summary, resourceUri, requiresPlan, modes }.
Use cases
- Use this to discover available widgets (e.g.
Example input
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "find_widget",
"arguments": {
"query": "<query>",
"mode": "admin"
}
}
}Example output
{
"matches": [],
"index_version": "<index_version>",
"index_fetched_at": "<index_fetched_at>"
}