Find widget — Docsbook

MCPfind_widgetREADno token needed

Search the Docsbook widget catalog for an interactive UI widget matching the user's request. Returns matching widget ids and summaries. Use this to discover available widgets (e.g. 'dark mode toggle', 'analytics chart', 'search bar'). After finding a widget, use the returned resourceUri to read its HTML bundle via the ui:// resource.

Arguments

querystringrequired

Free-text description of what the user wants, e.g. 'dark mode toggle' or 'analytics dashboard'.

modestringoptional

Restrict matches to widgets available in this mode (admin or user). One of: admin, user.

Call it#

MCPcurl

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_widget",
    "arguments": {
      "query": "<query>",
      "mode": "admin"
    }
  }
}

curl -X POST 'https://docsbook.io/api/mcp/server' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_widget","arguments":{"query":"<query>","mode":"admin"}}}'

Updated Sep 19, 2026