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.
- Tools
- 81
- What they doRead · write · destructive
- 34 · 33 · 1434 read33 write14 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Artisto MCP connection
In AgentKit > Connections, create an Artisto MCP connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'artistomcp'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'artistomcp_users_me',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "artistomcp"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="artistomcp_users_me",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Artisto MCP server credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolartistomcp_billing_stateGet the caller's billing state from Polar: active subscriptions, granted benefits, and isPro (holds the Pro benefit).Read-onlyGet Billing State
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.
Inputs
This tool takes no inputs.
artistomcp_chats_byidGet one of the caller's chats with its messages, oldest first, or null.Read-onlyGet Chat
Get one of the caller's chats with its messages, oldest first, or null.
Inputs
idstringrequired- ID of the chat to fetch.
artistomcp_chats_folderbyidGet one of the caller's chat folders by id, or null.Read-onlyGet Chat Folder
Get one of the caller's chat folders by id, or null.
Inputs
idstringrequired- ID of the chat folder to fetch.
artistomcp_chats_foldersList the caller's chat folders in their sort order.Read-onlyList Chat Folders
List the caller's chat folders in their sort order.
Inputs
This tool takes no inputs.
artistomcp_chats_mineList the caller's chats without messages: pinned first, then most recently updated.Read-onlyList My Chats
List the caller's chats without messages: pinned first, then most recently updated.
Inputs
This tool takes no inputs.
artistomcp_designs_appGet one of the caller's design apps by id with its brief and design system (theme CSS, DESIGN.md, fonts, devices, appearance), or null.Read-onlyGet Design App
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.
Inputs
idstringrequired- UUID of the design app to fetch.
artistomcp_designs_appsList the caller's design apps, newest first.Read-onlyList Design Apps
List the caller's design apps, newest first.
Inputs
This tool takes no inputs.
artistomcp_designs_appsystemGet one of the caller's apps by appId with its current design system, or null.Read-onlyGet App Design System
Get one of the caller's apps by appId with its current design system, or null.
Inputs
appIdstringrequired- UUID of the design app.
artistomcp_designs_assetsList the images of one of the caller's apps (brand sheets, screen concepts, references) with their prompts.Read-onlyList App Images
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>.
Inputs
appIdstringrequired- UUID of the design app.
artistomcp_designs_commentGet one of the caller's review comments by id, or null.Read-onlyGet Review Comment
Get one of the caller's review comments by id, or null.
Inputs
idstringrequired- UUID of the review comment to fetch.
artistomcp_designs_commentsList the review comments on one of the caller's apps, oldest first.Read-onlyList Review Comments
List the review comments on one of the caller's apps, oldest first. Address open ones, then resolve them.
Inputs
appIdstringrequired- UUID of the design app.
artistomcp_designs_componentGet one of the caller's components by id with its code and variants, or null.Read-onlyGet Component
Get one of the caller's components by id with its code and variants, or null.
Inputs
idstringrequired- UUID of the component to fetch.
artistomcp_designs_componentsList the reusable components of one of the caller's apps, by name: each one's TSX code, description and variants ([{ name, code }]).Read-onlyList Components
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".
Inputs
appIdstringrequired- UUID of the design app.
artistomcp_designs_contextRead 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).Read-onlyGet Design Context
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.
Inputs
appIdstring- UUID of an app. Pass screenId, flowId or appId; the most specific one wins.
flowIdstring- UUID of a flow. Pass screenId, flowId or appId; the most specific one wins.
screenIdstring- UUID of a screen. Pass screenId, flowId or appId; the most specific one wins.
artistomcp_designs_flowGet one of the caller's flows by id, or null.Read-onlyGet Flow
Get one of the caller's flows by id, or null.
Inputs
idstringrequired- UUID of the flow to fetch.
artistomcp_designs_flowsList the flows (user journeys such as checkout or onboarding) of one of the caller's apps, in order.Read-onlyList Flows
List the flows (user journeys such as checkout or onboarding) of one of the caller's apps, in order.
Inputs
appIdstringrequired- UUID of the design app.
artistomcp_designs_flowvariantGet one of the caller's flow variants by id, or null.Read-onlyGet Flow Variant
Get one of the caller's flow variants by id, or null.
Inputs
idstringrequired- UUID of the flow variant to fetch.
artistomcp_designs_flowvariantsList the variants of one of the caller's flows (alternative versions of the journey), oldest first.Read-onlyList Flow Variants
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.
Inputs
flowIdstringrequired- UUID of the flow.
artistomcp_designs_guideRead Artisto's design guide (Markdown).Read-onlyRead Design Guide
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.
Inputs
appIdstring- Optional UUID of an app whose brief and DESIGN.md are appended to the guide.
topicstring- Guide topic: workflow, kit, components, rules, system or flows. Omit for the whole guide.one of
workflowkitcomponentsrulessystemflows
artistomcp_designs_lintvariantCheck 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).Read-onlyLint Variant
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.
Inputs
idstringrequired- UUID of the screen variant to lint.
artistomcp_designs_screenGet one of the caller's screens by id, or null.Read-onlyGet Screen
Get one of the caller's screens by id, or null.
Inputs
idstringrequired- UUID of the screen to fetch.
artistomcp_designs_screenlintedGet one of the caller's screens with the lint warnings of its first variant, or null.Read-onlyGet Screen with Lint Warnings
Get one of the caller's screens with the lint warnings of its first variant, or null.
Inputs
idstringrequired- UUID of the screen to fetch with lint warnings.
variantIdstringrequired- UUID of the screen variant whose lint warnings to return.
artistomcp_designs_screensList the screens of one of the caller's apps, with slug, canvas position, devices, spec and selected variant.Read-onlyList Screens
List the screens of one of the caller's apps, with slug, canvas position, devices, spec and selected variant.
Inputs
appIdstringrequired- UUID of the design app.
artistomcp_designs_styleGet one of the caller's saved design styles by id, or null.Read-onlyGet Saved Style
Get one of the caller's saved design styles by id, or null.
Inputs
idstringrequired- UUID of the saved style to fetch.
artistomcp_designs_stylesList the caller's saved design styles (theme CSS, DESIGN.md, fonts), by name.Read-onlyList Saved Styles
List the caller's saved design styles (theme CSS, DESIGN.md, fonts), by name.
Inputs
This tool takes no inputs.
artistomcp_designs_variantGet one of the caller's screen variants by id, with its TSX source, or null.Read-onlyGet Variant
Get one of the caller's screen variants by id, with its TSX source, or null.
Inputs
idstringrequired- UUID of the screen variant to fetch.
artistomcp_designs_variantlintedGet one of the caller's variants with its lint warnings, or null.Read-onlyGet Variant with Lint Warnings
Get one of the caller's variants with its lint warnings, or null.
Inputs
idstringrequired- UUID of the screen variant to fetch with lint warnings.
artistomcp_designs_variantsList every variant (TSX source included) of the screens of one of the caller's apps.Read-onlyList Variants
List every variant (TSX source included) of the screens of one of the caller's apps.
Inputs
appIdstringrequired- UUID of the design app.
artistomcp_todos_archivedList the caller's archived todos, newest first.Read-onlyList Archived Todos
List the caller's archived todos, newest first.
Inputs
This tool takes no inputs.
artistomcp_todos_byidGet one of the caller's todos by id, or null.Read-onlyGet Todo
Get one of the caller's todos by id, or null.
Inputs
idstringrequired- UUID of the todo to fetch.
artistomcp_todos_exportExport the caller's active and paused todos as a Markdown checklist.Read-onlyExport Todos
Export the caller's active and paused todos as a Markdown checklist.
Inputs
This tool takes no inputs.
artistomcp_todos_mineList the caller's active and paused todos, newest first.Read-onlyList My Todos
List the caller's active and paused todos, newest first.
Inputs
This tool takes no inputs.
artistomcp_users_meGet the caller's own profile: name, email, username, bio, timezone, role, onboarding state, raw preferences, and the avatar and cover images (UploadThing keys).Read-onlyGet My Profile
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.
Inputs
This tool takes no inputs.
artistomcp_users_verificationemailstatusGet whether the caller can request another verification email and when (ISO time); null when verification is off or the email is already verified.Read-onlyGet Verification Email Status
Get whether the caller can request another verification email and when (ISO time); null when verification is off or the email is already verified.
Inputs
This tool takes no inputs.
artistomcp_chats_createStart a chat and return it.WriteCreate Chat
Start a chat and return it. Defaults: title 'New chat', intelligence 'standard'.
Inputs
folderIdstring- Folder to create the chat in, or null for no folder.
idstring- Optional ID for the new chat; generated when omitted.
intelligencestring- Intelligence level for the chat: standard, low, medium or high.one of
standardlowmediumhigh modelIdstring- AI model ID for the chat, or null for the default.
providerIdstring- AI provider ID for the chat (for example openai or anthropic), or null for the default.
titlestring- Chat title (1-120 characters). Defaults to 'New chat'.
artistomcp_chats_createfolderCreate a chat folder at the end of the caller's folder list and return it.WriteCreate Chat Folder
Create a chat folder at the end of the caller's folder list and return it.
Inputs
namestringrequired- Name of the new chat folder (1-80 characters).
idstring- Optional ID for the new folder; generated when omitted.
artistomcp_chats_movetofolderMove a chat into one of the caller's folders, or out of any folder with null, and return it.WriteMove Chat to Folder
Move a chat into one of the caller's folders, or out of any folder with null, and return it.
- Idempotent
Inputs
folderIdstringrequired- Folder to move the chat into, or null to take it out of any folder.
idstringrequired- ID of the chat to move.
artistomcp_chats_renameRename a chat and return it.WriteRename Chat
Rename a chat and return it.
- Idempotent
Inputs
idstringrequired- ID of the chat to rename.
titlestringrequired- New chat title (1-120 characters).
artistomcp_chats_renamefolderRename a chat folder and return it.WriteRename Chat Folder
Rename a chat folder and return it.
- Idempotent
Inputs
idstringrequired- ID of the chat folder to rename.
namestringrequired- New name for the chat folder (1-80 characters).
artistomcp_chats_setpinnedPin a chat to the top of the list, or unpin it, and return it.WritePin or Unpin Chat
Pin a chat to the top of the list, or unpin it, and return it.
- Idempotent
Inputs
idstringrequired- ID of the chat to pin or unpin.
pinnedbooleanrequired- true to pin the chat to the top of the list, false to unpin it.
artistomcp_chats_updatesettingsChange a chat's AI provider, model or intelligence level (only the fields given), and return it.WriteUpdate Chat Settings
Change a chat's AI provider, model or intelligence level (only the fields given), and return it.
- Idempotent
Inputs
idstringrequired- ID of the chat whose settings change.
intelligencestring- Intelligence level for the chat: standard, low, medium or high.one of
standardlowmediumhigh modelIdstring- AI model ID for the chat, or null for the default.
providerIdstring- AI provider ID for the chat (for example openai or anthropic), or null for the default.
artistomcp_designs_addcommentPin a review comment to one or more points, areas or elements of a variant (coordinates are fractions of the frame) and return it.WriteAdd Review Comment
Pin a review comment to one or more points, areas or elements of a variant (coordinates are fractions of the frame) and return it.
Inputs
appIdstringrequired- UUID of the design app.
devicestringrequired- Device frame the comment was made on, or null.
targetsarrayrequired- 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.
textstringrequired- The review comment (1-4000 characters).
variantIdstringrequired- UUID of the screen variant the comment is pinned to.
idstring- Optional UUID for the new comment; generated when omitted.
artistomcp_designs_applystyleMake 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).WriteApply Saved Style to App
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.
- Idempotent
Inputs
appIdstringrequired- UUID of the design app.
styleIdstringrequired- UUID of the saved style to copy into the app's design system.
artistomcp_designs_createappCreate a design app (a product: its design system, screens and flows) and return it.WriteCreate Design App
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.
Inputs
descriptionstringrequired- One-line description of the app (up to 2000 characters).
namestringrequired- Name of the design app (1-200 characters).
appearancestring- Default appearance: light or dark.one of
lightdark briefstring- Long Markdown brief: what the app is, who it is for and its philosophy.
designMdstring- The design system's DESIGN.md (Markdown).
devicesarray- Devices the app is designed for (1-5 of mobile, foldable, tablet, desktop, wide).
fontsarray- Google font families (up to 20).
idstring- Optional UUID for the new app; generated when omitted.
themeCssstring- shadcn theme CSS with tokens for :root and .dark.
artistomcp_designs_createcomponentAdd a reusable component to one of the caller's apps and return it.WriteCreate Component
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 <Button variant="ghost">Cancel</Button> (all project components are in scope) or a module with a default export. Starter code and one "default" variant when omitted.
Inputs
appIdstringrequired- UUID of the design app.
namestringrequired- PascalCase export name that screens import from @project/components.
codestring- TSX module exporting the component (imports: react, @kit, lucide-react, @project/components). Starter code is used when omitted.
descriptionstring- What the component is for (up to 4000 characters).
idstring- Optional UUID for the new component; generated when omitted.
variantsarray- Named states of the component, each with a name and a JSX snippet or module. One 'default' variant is created when omitted.
artistomcp_designs_createflowAdd 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).WriteCreate Flow
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.
Inputs
appIdstringrequired- UUID of the design app.
namestringrequired- Name of the flow (1-200 characters).
stepsarrayrequired- 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.
descriptionstring- The flow's brief in Markdown: the journey's goal, who takes it, what must happen.
idstring- Optional UUID for the new flow; generated when omitted.
sortOrderinteger- Position of the flow in the app's flow list.
variantIdstring- Optional UUID for the flow's first variant ('original'); generated when omitted.
artistomcp_designs_createflowvariantAdd an alternative version of a flow: a name and its steps ([{ screenId, variantId }]; screens may differ, be reordered, or show other screen variants).WriteCreate Flow Variant
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.
Inputs
flowIdstringrequired- UUID of the flow.
namestringrequired- Name of the flow variant (1-200 characters).
stepsarrayrequired- 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.
idstring- Optional UUID for the new flow variant; generated when omitted.
artistomcp_designs_createscreenAdd 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.WriteCreate Screen
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 <Go to="<slug>">.
Inputs
appIdstringrequired- UUID of the design app.
namestringrequired- Name of the screen (1-200 characters).
slugstringrequired- URL-safe screen slug (lowercase letters, digits and hyphens, up to 64). Other screens link to it with <Go to="slug">.
xintegerrequired- Horizontal position of the screen on the canvas, in pixels.
yintegerrequired- Vertical position of the screen on the canvas, in pixels.
codestring- TSX for the first variant, with a default export importing only react, @kit and lucide-react. Starter code is used when omitted.
idstring- Optional UUID for the new screen; generated when omitted.
specstring- The screen's brief in Markdown: what this screen is for, its content and states.
variantIdstring- Optional UUID for the screen's first variant; generated when omitted.
artistomcp_designs_createstyleSave a design style (shadcn theme CSS for :root and .dark, DESIGN.md, Google fonts) to the caller's style library.WriteCreate Saved Style
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.
Inputs
namestringrequired- Name of the saved style (1-200 characters).
descriptionstring- Description of the style (up to 4000 characters).
designMdstring- The design system's DESIGN.md (Markdown).
fontsarray- Google font families (up to 20).
fromAppIdstring- Optional UUID of an app whose current design system fills any field not given.
idstring- Optional UUID for the new style; generated when omitted.
themeCssstring- shadcn theme CSS with tokens for :root and .dark.
artistomcp_designs_createvariantAdd 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.WriteCreate Variant
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`.
Inputs
codestringrequired- TSX with a default export, importing only react, @kit and lucide-react.
namestringrequired- Name of the variant (1-200 characters).
screenIdstringrequired- UUID of the screen.
idstring- Optional UUID for the new variant; generated when omitted.
overridesobject- Optional map from a device, appearance or device:appearance (mobile, dark, desktop:dark) to TSX rendered there instead of the base code.
artistomcp_designs_generateimageGenerate 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.WriteGenerate App Image
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>.
Inputs
appIdstringrequired- UUID of the design app.
kindstringrequired- Image kind: brand (identity sheet), concept (a screen or flow to code from) or reference.one of
brandconceptreference namestringrequired- Name of the generated image (1-200 characters).
promptstringrequired- What to generate (1-8000 characters).
referenceAssetIdsarray- Up to 4 UUIDs of the app's images that steer the style.
sizestring- Image size in pixels.one of
1024x10241536x10241024x1536 useDesignSystemboolean- When true (default), the app's DESIGN.md and theme tokens are appended to the prompt.
artistomcp_designs_resolvecommentMark a review comment resolved or open again, and return it.WriteResolve or Reopen Review Comment
Mark a review comment resolved or open again, and return it.
- Idempotent
Inputs
idstringrequired- UUID of the review comment to resolve or reopen.
resolvedbooleanrequired- true to mark the comment resolved, false to reopen it.
artistomcp_designs_setcomponentvariantAdd or replace one named variant (state) of a component, e.g.WriteSet Component Variant
Add or replace one named variant (state) of a component, e.g. { name: "disabled", code: "<Button disabled>Save</Button>" }, and return the component.
- Idempotent
Inputs
codestringrequired- JSX snippet or module for this variant.
idstringrequired- UUID of the component whose variant to add or replace.
namestringrequired- Name of the component variant (state) to add or replace (1-60 characters).
artistomcp_designs_setvariantoverrideGive 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.WriteSet Variant Override
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.
- Idempotent
Inputs
codestringrequired- TSX rendered for that target instead of the base code, or null to remove the override.
idstringrequired- UUID of the variant to give an override.
targetstringrequired- Device, appearance or device:appearance the override applies to.one of
mobilefoldabletabletdesktopwidelightdarkmobile:lightmobile:darkfoldable:lightfoldable:darktablet:lighttablet:darkdesktop:lightdesktop:darkwide:lightwide:dark
artistomcp_designs_updateappChange 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.WriteUpdate Design App
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.
- Idempotent
Inputs
idstringrequired- UUID of the design app to change.
appearancestring- Default appearance: light or dark.one of
lightdark briefstring- Long Markdown brief: what the app is, who it is for and its philosophy. Screen-specific text goes in each screen's spec.
descriptionstring- One-line description of the app (up to 2000 characters).
designMdstring- The design system's DESIGN.md (Markdown).
devicesarray- Devices the app is designed for (1-5 of mobile, foldable, tablet, desktop, wide).
fontsarray- Google font families (up to 20).
namestring- New name of the design app (1-200 characters).
themeCssstring- shadcn theme CSS with tokens for :root and .dark.
artistomcp_designs_updateassetRename an app image, change its kind (brand, concept, reference) or its recorded prompt.WriteUpdate App Image
Rename an app image, change its kind (brand, concept, reference) or its recorded prompt.
- Idempotent
Inputs
idstringrequired- UUID of the app image to change.
kindstring- Image kind: brand (identity sheet), concept (a screen or flow to code from) or reference.one of
brandconceptreference namestring- New name of the app image (1-200 characters).
promptstring- The prompt recorded for the image (up to 8000 characters).
artistomcp_designs_updatecomponentChange a component's name, description, TSX code or its whole variants list, and return it.WriteUpdate Component
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.
- Idempotent
Inputs
idstringrequired- UUID of the component to change.
codestring- New TSX module exporting the component.
descriptionstring- What the component is for (up to 4000 characters).
namestring- New PascalCase export name of the component.
variantsarray- Replaces the component's whole variants list; each has a name and a JSX snippet or module.
artistomcp_designs_updateflowRename 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.WriteUpdate Flow
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.
- Idempotent
Inputs
idstringrequired- UUID of the flow to change.
descriptionstring- The flow's brief in Markdown: the journey's goal, who takes it, what must happen.
namestring- New name of the flow (1-200 characters).
selectedVariantIdstring- UUID of the flow variant shown by default.
sortOrderinteger- New position of the flow in the app's flow list.
styleIdstring- UUID of a saved style the flow's screens render with, or null to use the app's design system.
artistomcp_designs_updateflowvariantRename a flow variant, replace its steps or set its liked flag.WriteUpdate Flow Variant
Rename a flow variant, replace its steps or set its liked flag. Returns the flow variant.
- Idempotent
Inputs
idstringrequired- UUID of the flow variant to change.
likedboolean- Whether the flow variant is marked as liked.
namestring- New name of the flow variant (1-200 characters).
stepsarray- 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.
artistomcp_designs_updatescreenChange 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.WriteUpdate Screen
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.
- Idempotent
Inputs
idstringrequired- UUID of the screen to change.
devicesstring- Devices the screen is designed for, or null for all of the app's devices.
namestring- New name of the screen (1-200 characters).
selectedVariantIdstring- UUID of the variant the screen shows.
slugstring- New URL-safe screen slug (lowercase letters, digits and hyphens, up to 64).
specstring- The screen's brief in Markdown: what this screen is for, its content and states.
styleIdstring- UUID of a saved style this screen renders with, or null to use the app's design system.
xinteger- Horizontal position of the screen on the canvas, in pixels.
yinteger- Vertical position of the screen on the canvas, in pixels.
artistomcp_designs_updatestyleChange a saved style's name, description, theme CSS, DESIGN.md or fonts.WriteUpdate Saved Style
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.
- Idempotent
Inputs
idstringrequired- UUID of the saved style to change.
descriptionstring- Description of the style (up to 4000 characters).
designMdstring- The design system's DESIGN.md (Markdown).
fontsarray- Google font families (up to 20).
namestring- New name of the saved style (1-200 characters).
themeCssstring- shadcn theme CSS with tokens for :root and .dark.
artistomcp_designs_updatevariantChange a variant's name, TSX code, liked flag or whole overrides map, and return it with lint warnings to fix.WriteUpdate Variant
Change a variant's name, TSX code, liked flag or whole overrides map, and return it with lint warnings to fix.
- Idempotent
Inputs
idstringrequired- UUID of the variant to change.
codestring- New TSX for the variant, with a default export importing only react, @kit and lucide-react.
likedboolean- Whether the variant is marked as liked.
namestring- New name of the variant (1-200 characters).
overridesobject- Replaces the whole overrides map: device, appearance or device:appearance to TSX rendered there instead of the base code.
artistomcp_designs_uploadimageStore 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.WriteUpload App Image
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.
Inputs
appIdstringrequired- UUID of the design app.
dataBase64stringrequired- The image bytes, base64-encoded (PNG, JPEG or WebP, up to 8 MB).
kindstringrequired- Image kind: brand (identity sheet), concept (a screen or flow to code from) or reference.one of
brandconceptreference mimeTypestringrequired- Image format of the uploaded data.one of
image/pngimage/jpegimage/webp namestringrequired- Name of the uploaded image (1-200 characters).
promptstring- The prompt that made the image, if any (up to 8000 characters).
artistomcp_todos_createCreate a todo and return it.WriteCreate Todo
Create a todo and return it. The id is generated when omitted.
Inputs
titlestringrequired- The todo text (1-500 characters).
idstring- Optional UUID for the new todo; generated when omitted.
artistomcp_todos_planSet the day a todo is planned for (YYYY-MM-DD), or null to unplan it, and return it.WritePlan Todo
Set the day a todo is planned for (YYYY-MM-DD), or null to unplan it, and return it.
- Idempotent
Inputs
idstringrequired- UUID of the todo to plan.
plannedForstringrequired- Day the todo is planned for (YYYY-MM-DD), or null to unplan it.
artistomcp_todos_setdoneMark a todo done or not done, and return it.WriteSet Todo Done
Mark a todo done or not done, and return it.
- Idempotent
Inputs
donebooleanrequired- true to mark the todo done, false to mark it not done.
idstringrequired- UUID of the todo to mark done or not done.
artistomcp_todos_setstatusPause, archive or reactivate a todo, and return it.WriteSet Todo Status
Pause, archive or reactivate a todo, and return it. Archived todos drop out of todos.mine.
- Idempotent
Inputs
idstringrequired- UUID of the todo whose status changes.
statusstringrequired- New status: active, paused or archived.one of
activepausedarchived
artistomcp_chats_deletefolderDelete a chat folder.DestructiveDelete Chat Folder
Delete a chat folder. Its chats are kept and move out of the folder.
- Idempotent
Inputs
idstringrequired- ID of the chat folder to delete. Its chats are kept.
artistomcp_chats_removeDelete a chat and all of its messages permanently.DestructiveDelete Chat
Delete a chat and all of its messages permanently.
- Idempotent
Inputs
idstringrequired- ID of the chat to delete with all its messages.
artistomcp_designs_removeappDelete a design app with all its screens, variants, flows, comments and images.DestructiveDelete Design App
Delete a design app with all its screens, variants, flows, comments and images.
- Idempotent
Inputs
idstringrequired- UUID of the design app to delete with all its screens, variants, flows, comments and images.
artistomcp_designs_removeassetDelete an app image.DestructiveDelete App Image
Delete an app image.
- Idempotent
Inputs
idstringrequired- UUID of the app image to delete.
artistomcp_designs_removecommentDelete a review comment.DestructiveDelete Review Comment
Delete a review comment.
- Idempotent
Inputs
idstringrequired- UUID of the review comment to delete.
artistomcp_designs_removecomponentDelete a component.DestructiveDelete Component
Delete a component. Screens that import it fail to render until they stop importing it.
- Idempotent
Inputs
idstringrequired- UUID of the component to delete.
artistomcp_designs_removecomponentvariantRemove one named variant from a component and return the component.DestructiveRemove Component Variant
Remove one named variant from a component and return the component.
- Idempotent
Inputs
idstringrequired- UUID of the component to remove a variant from.
namestringrequired- Name of the component variant to remove.
artistomcp_designs_removeflowDelete a flow and its variants.DestructiveDelete Flow
Delete a flow and its variants. Its screens stay in the app.
- Idempotent
Inputs
idstringrequired- UUID of the flow to delete with its variants.
artistomcp_designs_removeflowvariantDelete a flow variant.DestructiveDelete Flow Variant
Delete a flow variant. A flow showing it falls back to no default.
- Idempotent
Inputs
idstringrequired- UUID of the flow variant to delete.
artistomcp_designs_removescreenDelete a screen with its variants and their comments.DestructiveDelete Screen
Delete a screen with its variants and their comments.
- Idempotent
Inputs
idstringrequired- UUID of the screen to delete with its variants and their comments.
artistomcp_designs_removestyleDelete a saved style.DestructiveDelete Saved Style
Delete a saved style. Flows and screens that used it go back to their app's design system.
- Idempotent
Inputs
idstringrequired- UUID of the saved style to delete.
artistomcp_designs_removevariantDelete a variant.DestructiveDelete Variant
Delete a variant. A screen showing it falls back to its oldest remaining variant.
- Idempotent
Inputs
idstringrequired- UUID of the variant to delete.
artistomcp_todos_removeDelete a todo permanently.DestructiveDelete Todo
Delete a todo permanently.
- Idempotent
Inputs
idstringrequired- UUID of the todo to delete.
artistomcp_uploads_deleteDelete one of the caller's uploaded images from storage and the database; a profile using it as avatar or cover loses that image.DestructiveDelete Uploaded Image
Delete one of the caller's uploaded images from storage and the database; a profile using it as avatar or cover loses that image.
- Idempotent
Inputs
idstringrequired- ID of the uploaded image to delete from storage.
No tools match.