shads.app docs

MCP tools reference

Every tool the shads.app MCP server exposes, with example arguments. You usually just describe the task and your assistant picks the tools.

Public tools

Available to every client, with or without an account.

ToolWhat it does
connection_statusVerify the connection: server version, plan, and whether your API key was accepted.
list_themesList the curated starter themes.
get_themeReturn theme.json and theme.css for a starter theme. Example: { "id": "workspace" }
get_theme_packageFull package for a theme: documents, skill markdown, dependencies and install plan. Example: { "id": "workspace" }
install_planOrdered shell commands to install a theme into a new or existing project. Example: { "id": "workspace", "mode": "existing" }
get_install_promptA copyable agent install prompt for a starter or shared theme. Example: { "item": "workspace", "mode": "both" }
resolve_shareResolve a share or registry URL to its title and install prompt. Example: { "item": "abc123" }
get_skillThe theme-specific skill markdown that tells an agent how to build in this theme. Example: { "id": "workspace" }
validate_themeValidate a theme.json string against the schema. Example: { "source": "..." }
theme_schemaReturn the active theme schema id.
list_startersList starter registry and skill install URLs.
list_conceptsList the visual-language concepts a theme can be built from.
get_conceptReturn a full concept document by slug. Example: { "slug": "terminal" }
authenticateSetup guidance for adding an API key. Listed only when no valid key is connected.

Account tools

Appear when a valid API key is connected. See authentication.

ToolWhat it does
list_my_themesList the themes saved to your account.
get_my_themeReturn one of your saved themes as theme.json plus CSS. Example: { "id": "<theme id>" }
save_themeSave a theme document to your account. Example: { "name": "...", "document": "..." }
update_themeRename and/or update a saved theme. Example: { "id": "...", "name": "..." }
generate_themeHosted AI theme generation (uses your monthly quota). Example: { "description": "..." }
check_subscriptionPlan, MCP access, AI quota and saved-theme count.

Notes

  • Read-only tools are marked as such, so clients that honour the hint (for example VS Code) do not ask for confirmation on every call.
  • get_theme with { "id": "workspace" } returns metadata, the parsed theme document, and the CSS.
  • Rate limits apply per client. When one is hit, the response says how many seconds to wait.