Edits existing Stitch screens with text prompts — the iteration tool. Change colors, layout, content, or style without regenerating from scratch. Supports refinement loops via output_components suggestions.
Edits one or more existing screens using a text prompt. This is the primary iteration tool — instead of regenerating a screen from scratch (60–180s), you can refine what you already have with targeted changes.
Only use this skill when the user explicitly mentions "Stitch".
You must have both a projectId AND at least one screenId before calling this. If you don't:
stitch-mcp-list-screens to find screen IDsprojects/123/screens/456 → projectId: 123, screenId: 456{
"name": "edit_screens",
"arguments": {
"projectId": "3780309359108792857",
"selectedScreenIds": ["88805abc123def456"],
"prompt": "Change the background to dark mode (#09090B). Make the primary color indigo (#818CF8). Increase the font size of the header to 32px bold.",
"deviceType": "DESKTOP",
"modelId": "GEMINI_3_PRO"
}
}
projectId — numeric ID only, no prefix✅ "3780309359108792857"
❌ "projects/3780309359108792857"
selectedScreenIds — array of numeric screen IDs✅ ["88805abc123def456"]
❌ ["projects/123/screens/88805abc123def456"]
❌ ["screens/88805abc123def456"]
Select one or more screens to edit. All selected screens receive the same edit instruction.
prompt — the edit instructionApply the same quality bar as generation prompts:
deviceType — optionalSame enum as generate_screen_from_text: MOBILE, DESKTOP, TABLET, AGNOSTIC
modelId — optional| Value | Use when |
|---|---|
GEMINI_3_PRO | Complex edits — layout changes, multi-component updates |
GEMINI_3_FLASH | Simple edits — color swaps, text changes, quick iterations |
output_componentsThe response may contain output_components with suggestions:
{
"outputComponents": [
{ "text": "I've updated the background color and adjusted contrast ratios." },
{ "suggestion": "Would you also like me to update the sidebar to match the dark theme?" }
]
}
When you see suggestions:
edit_screens again with the suggestion as the new promptSame as generation: 60–180 seconds is normal.
stitch-mcp-get-screen with the same projectId and screenIdedit_screens callstitch-mcp-generate-variantsprojects/ID format for projectId or screenId — both must be numeric