stitch-mcp-list-screens

Stitch MCP — List Screens

Lists all screens contained within a specific Stitch project. You typically call this right after generate_screen_from_text to find the screenId of the screen that was just created.

Critical prerequisite

Only use this skill when the user explicitly mentions "Stitch".

When to use

• Immediately after generate_screen_from_text — to find the new screen's ID
• User wants to browse all screens in a project
• You need a screenId to call get_screen
• Checking what screens already exist before generating a new one

Call the MCP tool

Important: Use the projects/ID format — not the numeric ID alone.

{
  "name": "list_screens",
  "arguments": {
    "projectId": "projects/3780309359108792857"
  }
}

✅ "projects/3780309359108792857"
❌ "3780309359108792857"

Output schema

{
  "screens": [
    {
      "name": "projects/3780309359108792857/screens/88805abc123def456",
      "title": "Login Screen",
      "screenshot": {
        "downloadUrl": "https://storage.googleapis.com/..."
      },
      "deviceType": "MOBILE"
    }
  ]
}

After listing

1. Identify the target screen (usually the most recently generated — last in the list)
2. Extract the numeric screenId from the name field:
   • "projects/3780309359108792857/screens/88805abc123def456" → screenId = "88805abc123def456"
3. Call stitch-mcp-get-screen with the numeric projectId and screenId

ID format reminder

For the next call (get_screen), you need the numeric IDs for both project and screen:

• projectId → 3780309359108792857 (strip projects/ prefix)
• screenId → 88805abc123def456 (strip projects/.../screens/ prefix)