Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.moda.app/llms.txt

Use this file to discover all available pages before exploring further.

Some Moda MCP tools ship with paired interactive UIs. Hosts that support the io.modelcontextprotocol/ui extension — currently claude.ai web and Claude Desktop — render an embedded iframe on top of the tool’s normal JSON result. The same tools called from any other MCP host (Claude Code, Cursor, custom clients) return exactly the same JSON they always did. Interactive apps are purely additive. Interactive apps are useful when:
  • The tool returns visual data (canvases, brand colors, logos) that’s much easier to scan as a grid of thumbnails than as JSON
  • The tool starts a long-running job whose progress benefits from a live view
  • The user might want to take a follow-up action (search, set as default, remove) without round-tripping through the LLM

​
Available apps

AppTool(s)What it shows
Canvas Gallerylist_my_canvases, search_canvasesA grid of canvas thumbnails with names and last-updated timestamps. The inline search box re-calls search_canvases to refine results without involving the LLM.
Brand Kit Showcaselist_brand_kitsPer-kit cards with logos, color swatches, and live font samples. Includes a “Set as default” button that calls set_default_brand_kit.
Design Task Progressstart_design_taskLive progress, current step, and rendered page thumbnails as the design agent works. Polls get_task_status itself every couple of seconds and updates in place — no need to block the tool call or have the LLM babysit the polling loop.
Brand Kit Image Gallerylist_brand_kit_imagesLogos and reference images grouped by role, with a per-card Remove button that calls remove_brand_kit_image.

​
How it works

Each tool’s result includes a _meta.ui.resourceUri pointing to a ui://moda/... HTML resource. Iframe-aware hosts fetch that resource, hand it the tool result, and render it next to (or in place of) the raw JSON. Apps can call back into the same MCP server via app.callServerTool(...) to refine results, paginate, or perform follow-up actions — those follow-up calls hit the same authenticated session as the originating tool call.

​
Non-interactive hosts

Hosts that don’t support io.modelcontextprotocol/ui simply ignore the _meta.ui block and present the raw tool result as before. Every interactive feature has a non-interactive equivalent:
  • The Design Task Progress iframe replaces an explicit get_task_status polling loop. On non-interactive hosts, the host (or its LLM) polls get_task_status(task_id) directly.
  • The “Set as default” button calls set_default_brand_kit, which is also callable directly when a user explicitly asks to change their default.
  • The Remove button calls remove_brand_kit_image, which is also directly callable.
If you’re building an MCP integration, you can ignore interactive apps entirely and rely on the JSON tool results — nothing breaks, nothing is hidden.