watchface_font_catalog
Retrieve a curated font catalog to select font IDs for Divoom watchface elements by type, script, style, or scenario.
Instructions
Return a curated font catalog so agents can pick ItemList[i].font ids deterministically. Each entry includes id, type (1=TTF, 0=image-font), display name, original charset, derived script (digits / digits-extended / latin / cjk), style tags (sans/serif/pixel/digital/handwriting/display/decorative/bold/light/etc), and recommendedFor (scenario names like time_digits / temperature_digits / weather_text / user_text / lunar_text). The response also includes a scenarios map that lists which disp ids each scenario covers and which tags to prefer. For visual style and mood per font id, read MCP resource divoom://font/guide first. Use the optional filters to narrow the result. Always cross-check with watchface_get_fonts_local before committing a font id to a real device, because the on-device font list may be a subset.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Filter by font type. Default 'all'. | |
| script | No | Filter by derived script. 'digits' = image fonts whose charset is exactly 0-9. | |
| tag | No | Match a single style tag (e.g., 'pixel', 'digital', 'handwriting', 'sans', 'serif', 'cjk-capable'). | |
| scenario | No | Filter to fonts whose `recommendedFor` includes this scenario (see top-level `scenarios` map for the full list). | |
| ids | No | Return only the entries whose id is in this list (useful after watchface_get_fonts_local). | |
| limit | No | Max number of font entries to return (default 50, max 200). | |
| idsOnly | No | If true, return only `[{id, name, type_name, script}]` rows for a compact summary. | |
| includeScenarios | No | If true (default), include the top-level `scenarios` map in the response so the agent can map disp ids → preferred tags. |