AppScreenStudio
Design App Store and Google Play screenshots with your AI agent in the AppScreenStudio editor.
Should I use this
Quality & Safety
A
Findings (1)
- LOWTool 'report_mcp_feedback' description lacks action verbin report_mcp_feedback
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~8,368Tokens (tool definitions)
~1.6 KBTypical response size
Significant attention impact (6.54% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"app-screen-studio": {
"url": "https://www.appscreenstudio.com/api/mcp"
}
}
}Remote endpoints
https://www.appscreenstudio.com/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (49)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟡get_editor_snapshot(platform, platformSetId)
Read one platform of the open editor. Pass platform or platformSetId to include that set's screenshots. With no argument, a project with one platform set returns that set. A project with more than one set returns the set directory and screenshotsOmitted, without screenshot bodies. Call again with platform or an id from that directory.
Input Schema
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"ios",
"android",
"social"
],
"description": "Open every set of this platform. Use this when you know the store and not the set id."
},
"platformSetId": {
"type": "string",
"description": "Open this set. Ids come from a snapshot that omitted screenshots."
}
},
"required": [],
"additionalProperties": false
}🟡update_text(screenshotId, textId, content, color, fontSize, ...)
Update a text layer on a screenshot in the open editor.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"textId": {
"type": "string"
},
"content": {
"type": "string"
},
"color": {
"type": "string",
"description": "CSS color, such as #ffffff"
},
"fontSize": {
"type": "number",
"description": "Font size in CSS pixels on the 500px-tall editor canvas."
},
"fontWeight": {
"type": "string"
},
"fontFamily": {
"type": "string",
"description": "Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font."
},
"lineHeight": {
"type": "number",
"description": "Multiplier of the font size"
},
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"align": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"rotation": {
"type": "number"
},
"backgroundColor": {
"type": "string"
},
"borderColor": {
"type": "string"
},
"borderRadius": {
"type": "number"
},
"textShadowEnabled": {
"type": "boolean"
},
"textShadowColor": {
"type": "string"
},
"textShadowBlur": {
"type": "number"
},
"textShadowOffsetX": {
"type": "number"
},
"textShadowOffsetY": {
"type": "number"
}
},
"required": [
"screenshotId",
"textId"
],
"additionalProperties": false
}🟡add_text(screenshotId, content, color, fontSize, fontWeight, ...)
Add a text layer to a screenshot in the open editor.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"content": {
"type": "string"
},
"color": {
"type": "string",
"description": "CSS color, such as #ffffff"
},
"fontSize": {
"type": "number",
"description": "Font size in CSS pixels on the 500px-tall editor canvas."
},
"fontWeight": {
"type": "string"
},
"fontFamily": {
"type": "string",
"description": "Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font."
},
"lineHeight": {
"type": "number",
"description": "Multiplier of the font size"
},
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"align": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"rotation": {
"type": "number"
},
"backgroundColor": {
"type": "string"
},
"borderColor": {
"type": "string"
},
"borderRadius": {
"type": "number"
},
"textShadowEnabled": {
"type": "boolean"
},
"textShadowColor": {
"type": "string"
},
"textShadowBlur": {
"type": "number"
},
"textShadowOffsetX": {
"type": "number"
},
"textShadowOffsetY": {
"type": "number"
}
},
"required": [
"screenshotId",
"content"
],
"additionalProperties": false
}🔴remove_text(screenshotId, textId)
Remove a text layer from a screenshot in the open editor.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"textId": {
"type": "string"
}
},
"required": [
"screenshotId",
"textId"
],
"additionalProperties": false
}🔴add_screenshot(platformSetId)
Add a card to the end of a platform set. The card is not blank: the set's first three cards get the template's sample texts and phone placement (sometimes a hidden or tilted phone), and later cards copy every layer of the set's last card without its phone image. Returns the ids of those layers so you can update or remove them.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
}
},
"required": [
"platformSetId"
],
"additionalProperties": false
}🟡update_screenshot(screenshotId, backgroundColor, backgroundImage, backgroundImageBlur, imageX, ...)
Update a card and its main phone: background, phone placement and app screen, pattern, fade, or shadow. imageUrl is the app screen inside the phone (upload_image with type screenshot). The phone model is chosen per platform set with set_device.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"backgroundColor": {
"type": "string"
},
"backgroundImage": {
"type": "string"
},
"backgroundImageBlur": {
"type": "number",
"enum": [
0,
1,
2,
3
]
},
"imageX": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card."
},
"imageY": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card. Positive moves down."
},
"imageScale": {
"type": "number"
},
"imageUrl": {
"type": "string"
},
"foldAmount": {
"type": "number",
"description": "Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"phoneColor": {
"type": "string",
"description": "This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color."
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"imageDisabled": {
"type": "boolean"
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"rotationX": {
"type": "number",
"description": "Tilt in degrees (top away from the viewer). 3D frames only."
},
"rotationY": {
"type": "number",
"description": "Turn in degrees (right side away from the viewer). 3D frames only."
},
"rotationZ": {
"type": "number",
"description": "The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation)."
},
"backgroundPatternId": {
"type": "string"
},
"backgroundPatternColor": {
"type": "string"
},
"hideCardOverflow": {
"type": "boolean"
},
"focusOverlayEnabled": {
"type": "boolean"
},
"focusOverlayBlurBackground": {
"type": "boolean"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayOffsetY": {
"type": "number",
"description": "Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000."
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadeHeight": {
"type": "number"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadePosition": {
"type": "string",
"enum": [
"top",
"bottom"
]
},
"shadowEnabled": {
"type": "boolean"
},
"shadowColor": {
"type": "string"
},
"shadowBlur": {
"type": "number"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
}
},
"required": [
"screenshotId"
],
"additionalProperties": false
}🔴remove_screenshot(screenshotId)
Remove a screenshot from the open editor.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
}
},
"required": [
"screenshotId"
],
"additionalProperties": false
}🟡add_asset(screenshotId, src, x, y, width, ...)
Add an image layer to a card. src is an image URL, such as one from upload_image or list_library. Pass spriteCoordinate to crop one pose of a sprite sheet.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"src": {
"type": "string"
},
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"rotation": {
"type": "number",
"description": "Degrees, clockwise."
},
"spriteCoordinate": {
"type": "object",
"description": "Crop rectangle on the source image, in source pixels. Use a pose from list_library.",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"x",
"y",
"width",
"height"
]
}
},
"required": [
"screenshotId",
"src"
],
"additionalProperties": false
}🟡update_asset(screenshotId, assetId, src, x, y, ...)
Update an image layer on a screenshot in the open editor.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"assetId": {
"type": "string"
},
"src": {
"type": "string"
},
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"rotation": {
"type": "number"
}
},
"required": [
"screenshotId",
"assetId"
],
"additionalProperties": false
}🔴remove_asset(screenshotId, assetId)
Remove an image layer from a screenshot in the open editor.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"assetId": {
"type": "string"
}
},
"required": [
"screenshotId",
"assetId"
],
"additionalProperties": false
}🟡add_div(screenshotId, x, y, width, height, ...)
Add a box layer to a card. Pass html to draw a custom card: width and height set its layout box, and every visible style goes in the html, since backgroundColor and borderRadius only style plain boxes without html. A style element stays inside the card.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"backgroundColor": {
"type": "string"
},
"borderRadius": {
"type": "number"
},
"opacity": {
"type": "number"
},
"scale": {
"type": "number",
"description": "Visual multiplier from the center, 0.1 to 4. The html keeps its layout size and does not reflow. 1 is natural size."
},
"rotationX": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"rotationY": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"rotationZ": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"html": {
"type": "string",
"description": "Custom card HTML, up to 8000 characters. Image src and CSS url() must be URLs from upload_image with type asset; data: URLs are rejected. font-family can use built-in editor fonts and fonts added with add_project_font; @import and external stylesheets are rejected. Mark everything a user may want to change, so the editor's Content panel can edit it and AI translation translates it: data-edit=\"text\" on each element whose words change (headlines, labels, list rows, numbers; put it on the innermost element holding the words; line breaks are <br>), data-edit=\"image\" on an <img> or on an element with a CSS background-image, data-edit-color=\"--accent\" on an element whose style sets that CSS variable (use it as var(--accent); comma-separate several), data-edit-list on a container whose direct children are repeatable items (rows, bullets, cards), with data-max (default 12) and data-min (default 1). data-label names a field or list in the panel. Text in unmarked elements is not translated."
},
"layer": {
"type": "string",
"enum": [
"front",
"back"
],
"description": "front paints above the phone and image layers, back paints behind the phone. Text layers always paint above both. Defaults to front for html cards and back for plain boxes."
}
},
"required": [
"screenshotId",
"width",
"height"
],
"additionalProperties": false
}🟡update_div(screenshotId, divId, x, y, width, ...)
Update a box layer on a card.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"divId": {
"type": "string"
},
"x": {
"type": "number",
"description": "Layer center, in percent of the card width from the card center. 50 is the right edge."
},
"y": {
"type": "number",
"description": "Layer center, in percent of the card height from the card center. 50 is the bottom edge."
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"backgroundColor": {
"type": "string"
},
"borderRadius": {
"type": "number"
},
"opacity": {
"type": "number"
},
"scale": {
"type": "number",
"description": "Visual multiplier from the center, 0.1 to 4. The html keeps its layout size and does not reflow. 1 is natural size."
},
"rotationX": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"rotationY": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"rotationZ": {
"type": "number",
"description": "3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat."
},
"html": {
"type": "string",
"description": "New card HTML, with the same rules as add_div html. Empty string clears the card."
},
"layer": {
"type": "string",
"enum": [
"front",
"back"
],
"description": "front paints above the phone and image layers, back paints behind the phone. Text layers always paint above both. Defaults to front for html cards and back for plain boxes."
}
},
"required": [
"screenshotId",
"divId"
],
"additionalProperties": false
}🔴remove_div(screenshotId, divId)
Remove a box layer from a screenshot in the open editor.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"divId": {
"type": "string"
}
},
"required": [
"screenshotId",
"divId"
],
"additionalProperties": false
}🟡add_phone(screenshotId, imageX, imageY, imageScale, imageUrl, ...)
Add another phone to a screenshot card in the open editor. It uses the platform set's device frame and starts next to the main phone with its size, rotation, and shadow. Set imageUrl to an image URL (upload_image with type screenshot). Extra phones paint above the main phone, in the order they were added. Returns phoneId.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"imageX": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card."
},
"imageY": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card. Positive moves down."
},
"imageScale": {
"type": "number"
},
"imageUrl": {
"type": "string"
},
"foldAmount": {
"type": "number",
"description": "Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"phoneColor": {
"type": "string",
"description": "This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color."
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"rotationX": {
"type": "number",
"description": "Tilt in degrees (top away from the viewer). 3D frames only."
},
"rotationY": {
"type": "number",
"description": "Turn in degrees (right side away from the viewer). 3D frames only."
},
"rotationZ": {
"type": "number",
"description": "The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation)."
},
"focusOverlayEnabled": {
"type": "boolean"
},
"focusOverlayBlurBackground": {
"type": "boolean"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayOffsetY": {
"type": "number",
"description": "Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000."
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadeHeight": {
"type": "number"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadePosition": {
"type": "string",
"enum": [
"top",
"bottom"
]
},
"shadowEnabled": {
"type": "boolean"
},
"shadowColor": {
"type": "string"
},
"shadowBlur": {
"type": "number"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
}
},
"required": [
"screenshotId"
],
"additionalProperties": false
}🟡update_phone(screenshotId, phoneId, imageX, imageY, imageScale, ...)
Update an extra phone added with add_phone. Takes the same phone fields as update_screenshot. The main phone is edited with update_screenshot.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"phoneId": {
"type": "string"
},
"imageX": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card."
},
"imageY": {
"type": "number",
"description": "Phone center, in pixels from the card center on the 500px-tall card. Positive moves down."
},
"imageScale": {
"type": "number"
},
"imageUrl": {
"type": "string"
},
"foldAmount": {
"type": "number",
"description": "Foldable devices and laptops only. iphone-duo: 0 is open flat, 1 is closed; imageUrl shows on the inner display. MacBooks (macbook-*): the lid, opening = 120 x (1 - foldAmount) degrees (0 fully open, 0.083 is 110°, 1 closed). A laptop's display stays facing the viewer and its base swings about the hinge, so rotationX below 0 tips the top toward the viewer and shows the keyboard."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"phoneColor": {
"type": "string",
"description": "This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color."
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"rotationX": {
"type": "number",
"description": "Tilt in degrees (top away from the viewer). 3D frames only."
},
"rotationY": {
"type": "number",
"description": "Turn in degrees (right side away from the viewer). 3D frames only."
},
"rotationZ": {
"type": "number",
"description": "The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation)."
},
"focusOverlayEnabled": {
"type": "boolean"
},
"focusOverlayBlurBackground": {
"type": "boolean"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayOffsetY": {
"type": "number",
"description": "Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000."
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadeHeight": {
"type": "number"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadePosition": {
"type": "string",
"enum": [
"top",
"bottom"
]
},
"shadowEnabled": {
"type": "boolean"
},
"shadowColor": {
"type": "string"
},
"shadowBlur": {
"type": "number"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
}
},
"required": [
"screenshotId",
"phoneId"
],
"additionalProperties": false
}🔴remove_phone(screenshotId, phoneId)
Remove an extra phone added with add_phone.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"phoneId": {
"type": "string"
}
},
"required": [
"screenshotId",
"phoneId"
],
"additionalProperties": false
}⚪reorder_element(screenshotId, elementId, kind, direction)
Move a layer one step forward or backward among layers of the same kind. It cannot move a layer across kinds: back to front, cards always paint back divs, phones, image layers, front divs, then texts.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"elementId": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"text",
"asset",
"div"
]
},
"direction": {
"type": "string",
"enum": [
"forward",
"backward"
]
}
},
"required": [
"screenshotId",
"elementId",
"kind",
"direction"
],
"additionalProperties": false
}🟡set_template(templateId)
Set the template of the open project.
Input Schema
{
"type": "object",
"properties": {
"templateId": {
"type": "string",
"enum": [
"minimal",
"gradient",
"geometric",
"wave",
"glass",
"connected"
]
}
},
"required": [
"templateId"
],
"additionalProperties": false
}🟡update_template_color(colorId, value)
Update one color of the open project's template. colorId must be one of the current template's colors: minimal (bg), gradient (from, via, to), geometric (bg, circle1, circle2), wave (from, to, wave), glass (from, to), connected (bg, dots). value is a CSS color such as #22c55e.
Input Schema
{
"type": "object",
"properties": {
"colorId": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"colorId",
"value"
],
"additionalProperties": false
}🟡set_resolution(platformSetId, width, height)
Set the pixel size of a platform set.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"platformSetId",
"width",
"height"
],
"additionalProperties": false
}🟡set_device(platformSetId, deviceId)
Set the device of a platform set. iOS sets take iphone-13-pro, iphone-13-pro-max, iphone-15-pro, iphone-15-pro-max, iphone-17-pro, iphone-17-pro-max, iphone-18-pro, iphone-18-pro-max, iphone-duo, borderless-frame, ipad-pro-12, ipad-pro-13, macbook-air-13, macbook-air-15, macbook-pro-14, macbook-pro-16. Android sets take pixel-8-pro, galaxy-s24-ultra, galaxy-s26-ultra, galaxy-tab-s10, android-borderless-frame. Social sets take any of them. borderless-frame and android-borderless-frame show the screenshot without a phone frame. macbook-air-13, macbook-air-15, macbook-pro-14, macbook-pro-16 are MacBooks: HyperRealistic 3D only, the screenshot fills the display (a 16:10 Mac screenshot loses a sliver at the sides), the lid is set with foldAmount.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
},
"deviceId": {
"type": "string",
"enum": [
"iphone-13-pro",
"iphone-13-pro-max",
"iphone-15-pro",
"iphone-15-pro-max",
"iphone-17-pro",
"iphone-17-pro-max",
"iphone-18-pro",
"iphone-18-pro-max",
"iphone-duo",
"borderless-frame",
"ipad-pro-12",
"ipad-pro-13",
"macbook-air-13",
"macbook-air-15",
"macbook-pro-14",
"macbook-pro-16",
"pixel-8-pro",
"galaxy-s24-ultra",
"galaxy-s26-ultra",
"galaxy-tab-s10",
"android-borderless-frame"
]
}
},
"required": [
"platformSetId",
"deviceId"
],
"additionalProperties": false
}🟡set_phone_color(platformSetId, color)
Set the device color of a platform set. On a HyperRealistic (threeDFrame) set the device shows only its real finishes: pass one of the set's deviceColors ids (see the snapshot); a generic color (black, white, orange, silver, space-gray, blue, purple, red, green) picks the closest real finish.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
},
"color": {
"type": "string",
"description": "A generic color (black, white, orange, silver, space-gray, blue, purple, red, green) or, on a HyperRealistic set, a deviceColors id."
}
},
"required": [
"platformSetId",
"color"
],
"additionalProperties": false
}🟡set_show_notch(platformSetId, show)
Show or hide the notch on a platform set.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
},
"show": {
"type": "boolean"
}
},
"required": [
"platformSetId",
"show"
],
"additionalProperties": false
}🟡set_squircle_frame(platformSetId, enabled)
Enable or disable the squircle frame on a platform set.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
},
"enabled": {
"type": "boolean"
}
},
"required": [
"platformSetId",
"enabled"
],
"additionalProperties": false
}🟡set_link_texts(enabled)
Link or unlink matching text layers across platform sets.
Input Schema
{
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
}
},
"required": [
"enabled"
],
"additionalProperties": false
}⚪rename_project(name)
Rename the open project.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
}🟡undo
Undo the last edit in the open editor.
Input Schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟡redo
Redo the last undone edit in the open editor.
Input Schema
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟡search_google_fonts(query, category, limit)
Search Google Fonts by family name, category, or both. usable is true when the project can already use the family: a built-in editor font or one added with add_project_font.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Part of a family name, such as caveat or mono."
},
"category": {
"type": "string",
"enum": [
"Sans Serif",
"Serif",
"Display",
"Handwriting",
"Monospace"
]
},
"limit": {
"type": "number",
"description": "1 to 50. Defaults to 20."
}
},
"required": [],
"additionalProperties": false
}🟡add_project_font(family)
Add a Google Fonts family to the open project. Then use it as fontFamily on text layers or as font-family in card html. Built-in editor fonts need no adding.
Input Schema
{
"type": "object",
"properties": {
"family": {
"type": "string",
"description": "Exact family name from search_google_fonts, such as Caveat."
}
},
"required": [
"family"
],
"additionalProperties": false
}🟡list_library(kind, page, limit)
List assets or mascots saved on this account (not screenshots or backgrounds). Items with spriteSheet true have poses, crop rectangles for add_asset spriteCoordinate. Also returns one image of up to 10 items with each id beside its picture.
Input Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"asset",
"mascot"
]
},
"page": {
"type": "number",
"description": "Page number, starting at 1. Defaults to 1."
},
"limit": {
"type": "number",
"description": "Page size, 1 to 50. Defaults to 20. Mascots are capped at 10."
}
},
"required": [
"kind"
],
"additionalProperties": false
}🟢get_sprite(imageId)
Return one saved asset or mascot in the same shape as a list_library item, including spriteSheet and poses. Also returns one image of each pose with its index drawn beside it.
Input Schema
{
"type": "object",
"properties": {
"imageId": {
"type": "string"
}
},
"required": [
"imageId"
],
"additionalProperties": false
}🟡generate_asset(prompt, quality, referenceUrl)
Generate an asset sprite with AI and save it to the account library. Spends credits. Returns imageUrl and poses like get_sprite, with a preview of each pose. Does not place it on a card.
Input Schema
{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "What to draw, up to 2000 characters."
},
"quality": {
"type": "string",
"enum": [
"medium",
"high"
]
},
"referenceUrl": {
"type": "string",
"description": "Optional https image URL used as a visual reference."
}
},
"required": [],
"additionalProperties": false
}🟡generate_mascot(prompt, presetId, quality, referenceUrl)
Generate a mascot sprite with AI and save it to the account library. Spends credits. Returns imageUrl and poses like get_sprite, with a preview of each pose. Does not place it on a card.
Input Schema
{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "What to draw, up to 2000 characters. Optional when presetId is set."
},
"presetId": {
"type": "string",
"enum": [
"cute_animal",
"robot",
"fantasy_character",
"business_mascot",
"energy_character",
"space_character",
"gaming_character",
"creative_character"
]
},
"quality": {
"type": "string",
"enum": [
"medium",
"high"
]
},
"referenceUrl": {
"type": "string",
"description": "Optional https image URL used as a visual reference."
}
},
"required": [],
"additionalProperties": false
}⚪generate_background(screenshotId, prompt)
Generate an AI background for one card. Spends credits.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"prompt": {
"type": "string"
}
},
"required": [
"screenshotId"
],
"additionalProperties": false
}🟡update_store_listing(appStore, googlePlay)
Update App Store or Google Play listing fields for the current language. Does not generate copy. Returns the names of the fields written.
Input Schema
{
"type": "object",
"properties": {
"appStore": {
"type": "object"
},
"googlePlay": {
"type": "object"
}
},
"required": [],
"additionalProperties": false
}🟡capture_platform_strip(platformSetId)
Return one JPEG of every card in a platform set side by side, as the editor renders them. Use it to check your edits. Defaults to the first platform set.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
}
},
"required": [],
"additionalProperties": false
}🟡upload_image(type, filename, base64)
Prepare an image upload for the open project. Returns a one-time uploadUrl. POST the image as multipart form field "file" to that URL. The response JSON url is the stored image. Use it with update_screenshot imageUrl, add_asset src, set_project_background, or img src and CSS url() inside add_div or update_div html. For card images, use type asset. The link works once; if the POST fails, call this tool again. Pass base64 only when you cannot make that HTTP request.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"screenshot",
"asset",
"background"
]
},
"filename": {
"type": "string",
"description": "File name, 1 to 120 characters, no path. Use a png, jpg, jpeg, or webp extension. For type asset, svg is also allowed."
},
"base64": {
"type": "string",
"description": "Optional raw base64 or data URL. Omit this and POST the file to uploadUrl."
}
},
"required": [
"type",
"filename"
],
"additionalProperties": false
}🟡duplicate_screenshot(screenshotId)
Duplicate a screenshot and insert the copy immediately after it.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
}
},
"required": [
"screenshotId"
],
"additionalProperties": false
}⚪copy_screenshot(screenshotId, targetPlatformSetId)
Copy a screenshot onto another platform set.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"targetPlatformSetId": {
"type": "string"
}
},
"required": [
"screenshotId",
"targetPlatformSetId"
],
"additionalProperties": false
}⚪move_screenshot(screenshotId, direction)
Move a screenshot left or right within its platform set.
Input Schema
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
},
"direction": {
"type": "string",
"enum": [
"left",
"right"
]
}
},
"required": [
"screenshotId",
"direction"
],
"additionalProperties": false
}🟡set_language(lang)
Switch the open editor to a language that already exists on the project.
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string"
}
},
"required": [
"lang"
],
"additionalProperties": false
}🟡ai_translate(languages)
Add up to 5 languages by translating the open language with the same AI localize flow as the editor. Translates iOS and Android screenshot text and the store listing. Social screenshot text is copied unchanged. Spends credits. Does not switch the open language. Fails when the account cannot spend credits or a code is already on the project.
Input Schema
{
"type": "object",
"properties": {
"languages": {
"type": "array",
"description": "Language codes to add, 1 to 5 unique codes. Examples: tr, de, ja, zh-Hans, pt-BR, es-419, en-GB.",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 5
}
},
"required": [
"languages"
],
"additionalProperties": false
}🟡add_platform_set(platform, name)
Add a platform set to the open project.
Input Schema
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"enum": [
"ios",
"android",
"social"
]
},
"name": {
"type": "string"
}
},
"required": [
"platform"
],
"additionalProperties": false
}🔴remove_platform_set(platformSetId)
Remove an extra platform set. The first set of each platform stays.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
}
},
"required": [
"platformSetId"
],
"additionalProperties": false
}🔴set_project_background(imageUrl, blur)
Set or clear the project background image. Pass an empty imageUrl to clear it.
Input Schema
{
"type": "object",
"properties": {
"imageUrl": {
"type": "string"
},
"blur": {
"type": "number",
"enum": [
0,
1,
2,
3
]
}
},
"required": [
"imageUrl"
],
"additionalProperties": false
}🟡set_realistic_frame(platformSetId, enabled, threeD)
Enable or disable the realistic device frame on a platform set. With threeD true the frame is a 3D device model (HyperRealistic) that also takes rotationX, rotationY, and rotationZ. 3D works on every device except borderless-frame and android-borderless-frame.
Input Schema
{
"type": "object",
"properties": {
"platformSetId": {
"type": "string"
},
"enabled": {
"type": "boolean"
},
"threeD": {
"type": "boolean",
"description": "3D device model instead of the flat realistic frame. Requires enabled true."
}
},
"required": [
"platformSetId",
"enabled"
],
"additionalProperties": false
}⚪report_mcp_feedback(kind, message, toolName)
Report a bug, an unexpected tool result, or a suggestion about these MCP tools, when you notice one.
Input Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"bug",
"unexpected",
"suggestion"
]
},
"message": {
"type": "string"
},
"toolName": {
"type": "string"
}
},
"required": [
"kind",
"message"
],
"additionalProperties": false
}⚪rate_this_mcp(stars, comment)
Rate how well these MCP tools worked for the task you just finished, from 1 to 5 stars. Call it once per task.
Input Schema
{
"type": "object",
"properties": {
"stars": {
"type": "integer",
"minimum": 1,
"maximum": 5
},
"comment": {
"type": "string"
}
},
"required": [
"stars"
],
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded49 tools