AppScreenStudio is an MCP server published by com.appscreenstudio, hosted at www.appscreenstudio.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 49 tools, including get_editor_snapshot, update_text, add_text, remove_text, add_screenshot.
Design App Store and Google Play screenshots with your AI agent in the AppScreenStudio editor.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| platform | string | Open every set of this platform. Use this when you know the store and not the set id. |
| platformSetId | string | Open this set. Ids come from a snapshot that omitted screenshots. |
{
"name": "get_editor_snapshot",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"platform": {
"enum": [
"ios",
"android",
"social"
],
"type": "string",
"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."
}
},
"additionalProperties": false
}
}Update a text layer on a screenshot in the open editor.
| Parameter | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| align | string | one of ["left","center","right"] |
| color | string | CSS color, such as #ffffff |
| textId * | string | |
| content | string | |
| fontSize | number | Font size in CSS pixels on the 500px-tall editor canvas. |
| rotation | number | |
| fontFamily | string | Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font. |
| fontWeight | string | |
| lineHeight | number | Multiplier of the font size |
| borderColor | string |
Add a text layer to a screenshot in the open editor.
| Parameter | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| align | string | one of ["left","center","right"] |
| color | string | CSS color, such as #ffffff |
| content * | string | |
| fontSize | number | Font size in CSS pixels on the 500px-tall editor canvas. |
| rotation | number | |
| fontFamily | string | Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font. |
| fontWeight | string | |
| lineHeight | number | Multiplier of the font size |
| borderColor | string | |
| borderRadius | number |
Remove a text layer from a screenshot in the open editor.
| Parameter | Type | Description |
|---|---|---|
| textId * | string | |
| screenshotId * | string |
{
"name": "remove_text",
"description": "Remove a text layer from a screenshot in the open editor.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"textId"
],
"properties": {
"textId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| platformSetId * | string |
{
"name": "add_screenshot",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"platformSetId"
],
"properties": {
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| imageX | number | Phone center, in pixels from the card center on the 500px-tall card. |
| imageY | number | Phone center, in pixels from the card center on the 500px-tall card. Positive moves down. |
| deviceId | string | This phone's own device, any set_device id. Empty string follows the platform set's device. |
| imageUrl | string | |
| rotationX | number | Tilt in degrees (top away from the viewer). 3D frames only. |
| rotationY | number | Turn in degrees (right side away from the viewer). 3D frames only. |
| rotationZ | number | The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation). |
| foldAmount | number | 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 h… |
| imageScale | number |
Remove a screenshot from the open editor.
| Parameter | Type | Description |
|---|---|---|
| screenshotId * | string |
{
"name": "remove_screenshot",
"description": "Remove a screenshot from the open editor.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| src * | string | |
| width | number | CSS pixels on the 500px-tall card. |
| height | number | CSS pixels on the 500px-tall card. |
| rotation | number | Degrees, clockwise. |
| screenshotId * | string | |
| spriteCoordinate | object | Crop rectangle on the source image, in source pixels. Use a pose from list_library. |
{
"name": "add_asset",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"src"
],
"properties": {
"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."
},
"src": {
"type": "string"
},
"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."
},
"screenshotId": {
"type": "string"
},
"spriteCoordinate": {
"type": "object",
"required": [
"x",
"y",
"width",
"height"
],
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"description": "Crop rectangle on the source image, in source pixels. Use a pose from list_library."
}
},
"additionalProperties": false
}
}Update an image layer on a screenshot in the open editor.
| Parameter | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| src | string | |
| width | number | CSS pixels on the 500px-tall card. |
| height | number | CSS pixels on the 500px-tall card. |
| assetId * | string | |
| rotation | number | |
| screenshotId * | string |
{
"name": "update_asset",
"description": "Update an image layer on a screenshot in the open editor.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"assetId"
],
"properties": {
"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."
},
"src": {
"type": "string"
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"assetId": {
"type": "string"
},
"rotation": {
"type": "number"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}Remove an image layer from a screenshot in the open editor.
| Parameter | Type | Description |
|---|---|---|
| assetId * | string | |
| screenshotId * | string |
{
"name": "remove_asset",
"description": "Remove an image layer from a screenshot in the open editor.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"assetId"
],
"properties": {
"assetId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| html | string | 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… |
| layer | string | 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. |
| scale | number | Visual multiplier from the center, 0.1 to 4. The html keeps its layout size and does not reflow. 1 is natural size. |
| width * | number | CSS pixels on the 500px-tall card. |
| height * | number | CSS pixels on the 500px-tall card. |
| opacity | number | |
| rotationX |
Update a box layer on a card.
| Parameter | Type | Description |
|---|---|---|
| x | number | Layer center, in percent of the card width from the card center. 50 is the right edge. |
| y | number | Layer center, in percent of the card height from the card center. 50 is the bottom edge. |
| html | string | New card HTML, with the same rules as add_div html. Empty string clears the card. |
| divId * | string | |
| layer | string | 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. |
| scale | number | Visual multiplier from the center, 0.1 to 4. The html keeps its layout size and does not reflow. 1 is natural size. |
| width | number | CSS pixels on the 500px-tall card. |
| height | number | CSS pixels on the 500px-tall card. |
| opacity | number | |
| rotationX | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| rotationY |
Remove a box layer from a screenshot in the open editor.
| Parameter | Type | Description |
|---|---|---|
| divId * | string | |
| screenshotId * | string |
{
"name": "remove_div",
"description": "Remove a box layer from a screenshot in the open editor.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"divId"
],
"properties": {
"divId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| imageX | number | Phone center, in pixels from the card center on the 500px-tall card. |
| imageY | number | Phone center, in pixels from the card center on the 500px-tall card. Positive moves down. |
| deviceId | string | This phone's own device, any set_device id. Empty string follows the platform set's device. |
| imageUrl | string | |
| rotationX | number | Tilt in degrees (top away from the viewer). 3D frames only. |
| rotationY | number | Turn in degrees (right side away from the viewer). 3D frames only. |
| rotationZ | number | The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation). |
| foldAmount | number | 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 h… |
| 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.
| Parameter | Type | Description |
|---|---|---|
| imageX | number | Phone center, in pixels from the card center on the 500px-tall card. |
| imageY | number | Phone center, in pixels from the card center on the 500px-tall card. Positive moves down. |
| phoneId * | string | |
| deviceId | string | This phone's own device, any set_device id. Empty string follows the platform set's device. |
| imageUrl | string | |
| rotationX | number | Tilt in degrees (top away from the viewer). 3D frames only. |
| rotationY | number | Turn in degrees (right side away from the viewer). 3D frames only. |
| rotationZ | number | The phone's rotation in degrees, on every frame (with no tilt it is a flat rotation). |
| foldAmount | number | 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 h… |
| imageScale |
Remove an extra phone added with add_phone.
| Parameter | Type | Description |
|---|---|---|
| phoneId * | string | |
| screenshotId * | string |
{
"name": "remove_phone",
"description": "Remove an extra phone added with add_phone.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"phoneId"
],
"properties": {
"phoneId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["text","asset","div"] |
| direction * | string | one of ["forward","backward"] |
| elementId * | string | |
| screenshotId * | string |
{
"name": "reorder_element",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"elementId",
"kind",
"direction"
],
"properties": {
"kind": {
"enum": [
"text",
"asset",
"div"
],
"type": "string"
},
"direction": {
"enum": [
"forward",
"backward"
],
"type": "string"
},
"elementId": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}Set the template of the open project.
| Parameter | Type | Description |
|---|---|---|
| templateId * | string | one of ["minimal","gradient","geometric","wave","glass","connected"] |
{
"name": "set_template",
"description": "Set the template of the open project.",
"inputSchema": {
"type": "object",
"required": [
"templateId"
],
"properties": {
"templateId": {
"enum": [
"minimal",
"gradient",
"geometric",
"wave",
"glass",
"connected"
],
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| value * | string | |
| colorId * | string |
{
"name": "update_template_color",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"colorId",
"value"
],
"properties": {
"value": {
"type": "string"
},
"colorId": {
"type": "string"
}
},
"additionalProperties": false
}
}Set the pixel size of a platform set.
| Parameter | Type | Description |
|---|---|---|
| width * | number | |
| height * | number | |
| platformSetId * | string |
{
"name": "set_resolution",
"description": "Set the pixel size of a platform set.",
"inputSchema": {
"type": "object",
"required": [
"platformSetId",
"width",
"height"
],
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| deviceId * | string | one of ["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… |
| platformSetId * | string |
{
"name": "set_device",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"platformSetId",
"deviceId"
],
"properties": {
"deviceId": {
"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"
],
"type": "string"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| color * | string | A generic color (black, white, orange, silver, space-gray, blue, purple, red, green) or, on a HyperRealistic set, a deviceColors id. |
| platformSetId * | string |
{
"name": "set_phone_color",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"platformSetId",
"color"
],
"properties": {
"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."
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}Show or hide the notch on a platform set.
| Parameter | Type | Description |
|---|---|---|
| show * | boolean | |
| platformSetId * | string |
{
"name": "set_show_notch",
"description": "Show or hide the notch on a platform set.",
"inputSchema": {
"type": "object",
"required": [
"platformSetId",
"show"
],
"properties": {
"show": {
"type": "boolean"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}Enable or disable the squircle frame on a platform set.
| Parameter | Type | Description |
|---|---|---|
| enabled * | boolean | |
| platformSetId * | string |
{
"name": "set_squircle_frame",
"description": "Enable or disable the squircle frame on a platform set.",
"inputSchema": {
"type": "object",
"required": [
"platformSetId",
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}Link or unlink matching text layers across platform sets.
| Parameter | Type | Description |
|---|---|---|
| enabled * | boolean |
{
"name": "set_link_texts",
"description": "Link or unlink matching text layers across platform sets.",
"inputSchema": {
"type": "object",
"required": [
"enabled"
],
"properties": {
"enabled": {
"type": "boolean"
}
},
"additionalProperties": false
}
}Rename the open project.
| Parameter | Type | Description |
|---|---|---|
| name * | string |
{
"name": "rename_project",
"description": "Rename the open project.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
},
"additionalProperties": false
}
}Undo the last edit in the open editor.
No parameters.
{
"name": "undo",
"description": "Undo the last edit in the open editor.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}
}Redo the last undone edit in the open editor.
No parameters.
{
"name": "redo",
"description": "Redo the last undone edit in the open editor.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | number | 1 to 50. Defaults to 20. |
| query | string | Part of a family name, such as caveat or mono. |
| category | string | one of ["Sans Serif","Serif","Display","Handwriting","Monospace"] |
{
"name": "search_google_fonts",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "1 to 50. Defaults to 20."
},
"query": {
"type": "string",
"description": "Part of a family name, such as caveat or mono."
},
"category": {
"enum": [
"Sans Serif",
"Serif",
"Display",
"Handwriting",
"Monospace"
],
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| family * | string | Exact family name from search_google_fonts, such as Caveat. |
{
"name": "add_project_font",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"family"
],
"properties": {
"family": {
"type": "string",
"description": "Exact family name from search_google_fonts, such as Caveat."
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["asset","mascot"] |
| page | number | Page number, starting at 1. Defaults to 1. |
| limit | number | Page size, 1 to 50. Defaults to 20. Mascots are capped at 10. |
{
"name": "list_library",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"asset",
"mascot"
],
"type": "string"
},
"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."
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| imageId * | string |
{
"name": "get_sprite",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"imageId"
],
"properties": {
"imageId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| prompt | string | What to draw, up to 2000 characters. |
| quality | string | one of ["medium","high"] |
| referenceUrl | string | Optional https image URL used as a visual reference. |
{
"name": "generate_asset",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"prompt": {
"type": "string",
"description": "What to draw, up to 2000 characters."
},
"quality": {
"enum": [
"medium",
"high"
],
"type": "string"
},
"referenceUrl": {
"type": "string",
"description": "Optional https image URL used as a visual reference."
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| prompt | string | What to draw, up to 2000 characters. Optional when presetId is set. |
| quality | string | one of ["medium","high"] |
| presetId | string | one of ["cute_animal","robot","fantasy_character","business_mascot","energy_character","space_character","gaming_character","creative_character"] |
| referenceUrl | string | Optional https image URL used as a visual reference. |
{
"name": "generate_mascot",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"prompt": {
"type": "string",
"description": "What to draw, up to 2000 characters. Optional when presetId is set."
},
"quality": {
"enum": [
"medium",
"high"
],
"type": "string"
},
"presetId": {
"enum": [
"cute_animal",
"robot",
"fantasy_character",
"business_mascot",
"energy_character",
"space_character",
"gaming_character",
"creative_character"
],
"type": "string"
},
"referenceUrl": {
"type": "string",
"description": "Optional https image URL used as a visual reference."
}
},
"additionalProperties": false
}
}Generate an AI background for one card. Spends credits.
| Parameter | Type | Description |
|---|---|---|
| prompt | string | |
| screenshotId * | string |
{
"name": "generate_background",
"description": "Generate an AI background for one card. Spends credits.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"prompt": {
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}Update App Store or Google Play listing fields for the current language. Does not generate copy. Returns the names of the fields written.
| Parameter | Type | Description |
|---|---|---|
| appStore | object | |
| googlePlay | object |
{
"name": "update_store_listing",
"description": "Update App Store or Google Play listing fields for the current language. Does not generate copy. Returns the names of the fields written.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"appStore": {
"type": "object"
},
"googlePlay": {
"type": "object"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| platformSetId | string |
{
"name": "capture_platform_strip",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| type * | string | one of ["screenshot","asset","background"] |
| base64 | string | Optional raw base64 or data URL. Omit this and POST the file to uploadUrl. |
| filename * | string | File name, 1 to 120 characters, no path. Use a png, jpg, jpeg, or webp extension. For type asset, svg is also allowed. |
{
"name": "upload_image",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"type",
"filename"
],
"properties": {
"type": {
"enum": [
"screenshot",
"asset",
"background"
],
"type": "string"
},
"base64": {
"type": "string",
"description": "Optional raw base64 or data URL. Omit this and POST the file to uploadUrl."
},
"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."
}
},
"additionalProperties": false
}
}Duplicate a screenshot and insert the copy immediately after it.
| Parameter | Type | Description |
|---|---|---|
| screenshotId * | string |
{
"name": "duplicate_screenshot",
"description": "Duplicate a screenshot and insert the copy immediately after it.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}Copy a screenshot onto another platform set.
| Parameter | Type | Description |
|---|---|---|
| screenshotId * | string | |
| targetPlatformSetId * | string |
{
"name": "copy_screenshot",
"description": "Copy a screenshot onto another platform set.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"targetPlatformSetId"
],
"properties": {
"screenshotId": {
"type": "string"
},
"targetPlatformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}Move a screenshot left or right within its platform set.
| Parameter | Type | Description |
|---|---|---|
| direction * | string | one of ["left","right"] |
| screenshotId * | string |
{
"name": "move_screenshot",
"description": "Move a screenshot left or right within its platform set.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"direction"
],
"properties": {
"direction": {
"enum": [
"left",
"right"
],
"type": "string"
},
"screenshotId": {
"type": "string"
}
},
"additionalProperties": false
}
}Switch the open editor to a language that already exists on the project.
| Parameter | Type | Description |
|---|---|---|
| lang * | string |
{
"name": "set_language",
"description": "Switch the open editor to a language that already exists on the project.",
"inputSchema": {
"type": "object",
"required": [
"lang"
],
"properties": {
"lang": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| languages * | array | Language codes to add, 1 to 5 unique codes. Examples: tr, de, ja, zh-Hans, pt-BR, es-419, en-GB. |
{
"name": "ai_translate",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"languages"
],
"properties": {
"languages": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5,
"minItems": 1,
"description": "Language codes to add, 1 to 5 unique codes. Examples: tr, de, ja, zh-Hans, pt-BR, es-419, en-GB."
}
},
"additionalProperties": false
}
}Add a platform set to the open project.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| platform * | string | one of ["ios","android","social"] |
{
"name": "add_platform_set",
"description": "Add a platform set to the open project.",
"inputSchema": {
"type": "object",
"required": [
"platform"
],
"properties": {
"name": {
"type": "string"
},
"platform": {
"enum": [
"ios",
"android",
"social"
],
"type": "string"
}
},
"additionalProperties": false
}
}Remove an extra platform set. The first set of each platform stays.
| Parameter | Type | Description |
|---|---|---|
| platformSetId * | string |
{
"name": "remove_platform_set",
"description": "Remove an extra platform set. The first set of each platform stays.",
"inputSchema": {
"type": "object",
"required": [
"platformSetId"
],
"properties": {
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}Set or clear the project background image. Pass an empty imageUrl to clear it.
| Parameter | Type | Description |
|---|---|---|
| blur | number | one of [0,1,2,3] |
| imageUrl * | string |
{
"name": "set_project_background",
"description": "Set or clear the project background image. Pass an empty imageUrl to clear it.",
"inputSchema": {
"type": "object",
"required": [
"imageUrl"
],
"properties": {
"blur": {
"enum": [
0,
1,
2,
3
],
"type": "number"
},
"imageUrl": {
"type": "string"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| threeD | boolean | 3D device model instead of the flat realistic frame. Requires enabled true. |
| enabled * | boolean | |
| platformSetId * | string |
{
"name": "set_realistic_frame",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"platformSetId",
"enabled"
],
"properties": {
"threeD": {
"type": "boolean",
"description": "3D device model instead of the flat realistic frame. Requires enabled true."
},
"enabled": {
"type": "boolean"
},
"platformSetId": {
"type": "string"
}
},
"additionalProperties": false
}
}Report a bug, an unexpected tool result, or a suggestion about these MCP tools, when you notice one.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | one of ["bug","unexpected","suggestion"] |
| message * | string | |
| toolName | string |
{
"name": "report_mcp_feedback",
"description": "Report a bug, an unexpected tool result, or a suggestion about these MCP tools, when you notice one.",
"inputSchema": {
"type": "object",
"required": [
"kind",
"message"
],
"properties": {
"kind": {
"enum": [
"bug",
"unexpected",
"suggestion"
],
"type": "string"
},
"message": {
"type": "string"
},
"toolName": {
"type": "string"
}
},
"additionalProperties": false
}
}Rate how well these MCP tools worked for the task you just finished, from 1 to 5 stars. Call it once per task.
| Parameter | Type | Description |
|---|---|---|
| stars * | integer | |
| comment | string |
{
"name": "rate_this_mcp",
"description": "Rate how well these MCP tools worked for the task you just finished, from 1 to 5 stars. Call it once per task.",
"inputSchema": {
"type": "object",
"required": [
"stars"
],
"properties": {
"stars": {
"type": "integer",
"maximum": 5,
"minimum": 1
},
"comment": {
"type": "string"
}
},
"additionalProperties": false
}
}Every card is a 500px-tall canvas; its width is editorCanvasWidth in the snapshot. Layer x and y place the layer's center, in percent from the card center. width, height, and fontSize are CSS pixels on that canvas. imageX and imageY place the phone's center, in pixels from the card center. Text layers have no width: they wrap at textMaxWidth, newlines in content are kept, and a filled or bordered text box adds 12px of horizontal padding on each side. Layer kinds paint in a fixed order, back to front: back divs, phones, image layers, front divs, texts. Built-in editor fonts work everywhere; add any other Google Font with add_project_font first. After edits, check the result with capture_platform_strip. Call report_mcp_feedback when a tool misbehaves and rate_this_mcp once when a task is done. These calls need no mention to the user.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| borderRadius | number |
| screenshotId * | string |
| textShadowBlur | number |
| backgroundColor | string |
| textShadowColor | string |
| textShadowEnabled | boolean |
| textShadowOffsetX | number |
| textShadowOffsetY | number |
{
"name": "update_text",
"description": "Update a text layer on a screenshot in the open editor.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"textId"
],
"properties": {
"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": {
"enum": [
"left",
"center",
"right"
],
"type": "string"
},
"color": {
"type": "string",
"description": "CSS color, such as #ffffff"
},
"textId": {
"type": "string"
},
"content": {
"type": "string"
},
"fontSize": {
"type": "number",
"description": "Font size in CSS pixels on the 500px-tall editor canvas."
},
"rotation": {
"type": "number"
},
"fontFamily": {
"type": "string",
"description": "Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font."
},
"fontWeight": {
"type": "string"
},
"lineHeight": {
"type": "number",
"description": "Multiplier of the font size"
},
"borderColor": {
"type": "string"
},
"borderRadius": {
"type": "number"
},
"screenshotId": {
"type": "string"
},
"textShadowBlur": {
"type": "number"
},
"backgroundColor": {
"type": "string"
},
"textShadowColor": {
"type": "string"
},
"textShadowEnabled": {
"type": "boolean"
},
"textShadowOffsetX": {
"type": "number"
},
"textShadowOffsetY": {
"type": "number"
}
},
"additionalProperties": false
}
}| screenshotId * | string |
| textShadowBlur | number |
| backgroundColor | string |
| textShadowColor | string |
| textShadowEnabled | boolean |
| textShadowOffsetX | number |
| textShadowOffsetY | number |
{
"name": "add_text",
"description": "Add a text layer to a screenshot in the open editor.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"content"
],
"properties": {
"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": {
"enum": [
"left",
"center",
"right"
],
"type": "string"
},
"color": {
"type": "string",
"description": "CSS color, such as #ffffff"
},
"content": {
"type": "string"
},
"fontSize": {
"type": "number",
"description": "Font size in CSS pixels on the 500px-tall editor canvas."
},
"rotation": {
"type": "number"
},
"fontFamily": {
"type": "string",
"description": "Font for the whole layer, such as Nunito: a built-in editor font or one added with add_project_font."
},
"fontWeight": {
"type": "string"
},
"lineHeight": {
"type": "number",
"description": "Multiplier of the font size"
},
"borderColor": {
"type": "string"
},
"borderRadius": {
"type": "number"
},
"screenshotId": {
"type": "string"
},
"textShadowBlur": {
"type": "number"
},
"backgroundColor": {
"type": "string"
},
"textShadowColor": {
"type": "string"
},
"textShadowEnabled": {
"type": "boolean"
},
"textShadowOffsetX": {
"type": "number"
},
"textShadowOffsetY": {
"type": "number"
}
},
"additionalProperties": false
}
}| phoneColor | string | This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color. |
| shadowBlur | number |
| shadowColor | string |
| screenshotId * | string |
| imageDisabled | boolean |
| imageRotation | number | Old name of rotationZ; it sets rotationZ. |
| outerImageUrl | string | Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it. |
| shadowEnabled | boolean |
| shadowOffsetX | number |
| shadowOffsetY | number |
| backgroundColor | string |
| backgroundImage | string |
| bottomFadeColor | string | Ignored. The fade always goes to transparent, so whatever is behind the phone shows through. |
| bottomFadeHeight | number |
| deviceModelColor | string | HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it. |
| hideCardOverflow | boolean |
| bottomFadeEnabled | boolean |
| bottomFadePosition | string | one of ["top","bottom"] |
| backgroundImageBlur | number | one of [0,1,2,3] |
| backgroundPatternId | string |
| focusOverlayCropTop | number |
| focusOverlayEnabled | boolean |
| focusOverlayOffsetY | number | Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000. |
| backgroundPatternColor | string |
| focusOverlayCropBottom | number |
| focusOverlayShadowBlur | number |
| focusOverlayBorderColor | string |
| focusOverlayBorderWidth | number |
| focusOverlayShadowColor | string |
| focusOverlayBorderRadius | number |
| focusOverlayShadowEnabled | boolean |
| focusOverlayShadowOffsetX | number |
| focusOverlayShadowOffsetY | number |
| focusOverlayBlurBackground | boolean |
{
"name": "update_screenshot",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"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."
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"imageUrl": {
"type": "string"
},
"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)."
},
"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."
},
"imageScale": {
"type": "number"
},
"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."
},
"shadowBlur": {
"type": "number"
},
"shadowColor": {
"type": "string"
},
"screenshotId": {
"type": "string"
},
"imageDisabled": {
"type": "boolean"
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"shadowEnabled": {
"type": "boolean"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
},
"backgroundColor": {
"type": "string"
},
"backgroundImage": {
"type": "string"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadeHeight": {
"type": "number"
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"hideCardOverflow": {
"type": "boolean"
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadePosition": {
"enum": [
"top",
"bottom"
],
"type": "string"
},
"backgroundImageBlur": {
"enum": [
0,
1,
2,
3
],
"type": "number"
},
"backgroundPatternId": {
"type": "string"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayEnabled": {
"type": "boolean"
},
"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."
},
"backgroundPatternColor": {
"type": "string"
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayBlurBackground": {
"type": "boolean"
}
},
"additionalProperties": false
}
}| number |
| 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| rotationY | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| rotationZ | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| borderRadius | number |
| screenshotId * | string |
| backgroundColor | string |
{
"name": "add_div",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"width",
"height"
],
"properties": {
"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."
},
"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": {
"enum": [
"front",
"back"
],
"type": "string",
"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."
},
"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."
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"opacity": {
"type": "number"
},
"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."
},
"borderRadius": {
"type": "number"
},
"screenshotId": {
"type": "string"
},
"backgroundColor": {
"type": "string"
}
},
"additionalProperties": false
}
}| number |
| 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| rotationZ | number | 3D tilt in degrees, -360 to 360, about the box center with the same perspective as phones. 0 is flat. |
| borderRadius | number |
| screenshotId * | string |
| backgroundColor | string |
{
"name": "update_div",
"description": "Update a box layer on a card.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"divId"
],
"properties": {
"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."
},
"html": {
"type": "string",
"description": "New card HTML, with the same rules as add_div html. Empty string clears the card."
},
"divId": {
"type": "string"
},
"layer": {
"enum": [
"front",
"back"
],
"type": "string",
"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."
},
"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."
},
"width": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"height": {
"type": "number",
"description": "CSS pixels on the 500px-tall card."
},
"opacity": {
"type": "number"
},
"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."
},
"borderRadius": {
"type": "number"
},
"screenshotId": {
"type": "string"
},
"backgroundColor": {
"type": "string"
}
},
"additionalProperties": false
}
}| number |
| phoneColor | string | This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color. |
| shadowBlur | number |
| shadowColor | string |
| screenshotId * | string |
| imageRotation | number | Old name of rotationZ; it sets rotationZ. |
| outerImageUrl | string | Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it. |
| shadowEnabled | boolean |
| shadowOffsetX | number |
| shadowOffsetY | number |
| bottomFadeColor | string | Ignored. The fade always goes to transparent, so whatever is behind the phone shows through. |
| bottomFadeHeight | number |
| deviceModelColor | string | HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it. |
| bottomFadeEnabled | boolean |
| bottomFadePosition | string | one of ["top","bottom"] |
| focusOverlayCropTop | number |
| focusOverlayEnabled | boolean |
| focusOverlayOffsetY | number | Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000. |
| focusOverlayCropBottom | number |
| focusOverlayShadowBlur | number |
| focusOverlayBorderColor | string |
| focusOverlayBorderWidth | number |
| focusOverlayShadowColor | string |
| focusOverlayBorderRadius | number |
| focusOverlayShadowEnabled | boolean |
| focusOverlayShadowOffsetX | number |
| focusOverlayShadowOffsetY | number |
| focusOverlayBlurBackground | boolean |
{
"name": "add_phone",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId"
],
"properties": {
"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."
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"imageUrl": {
"type": "string"
},
"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)."
},
"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."
},
"imageScale": {
"type": "number"
},
"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."
},
"shadowBlur": {
"type": "number"
},
"shadowColor": {
"type": "string"
},
"screenshotId": {
"type": "string"
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"shadowEnabled": {
"type": "boolean"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadeHeight": {
"type": "number"
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadePosition": {
"enum": [
"top",
"bottom"
],
"type": "string"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayEnabled": {
"type": "boolean"
},
"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."
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayBlurBackground": {
"type": "boolean"
}
},
"additionalProperties": false
}
}| number |
| phoneColor | string | This phone's own generic color (black, white, orange, silver, space-gray, blue, purple, red, green). Empty string follows the platform set's color. |
| shadowBlur | number |
| shadowColor | string |
| screenshotId * | string |
| imageRotation | number | Old name of rotationZ; it sets rotationZ. |
| outerImageUrl | string | Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it. |
| shadowEnabled | boolean |
| shadowOffsetX | number |
| shadowOffsetY | number |
| bottomFadeColor | string | Ignored. The fade always goes to transparent, so whatever is behind the phone shows through. |
| bottomFadeHeight | number |
| deviceModelColor | string | HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it. |
| bottomFadeEnabled | boolean |
| bottomFadePosition | string | one of ["top","bottom"] |
| focusOverlayCropTop | number |
| focusOverlayEnabled | boolean |
| focusOverlayOffsetY | number | Vertical offset of the focus overlay, as a percent of its height. Negative moves it up. Range is -1000 to 1000. |
| focusOverlayCropBottom | number |
| focusOverlayShadowBlur | number |
| focusOverlayBorderColor | string |
| focusOverlayBorderWidth | number |
| focusOverlayShadowColor | string |
| focusOverlayBorderRadius | number |
| focusOverlayShadowEnabled | boolean |
| focusOverlayShadowOffsetX | number |
| focusOverlayShadowOffsetY | number |
| focusOverlayBlurBackground | boolean |
{
"name": "update_phone",
"description": "Update an extra phone added with add_phone. Takes the same phone fields as update_screenshot. The main phone is edited with update_screenshot.",
"inputSchema": {
"type": "object",
"required": [
"screenshotId",
"phoneId"
],
"properties": {
"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."
},
"phoneId": {
"type": "string"
},
"deviceId": {
"type": "string",
"description": "This phone's own device, any set_device id. Empty string follows the platform set's device."
},
"imageUrl": {
"type": "string"
},
"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)."
},
"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."
},
"imageScale": {
"type": "number"
},
"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."
},
"shadowBlur": {
"type": "number"
},
"shadowColor": {
"type": "string"
},
"screenshotId": {
"type": "string"
},
"imageRotation": {
"type": "number",
"description": "Old name of rotationZ; it sets rotationZ."
},
"outerImageUrl": {
"type": "string",
"description": "Foldable devices (iphone-duo) only: the outer display's image URL (shows when folded). Empty string clears it."
},
"shadowEnabled": {
"type": "boolean"
},
"shadowOffsetX": {
"type": "number"
},
"shadowOffsetY": {
"type": "number"
},
"bottomFadeColor": {
"type": "string",
"description": "Ignored. The fade always goes to transparent, so whatever is behind the phone shows through."
},
"bottomFadeHeight": {
"type": "number"
},
"deviceModelColor": {
"type": "string",
"description": "HyperRealistic (threeDFrame): this phone's own real finish, a deviceColors id of its device. Empty string clears it."
},
"bottomFadeEnabled": {
"type": "boolean"
},
"bottomFadePosition": {
"enum": [
"top",
"bottom"
],
"type": "string"
},
"focusOverlayCropTop": {
"type": "number"
},
"focusOverlayEnabled": {
"type": "boolean"
},
"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."
},
"focusOverlayCropBottom": {
"type": "number"
},
"focusOverlayShadowBlur": {
"type": "number"
},
"focusOverlayBorderColor": {
"type": "string"
},
"focusOverlayBorderWidth": {
"type": "number"
},
"focusOverlayShadowColor": {
"type": "string"
},
"focusOverlayBorderRadius": {
"type": "number"
},
"focusOverlayShadowEnabled": {
"type": "boolean"
},
"focusOverlayShadowOffsetX": {
"type": "number"
},
"focusOverlayShadowOffsetY": {
"type": "number"
},
"focusOverlayBlurBackground": {
"type": "boolean"
}
},
"additionalProperties": false
}
}