AppScreenStudio
Design App Store and Google Play screenshots with your AI agent in the AppScreenStudio editor.
我該用這個嗎
品質與安全性
A
發現項目（1）
- LOWTool 'report_mcp_feedback' description lacks action verb在 report_mcp_feedback 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~8,368Token（工具定義）
~1.6 KB典型回應大小
顯著的注意力影響（128k 上下文的 6.54%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"app-screen-studio": {
"url": "https://www.appscreenstudio.com/api/mcp"
}
}
}遠端端點
https://www.appscreenstudio.com/api/mcpstreamable-http它能做什麼
工具清單
工具（49）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟡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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
}
},
"required": [
"enabled"
],
"additionalProperties": false
}⚪rename_project(name)
Rename the open project.
輸入結構描述
{
"type": "object",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
}🟡undo
Undo the last edit in the open editor.
輸入結構描述
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟡redo
Redo the last undone edit in the open editor.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"type": "object",
"properties": {
"screenshotId": {
"type": "string"
}
},
"required": [
"screenshotId"
],
"additionalProperties": false
}⚪copy_screenshot(screenshotId, targetPlatformSetId)
Copy a screenshot onto another platform set.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"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.
輸入結構描述
{
"type": "object",
"properties": {
"stars": {
"type": "integer",
"minimum": 1,
"maximum": 5
},
"comment": {
"type": "string"
}
},
"required": [
"stars"
],
"additionalProperties": false
}社群
證據
近期觀測
已驗證未記錄版本49 個工具