Docsbook
Overview

Find widget

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#

{
  "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"}}}'

Try it over REST#

The same tool is callable as a plain HTTP request, no MCP client required. It runs on the same server, at the same price.

GET/api/v1/find_widget
Authorization
Authorizationstringrequired

Your API key, sent as Authorization: Bearer dbk_YOUR_API_KEY.Sent as the Authorization header. Your key is used only by your browser for this request — it is never sent to Docsbook or stored.

Query
querystringrequired

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

modestring

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

Request
curl 'https://docsbook.io/api/v1/find_widget?query=%3Cquery%3E&mode=admin' \
  -H 'Authorization: Bearer dbk_YOUR_API_KEY'

Updated

Was this page helpful?