> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to the Artisto MCP server

The Artisto MCP connector routes your AI agent's tool calls to Artisto's own MCP server through Scalekit. Each user connects their own Artisto access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 81 tools.

**Authentication:** Bearer Token
**Categories:** Design, AI
**Tools:** 81: 34 read, 33 write, 14 destructive
**Users sign in with:** Access token
**Built by:** Vendor MCP
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ARTISTOMCP)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Artisto MCP connection

   In **AgentKit > Connections**, create an Artisto MCP connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'artistomcp'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Artisto MCP:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'artistomcp_users_me',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "artistomcp"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Artisto MCP:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="artistomcp_users_me",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Artisto MCP server credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'artistomcp_billing_state',
  toolInput: {},
  connector: 'artistomcp',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="artistomcp_billing_state",
    tool_input={},
    connection_name="artistomcp",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `artistomcp_billing_state`

Get Billing State · Read-only

Get the caller's billing state from Polar: active subscriptions, granted benefits, and isPro (holds the Pro benefit). When billing is off it answers id "noop" with nothing active.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_chats_byid`

Get Chat · Read-only

Get one of the caller's chats with its messages, oldest first, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the chat to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_chats_folderbyid`

Get Chat Folder · Read-only

Get one of the caller's chat folders by id, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the chat folder to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_chats_folders`

List Chat Folders · Read-only

List the caller's chat folders in their sort order.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_chats_mine`

List My Chats · Read-only

List the caller's chats without messages: pinned first, then most recently updated.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_designs_app`

Get Design App · Read-only

Get one of the caller's design apps by id with its brief and design system (theme CSS, DESIGN.md, fonts, devices, appearance), or null. Before designing, read designs_context too.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the design app to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_apps`

List Design Apps · Read-only

List the caller's design apps, newest first.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_designs_appsystem`

Get App Design System · Read-only

Get one of the caller's apps by appId with its current design system, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, required): UUID of the design app.

Example input: `{"appId":"<appId>"}`

### `artistomcp_designs_assets`

List App Images · Read-only

List the images of one of the caller's apps (brand sheets, screen concepts, references) with their prompts. Fetch one with GET /api/designs/assets/<id>.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, required): UUID of the design app.

Example input: `{"appId":"<appId>"}`

### `artistomcp_designs_comment`

Get Review Comment · Read-only

Get one of the caller's review comments by id, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the review comment to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_comments`

List Review Comments · Read-only

List the review comments on one of the caller's apps, oldest first. Address open ones, then resolve them.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, required): UUID of the design app.

Example input: `{"appId":"<appId>"}`

### `artistomcp_designs_component`

Get Component · Read-only

Get one of the caller's components by id with its code and variants, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the component to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_components`

List Components · Read-only

List the reusable components of one of the caller's apps, by name: each one's TSX code, description and variants ([{ name, code }]). Screens import them from "@project/components".

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, required): UUID of the design app.

Example input: `{"appId":"<appId>"}`

### `artistomcp_designs_context`

Get Design Context · Read-only

Read everything an agent must stay true to before designing: the app's description and project brief (what it is, who it is for, its philosophy), the design system in effect (the app's, or the saved style set on the flow or screen) with DESIGN.md, fonts and tokens, each flow's brief and steps, and the screen's own brief (spec: what that screen is for). Pass screenId, flowId or appId (most specific wins). Markdown, or null when not found.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, optional): UUID of an app. Pass screenId, flowId or appId; the most specific one wins.
- `flowId` (`string`, optional): UUID of a flow. Pass screenId, flowId or appId; the most specific one wins.
- `screenId` (`string`, optional): UUID of a screen. Pass screenId, flowId or appId; the most specific one wins.

Example input: `{}`

### `artistomcp_designs_flow`

Get Flow · Read-only

Get one of the caller's flows by id, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the flow to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_flows`

List Flows · Read-only

List the flows (user journeys such as checkout or onboarding) of one of the caller's apps, in order.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, required): UUID of the design app.

Example input: `{"appId":"<appId>"}`

### `artistomcp_designs_flowvariant`

Get Flow Variant · Read-only

Get one of the caller's flow variants by id, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the flow variant to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_flowvariants`

List Flow Variants · Read-only

List the variants of one of the caller's flows (alternative versions of the journey), oldest first. Each has steps: [{ screenId, variantId }], where a null variantId shows the screen's selected variant.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `flowId` (`string`, required): UUID of the flow.

Example input: `{"flowId":"<flowId>"}`

### `artistomcp_designs_guide`

Read Design Guide · Read-only

Read Artisto's design guide (Markdown). Topics: workflow (how to design here), kit (what screen TSX may import and use), components (the app's reusable components and their variants), rules (taste, copy, states, responsiveness), system (design system and concept images from generated images), flows (flows, variants, review, handoff); omit topic for all. Pass appId to append that app's brief and DESIGN.md.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, optional): Optional UUID of an app whose brief and DESIGN.md are appended to the guide.
- `topic` (`string`, optional): Guide topic: workflow, kit, components, rules, system or flows. Omit for the whole guide. One of: `workflow`, `kit`, `components`, `rules`, `system`, `flows`.

Example input: `{}`

### `artistomcp_designs_lintvariant`

Lint Variant · Read-only

Check one of the caller's variants for AI slop and design-system drift (raw colors instead of theme tokens, gradient text, emoji icons, nested cards, arbitrary values, cliché copy, unknown imports, missing responsiveness). Returns the warnings to fix, or null when the variant doesn't exist.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the screen variant to lint.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_screen`

Get Screen · Read-only

Get one of the caller's screens by id, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the screen to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_screenlinted`

Get Screen with Lint Warnings · Read-only

Get one of the caller's screens with the lint warnings of its first variant, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the screen to fetch with lint warnings.
- `variantId` (`string`, required): UUID of the screen variant whose lint warnings to return.

Example input: `{"id":"<id>","variantId":"<variantId>"}`

### `artistomcp_designs_screens`

List Screens · Read-only

List the screens of one of the caller's apps, with slug, canvas position, devices, spec and selected variant.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, required): UUID of the design app.

Example input: `{"appId":"<appId>"}`

### `artistomcp_designs_style`

Get Saved Style · Read-only

Get one of the caller's saved design styles by id, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the saved style to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_styles`

List Saved Styles · Read-only

List the caller's saved design styles (theme CSS, DESIGN.md, fonts), by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_designs_variant`

Get Variant · Read-only

Get one of the caller's screen variants by id, with its TSX source, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the screen variant to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_variantlinted`

Get Variant with Lint Warnings · Read-only

Get one of the caller's variants with its lint warnings, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the screen variant to fetch with lint warnings.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_variants`

List Variants · Read-only

List every variant (TSX source included) of the screens of one of the caller's apps.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, required): UUID of the design app.

Example input: `{"appId":"<appId>"}`

### `artistomcp_todos_archived`

List Archived Todos · Read-only

List the caller's archived todos, newest first.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_todos_byid`

Get Todo · Read-only

Get one of the caller's todos by id, or null.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the todo to fetch.

Example input: `{"id":"<id>"}`

### `artistomcp_todos_export`

Export Todos · Read-only

Export the caller's active and paused todos as a Markdown checklist.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_todos_mine`

List My Todos · Read-only

List the caller's active and paused todos, newest first.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_users_me`

Get My Profile · Read-only

Get the caller's own profile: name, email, username, bio, timezone, role, onboarding state, raw preferences, and the avatar and cover images (UploadThing keys). Null when the user no longer exists.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_users_verificationemailstatus`

Get Verification Email Status · Read-only

Get whether the caller can request another verification email and when (ISO time); null when verification is off or the email is already verified.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `artistomcp_chats_create`

Create Chat · Write

Start a chat and return it. Defaults: title 'New chat', intelligence 'standard'.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `folderId` (`string`, optional): Folder to create the chat in, or null for no folder.
- `id` (`string`, optional): Optional ID for the new chat; generated when omitted.
- `intelligence` (`string`, optional): Intelligence level for the chat: standard, low, medium or high. One of: `standard`, `low`, `medium`, `high`.
- `modelId` (`string`, optional): AI model ID for the chat, or null for the default.
- `providerId` (`string`, optional): AI provider ID for the chat (for example openai or anthropic), or null for the default.
- `title` (`string`, optional): Chat title (1-120 characters). Defaults to 'New chat'.

Example input: `{}`

### `artistomcp_chats_createfolder`

Create Chat Folder · Write

Create a chat folder at the end of the caller's folder list and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the new chat folder (1-80 characters).
- `id` (`string`, optional): Optional ID for the new folder; generated when omitted.

Example input: `{"name":"<name>"}`

### `artistomcp_chats_movetofolder`

Move Chat to Folder · Write

Move a chat into one of the caller's folders, or out of any folder with null, and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `folderId` (`string`, required): Folder to move the chat into, or null to take it out of any folder.
- `id` (`string`, required): ID of the chat to move.

Example input: `{"folderId":"<folderId>","id":"<id>"}`

### `artistomcp_chats_rename`

Rename Chat · Write

Rename a chat and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the chat to rename.
- `title` (`string`, required): New chat title (1-120 characters).

Example input: `{"id":"<id>","title":"<title>"}`

### `artistomcp_chats_renamefolder`

Rename Chat Folder · Write

Rename a chat folder and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the chat folder to rename.
- `name` (`string`, required): New name for the chat folder (1-80 characters).

Example input: `{"id":"<id>","name":"<name>"}`

### `artistomcp_chats_setpinned`

Pin or Unpin Chat · Write

Pin a chat to the top of the list, or unpin it, and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the chat to pin or unpin.
- `pinned` (`boolean`, required): true to pin the chat to the top of the list, false to unpin it.

Example input: `{"id":"<id>","pinned":true}`

### `artistomcp_chats_updatesettings`

Update Chat Settings · Write

Change a chat's AI provider, model or intelligence level (only the fields given), and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the chat whose settings change.
- `intelligence` (`string`, optional): Intelligence level for the chat: standard, low, medium or high. One of: `standard`, `low`, `medium`, `high`.
- `modelId` (`string`, optional): AI model ID for the chat, or null for the default.
- `providerId` (`string`, optional): AI provider ID for the chat (for example openai or anthropic), or null for the default.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_addcomment`

Add Review Comment · Write

Pin a review comment to one or more points, areas or elements of a variant (coordinates are fractions of the frame) and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `appId` (`string`, required): UUID of the design app.
- `device` (`string`, required): Device frame the comment was made on, or null.
- `targets` (`array`, required): 1-20 places the comment is pinned to. Each is a point, area or element; coordinates and sizes are fractions (0-1) of the frame, and an element target names a CSS selector.
- `text` (`string`, required): The review comment (1-4000 characters).
- `variantId` (`string`, required): UUID of the screen variant the comment is pinned to.
- `id` (`string`, optional): Optional UUID for the new comment; generated when omitted.

Example input: `{"appId":"<appId>","device":"<device>","targets":[],"text":"<text>","variantId":"<variantId>"}`

### `artistomcp_designs_applystyle`

Apply Saved Style to App · Write

Make a saved style an app's design system: copies its theme CSS, DESIGN.md and fonts into the app (save the current one first with createStyle fromAppId to keep it). Returns the app.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `appId` (`string`, required): UUID of the design app.
- `styleId` (`string`, required): UUID of the saved style to copy into the app's design system.

Example input: `{"appId":"<appId>","styleId":"<styleId>"}`

### `artistomcp_designs_createapp`

Create Design App · Write

Create a design app (a product: its design system, screens and flows) and return it. brief is long Markdown on what the app is, who it is for and its philosophy. Starts from neutral shadcn tokens on mobile unless given a theme; the id is generated when omitted.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `description` (`string`, required): One-line description of the app (up to 2000 characters).
- `name` (`string`, required): Name of the design app (1-200 characters).
- `appearance` (`string`, optional): Default appearance: light or dark. One of: `light`, `dark`.
- `brief` (`string`, optional): Long Markdown brief: what the app is, who it is for and its philosophy.
- `designMd` (`string`, optional): The design system's DESIGN.md (Markdown).
- `devices` (`array`, optional): Devices the app is designed for (1-5 of mobile, foldable, tablet, desktop, wide).
- `fonts` (`array`, optional): Google font families (up to 20).
- `id` (`string`, optional): Optional UUID for the new app; generated when omitted.
- `themeCss` (`string`, optional): shadcn theme CSS with tokens for :root and .dark.

Example input: `{"description":"<description>","name":"<name>"}`

### `artistomcp_designs_createcomponent`

Create Component · Write

Add a reusable component to one of the caller's apps and return it. name is the PascalCase export screens import (import { Name } from "@project/components"); code is a TSX module exporting it (imports: react, @kit, lucide-react, @project/components); variants are its named states [{ name, code }], each a JSX snippet like Cancel (all project components are in scope) or a module with a default export. Starter code and one "default" variant when omitted.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `appId` (`string`, required): UUID of the design app.
- `name` (`string`, required): PascalCase export name that screens import from @project/components.
- `code` (`string`, optional): TSX module exporting the component (imports: react, @kit, lucide-react, @project/components). Starter code is used when omitted.
- `description` (`string`, optional): What the component is for (up to 4000 characters).
- `id` (`string`, optional): Optional UUID for the new component; generated when omitted.
- `variants` (`array`, optional): Named states of the component, each with a name and a JSX snippet or module. One 'default' variant is created when omitted.

Example input: `{"appId":"<appId>","name":"<name>"}`

### `artistomcp_designs_createflow`

Create Flow · Write

Add a flow (a user journey such as checkout or onboarding) to one of the caller's apps, with a first variant named 'original' made of the given steps ([{ screenId, variantId }], null variantId = the screen's pick). Returns the flow.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `appId` (`string`, required): UUID of the design app.
- `name` (`string`, required): Name of the flow (1-200 characters).
- `steps` (`array`, required): Ordered steps of the flow's first variant. Each step names a screen and a variant of it; a null variant uses the screen's selected variant.
- `description` (`string`, optional): The flow's brief in Markdown: the journey's goal, who takes it, what must happen.
- `id` (`string`, optional): Optional UUID for the new flow; generated when omitted.
- `sortOrder` (`integer`, optional): Position of the flow in the app's flow list.
- `variantId` (`string`, optional): Optional UUID for the flow's first variant ('original'); generated when omitted.

Example input: `{"appId":"<appId>","name":"<name>","steps":[]}`

### `artistomcp_designs_createflowvariant`

Create Flow Variant · Write

Add an alternative version of a flow: a name and its steps ([{ screenId, variantId }]; screens may differ, be reordered, or show other screen variants). Returns the flow variant.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `flowId` (`string`, required): UUID of the flow.
- `name` (`string`, required): Name of the flow variant (1-200 characters).
- `steps` (`array`, required): Ordered steps of this version of the flow. Each step names a screen and a variant of it; a null variant uses the screen's selected variant.
- `id` (`string`, optional): Optional UUID for the new flow variant; generated when omitted.

Example input: `{"flowId":"<flowId>","name":"<name>","steps":[]}`

### `artistomcp_designs_createscreen`

Create Screen · Write

Add a screen to one of the caller's apps with its first variant (TSX with a default export importing only react, @kit and lucide-react; starter code when omitted) and its brief (spec, Markdown: what this one screen is for, its content and states), and return the screen. Other screens link to it with .

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `appId` (`string`, required): UUID of the design app.
- `name` (`string`, required): Name of the screen (1-200 characters).
- `slug` (`string`, required): URL-safe screen slug (lowercase letters, digits and hyphens, up to 64). Other screens link to it with .
- `x` (`integer`, required): Horizontal position of the screen on the canvas, in pixels.
- `y` (`integer`, required): Vertical position of the screen on the canvas, in pixels.
- `code` (`string`, optional): TSX for the first variant, with a default export importing only react, @kit and lucide-react. Starter code is used when omitted.
- `id` (`string`, optional): Optional UUID for the new screen; generated when omitted.
- `spec` (`string`, optional): The screen's brief in Markdown: what this screen is for, its content and states.
- `variantId` (`string`, optional): Optional UUID for the screen's first variant; generated when omitted.

Example input: `{"appId":"<appId>","name":"<name>","slug":"<slug>","x":1,"y":1}`

### `artistomcp_designs_createstyle`

Create Saved Style · Write

Save a design style (shadcn theme CSS for :root and .dark, DESIGN.md, Google fonts) to the caller's style library. fromAppId copies that app's current design system for any field not given. Styles can be applied to an app (applyStyle) or set on a flow or screen (styleId) to try them. Returns the style.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the saved style (1-200 characters).
- `description` (`string`, optional): Description of the style (up to 4000 characters).
- `designMd` (`string`, optional): The design system's DESIGN.md (Markdown).
- `fonts` (`array`, optional): Google font families (up to 20).
- `fromAppId` (`string`, optional): Optional UUID of an app whose current design system fills any field not given.
- `id` (`string`, optional): Optional UUID for the new style; generated when omitted.
- `themeCss` (`string`, optional): shadcn theme CSS with tokens for :root and .dark.

Example input: `{"name":"<name>"}`

### `artistomcp_designs_createvariant`

Create Variant · Write

Add a design variant (TSX with a default export importing only react, @kit and lucide-react) to one of the caller's screens and return it with lint warnings to fix. `overrides` optionally maps a device, appearance or device:appearance (mobile, dark, desktop:dark) to code rendered there instead of `code`.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `code` (`string`, required): TSX with a default export, importing only react, @kit and lucide-react.
- `name` (`string`, required): Name of the variant (1-200 characters).
- `screenId` (`string`, required): UUID of the screen.
- `id` (`string`, optional): Optional UUID for the new variant; generated when omitted.
- `overrides` (`object`, optional): Optional map from a device, appearance or device:appearance (mobile, dark, desktop:dark) to TSX rendered there instead of the base code.

Example input: `{"code":"<code>","name":"<name>","screenId":"<screenId>"}`

### `artistomcp_designs_generateimage`

Generate App Image · Write

Generate an image for one of the caller's apps with the caller's OpenAI key (Settings, AI providers) and store it as an asset: kind brand (identity sheet: palette, type, components), concept (a screen or flow to code from) or reference. Unless useDesignSystem is false, the app's DESIGN.md and theme tokens are appended to the prompt so the image follows the design system; referenceAssetIds (the app's images, e.g. the brand sheet) steer style. Takes up to a minute. Returns the asset; fetch the image at GET /api/designs/assets/<id>.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `appId` (`string`, required): UUID of the design app.
- `kind` (`string`, required): Image kind: brand (identity sheet), concept (a screen or flow to code from) or reference. One of: `brand`, `concept`, `reference`.
- `name` (`string`, required): Name of the generated image (1-200 characters).
- `prompt` (`string`, required): What to generate (1-8000 characters).
- `referenceAssetIds` (`array`, optional): Up to 4 UUIDs of the app's images that steer the style.
- `size` (`string`, optional): Image size in pixels. One of: `1024x1024`, `1536x1024`, `1024x1536`.
- `useDesignSystem` (`boolean`, optional): When true (default), the app's DESIGN.md and theme tokens are appended to the prompt.

Example input: `{"appId":"<appId>","kind":"brand","name":"<name>","prompt":"<prompt>"}`

### `artistomcp_designs_resolvecomment`

Resolve or Reopen Review Comment · Write

Mark a review comment resolved or open again, and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the review comment to resolve or reopen.
- `resolved` (`boolean`, required): true to mark the comment resolved, false to reopen it.

Example input: `{"id":"<id>","resolved":true}`

### `artistomcp_designs_setcomponentvariant`

Set Component Variant · Write

Add or replace one named variant (state) of a component, e.g. { name: "disabled", code: "Save" }, and return the component.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `code` (`string`, required): JSX snippet or module for this variant.
- `id` (`string`, required): UUID of the component whose variant to add or replace.
- `name` (`string`, required): Name of the component variant (state) to add or replace (1-60 characters).

Example input: `{"code":"<code>","id":"<id>","name":"<name>"}`

### `artistomcp_designs_setvariantoverride`

Set Variant Override · Write

Give a variant its own code for one device, appearance or device:appearance (target mobile, dark, tablet:dark...), rendered there instead of its base code; code null removes that override. Use it when a size or theme needs a different structure, not just responsive classes or dark: colors. Returns the variant with lint warnings.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `code` (`string`, required): TSX rendered for that target instead of the base code, or null to remove the override.
- `id` (`string`, required): UUID of the variant to give an override.
- `target` (`string`, required): Device, appearance or device:appearance the override applies to. One of: `mobile`, `foldable`, `tablet`, `desktop`, `wide`, `light`, `dark`, `mobile:light`, `mobile:dark`, `foldable:light`, `foldable:dark`, `tablet:light`, `tablet:dark`, `desktop:light`, `desktop:dark`, `wide:light`, `wide:dark`.

Example input: `{"code":"<code>","id":"<id>","target":"mobile"}`

### `artistomcp_designs_updateapp`

Update Design App · Write

Change a design app's name, one-line description, project brief (long Markdown: what the app is, who it is for, its philosophy; screen-specific text goes in each screen's spec) or design system: devices, default appearance, theme CSS (shadcn tokens for :root and .dark), DESIGN.md or Google fonts. Returns the app.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the design app to change.
- `appearance` (`string`, optional): Default appearance: light or dark. One of: `light`, `dark`.
- `brief` (`string`, optional): Long Markdown brief: what the app is, who it is for and its philosophy. Screen-specific text goes in each screen's spec.
- `description` (`string`, optional): One-line description of the app (up to 2000 characters).
- `designMd` (`string`, optional): The design system's DESIGN.md (Markdown).
- `devices` (`array`, optional): Devices the app is designed for (1-5 of mobile, foldable, tablet, desktop, wide).
- `fonts` (`array`, optional): Google font families (up to 20).
- `name` (`string`, optional): New name of the design app (1-200 characters).
- `themeCss` (`string`, optional): shadcn theme CSS with tokens for :root and .dark.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_updateasset`

Update App Image · Write

Rename an app image, change its kind (brand, concept, reference) or its recorded prompt.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the app image to change.
- `kind` (`string`, optional): Image kind: brand (identity sheet), concept (a screen or flow to code from) or reference. One of: `brand`, `concept`, `reference`.
- `name` (`string`, optional): New name of the app image (1-200 characters).
- `prompt` (`string`, optional): The prompt recorded for the image (up to 8000 characters).

Example input: `{"id":"<id>"}`

### `artistomcp_designs_updatecomponent`

Update Component · Write

Change a component's name, description, TSX code or its whole variants list, and return it. Every screen importing it re-renders with the change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the component to change.
- `code` (`string`, optional): New TSX module exporting the component.
- `description` (`string`, optional): What the component is for (up to 4000 characters).
- `name` (`string`, optional): New PascalCase export name of the component.
- `variants` (`array`, optional): Replaces the component's whole variants list; each has a name and a JSX snippet or module.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_updateflow`

Update Flow · Write

Rename a flow, change its description (its brief, Markdown: the journey's goal, who takes it, what must happen), order, styleId (a saved style its screens render with in this flow, null for the app's), or pick which of its variants is shown by default. Returns the flow.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the flow to change.
- `description` (`string`, optional): The flow's brief in Markdown: the journey's goal, who takes it, what must happen.
- `name` (`string`, optional): New name of the flow (1-200 characters).
- `selectedVariantId` (`string`, optional): UUID of the flow variant shown by default.
- `sortOrder` (`integer`, optional): New position of the flow in the app's flow list.
- `styleId` (`string`, optional): UUID of a saved style the flow's screens render with, or null to use the app's design system.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_updateflowvariant`

Update Flow Variant · Write

Rename a flow variant, replace its steps or set its liked flag. Returns the flow variant.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the flow variant to change.
- `liked` (`boolean`, optional): Whether the flow variant is marked as liked.
- `name` (`string`, optional): New name of the flow variant (1-200 characters).
- `steps` (`array`, optional): Replaces the flow variant's steps. Each step names a screen and a variant of it; a null variant uses the screen's selected variant.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_updatescreen`

Update Screen · Write

Change a screen's name, slug, canvas position, devices (null = all of the app's), spec (the screen's brief, Markdown: what this one screen is for, its content and states; what the whole app is goes in the app's brief), styleId (a saved style it renders with instead of the app's, null for the app's) or selected variant, and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the screen to change.
- `devices` (`string`, optional): Devices the screen is designed for, or null for all of the app's devices.
- `name` (`string`, optional): New name of the screen (1-200 characters).
- `selectedVariantId` (`string`, optional): UUID of the variant the screen shows.
- `slug` (`string`, optional): New URL-safe screen slug (lowercase letters, digits and hyphens, up to 64).
- `spec` (`string`, optional): The screen's brief in Markdown: what this screen is for, its content and states.
- `styleId` (`string`, optional): UUID of a saved style this screen renders with, or null to use the app's design system.
- `x` (`integer`, optional): Horizontal position of the screen on the canvas, in pixels.
- `y` (`integer`, optional): Vertical position of the screen on the canvas, in pixels.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_updatestyle`

Update Saved Style · Write

Change a saved style's name, description, theme CSS, DESIGN.md or fonts. Flows and screens using it re-render with it; apps it was applied to keep their copy. Returns the style.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the saved style to change.
- `description` (`string`, optional): Description of the style (up to 4000 characters).
- `designMd` (`string`, optional): The design system's DESIGN.md (Markdown).
- `fonts` (`array`, optional): Google font families (up to 20).
- `name` (`string`, optional): New name of the saved style (1-200 characters).
- `themeCss` (`string`, optional): shadcn theme CSS with tokens for :root and .dark.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_updatevariant`

Update Variant · Write

Change a variant's name, TSX code, liked flag or whole overrides map, and return it with lint warnings to fix.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the variant to change.
- `code` (`string`, optional): New TSX for the variant, with a default export importing only react, @kit and lucide-react.
- `liked` (`boolean`, optional): Whether the variant is marked as liked.
- `name` (`string`, optional): New name of the variant (1-200 characters).
- `overrides` (`object`, optional): Replaces the whole overrides map: device, appearance or device:appearance to TSX rendered there instead of the base code.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_uploadimage`

Upload App Image · Write

Store an image you made elsewhere (PNG, JPEG or WebP, base64, up to 8 MB) as an asset of one of the caller's apps, with the prompt that made it. Returns the asset.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `appId` (`string`, required): UUID of the design app.
- `dataBase64` (`string`, required): The image bytes, base64-encoded (PNG, JPEG or WebP, up to 8 MB).
- `kind` (`string`, required): Image kind: brand (identity sheet), concept (a screen or flow to code from) or reference. One of: `brand`, `concept`, `reference`.
- `mimeType` (`string`, required): Image format of the uploaded data. One of: `image/png`, `image/jpeg`, `image/webp`.
- `name` (`string`, required): Name of the uploaded image (1-200 characters).
- `prompt` (`string`, optional): The prompt that made the image, if any (up to 8000 characters).

Example input: `{"appId":"<appId>","dataBase64":"<dataBase64>","kind":"brand","mimeType":"image/png","name":"<name>"}`

### `artistomcp_todos_create`

Create Todo · Write

Create a todo and return it. The id is generated when omitted.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `title` (`string`, required): The todo text (1-500 characters).
- `id` (`string`, optional): Optional UUID for the new todo; generated when omitted.

Example input: `{"title":"<title>"}`

### `artistomcp_todos_plan`

Plan Todo · Write

Set the day a todo is planned for (YYYY-MM-DD), or null to unplan it, and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the todo to plan.
- `plannedFor` (`string`, required): Day the todo is planned for (YYYY-MM-DD), or null to unplan it.

Example input: `{"id":"<id>","plannedFor":"<plannedFor>"}`

### `artistomcp_todos_setdone`

Set Todo Done · Write

Mark a todo done or not done, and return it.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `done` (`boolean`, required): true to mark the todo done, false to mark it not done.
- `id` (`string`, required): UUID of the todo to mark done or not done.

Example input: `{"done":true,"id":"<id>"}`

### `artistomcp_todos_setstatus`

Set Todo Status · Write

Pause, archive or reactivate a todo, and return it. Archived todos drop out of todos.mine.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the todo whose status changes.
- `status` (`string`, required): New status: active, paused or archived. One of: `active`, `paused`, `archived`.

Example input: `{"id":"<id>","status":"active"}`

### `artistomcp_chats_deletefolder`

Delete Chat Folder · Destructive

Delete a chat folder. Its chats are kept and move out of the folder.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the chat folder to delete. Its chats are kept.

Example input: `{"id":"<id>"}`

### `artistomcp_chats_remove`

Delete Chat · Destructive

Delete a chat and all of its messages permanently.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the chat to delete with all its messages.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removeapp`

Delete Design App · Destructive

Delete a design app with all its screens, variants, flows, comments and images.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the design app to delete with all its screens, variants, flows, comments and images.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removeasset`

Delete App Image · Destructive

Delete an app image.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the app image to delete.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removecomment`

Delete Review Comment · Destructive

Delete a review comment.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the review comment to delete.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removecomponent`

Delete Component · Destructive

Delete a component. Screens that import it fail to render until they stop importing it.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the component to delete.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removecomponentvariant`

Remove Component Variant · Destructive

Remove one named variant from a component and return the component.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the component to remove a variant from.
- `name` (`string`, required): Name of the component variant to remove.

Example input: `{"id":"<id>","name":"<name>"}`

### `artistomcp_designs_removeflow`

Delete Flow · Destructive

Delete a flow and its variants. Its screens stay in the app.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the flow to delete with its variants.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removeflowvariant`

Delete Flow Variant · Destructive

Delete a flow variant. A flow showing it falls back to no default.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the flow variant to delete.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removescreen`

Delete Screen · Destructive

Delete a screen with its variants and their comments.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the screen to delete with its variants and their comments.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removestyle`

Delete Saved Style · Destructive

Delete a saved style. Flows and screens that used it go back to their app's design system.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the saved style to delete.

Example input: `{"id":"<id>"}`

### `artistomcp_designs_removevariant`

Delete Variant · Destructive

Delete a variant. A screen showing it falls back to its oldest remaining variant.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the variant to delete.

Example input: `{"id":"<id>"}`

### `artistomcp_todos_remove`

Delete Todo · Destructive

Delete a todo permanently.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): UUID of the todo to delete.

Example input: `{"id":"<id>"}`

### `artistomcp_uploads_delete`

Delete Uploaded Image · Destructive

Delete one of the caller's uploaded images from storage and the database; a profile using it as avatar or cover loses that image.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the uploaded image to delete from storage.

Example input: `{"id":"<id>"}`

## Related

Other Design connectors ([all 34](/agentkit/connectors/?category=design)):

- [Figma](/agentkit/connectors/figma/): Scalekit connector, OAuth, 54 tools
- [Miro](/agentkit/connectors/miro/): Scalekit connector, OAuth, 115 tools
- [Mural](/agentkit/connectors/mural/): Scalekit connector, OAuth, 61 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
