Skip to content

gabelul/stitch-kit / skills/stitch-mcp-get-project

stitch-mcp-get-project

Verified

Retrieves metadata for a specific Stitch project — title, theme, create/update time. Use to inspect a project before generating new screens. Do NOT use this if you already have a screenId — use stitch-mcp-get-screen instead.

Stitch MCP — Get Project

Retrieves full metadata for a specific Stitch project. Useful for understanding an existing project's theme and screen list before generating additional screens.

Critical prerequisite

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

Do NOT call this if you already have both projectId AND screenId. In that case, call stitch-mcp-get-screen directly — it's more efficient.

When to use

  • User provides a Stitch project URL and you need its details
  • You need to know the existing design theme before generating new consistent screens
  • Verifying a project exists before proceeding

Step 1: Parse the project ID from context

The user may provide the project reference in several formats — always extract to the projects/ID format:

Input format→ Argument for get_project
3780309359108792857 (numeric)projects/3780309359108792857
projects/3780309359108792857projects/3780309359108792857 (use as-is)
https://stitch.withgoogle.com/projects/3780309359108792857Extract ID → projects/3780309359108792857

Step 2: Call the MCP tool

{
  "name": "get_project",
  "arguments": {
    "name": "projects/3780309359108792857"
  }
}

Output schema

{
  "name": "projects/3780309359108792857",
  "title": "Analytics Dashboard",
  "createTime": "2024-11-10T09:00:00Z",
  "updateTime": "2024-11-15T10:30:00Z",
  "deviceType": "DESKTOP",
  "visibility": "PRIVATE",
  "projectType": "TEXT_TO_UI",
  "origin": "STITCH",
  "metadata": {
    "isRemixed": false,
    "userRole": "OWNER"
  },
  "designTheme": {
    "colorMode": "LIGHT",
    "customColor": "#6366F1",
    "colorVariant": "TONAL_SPOT",
    "roundness": "ROUND_TWELVE",
    "saturation": 3,
    "spacingScale": 1,
    "headlineFont": "INTER",
    "bodyFont": "INTER",
    "labelFont": "INTER",
    "font": "INTER",
    "headlineFontFamily": "Inter",
    "bodyFontFamily": "Inter",
    "labelFontFamily": "Inter",
    "namedColors": {
      "primary": "#5B5FC7",
      "on_primary": "#FFFFFF",
      "primary_container": "#E1DFFF",
      "on_primary_container": "#414594",
      "secondary": "#5C5D72",
      "on_secondary": "#FFFFFF",
      "tertiary": "#785572",
      "on_tertiary": "#FFFFFF",
      "surface": "#FBF8FF",
      "on_surface": "#1B1B21",
      "surface_container": "#EFEDF5",
      "surface_container_low": "#F5F2FA",
      "surface_container_high": "#E9E7EF",
      "outline": "#777680",
      "error": "#BA1A1A",
      "on_error": "#FFFFFF"
    },
    "overridePrimaryColor": "",
    "overrideSecondaryColor": "",
    "overrideTertiaryColor": "",
    "overrideNeutralColor": "",
    "backgroundLight": "#FBF8FF",
    "backgroundDark": "#131316",
    "description": "Modern indigo-toned interface with clean surfaces",
    "designMd": "# Design System\n\n## Color Palette\n..."
  },
  "screenInstances": [
    {
      "name": "projects/3780309359108792857/screens/88805...",
      "id": "88805...",
      "sourceScreen": "screens/88805...",
      "type": "SCREEN_INSTANCE",
      "width": 412,
      "height": 892,
      "x": 0,
      "y": 0,
      "hidden": false
    },
    {
      "name": "projects/3780309359108792857/screens/99901...",
      "id": "99901...",
      "sourceScreen": "screens/99901...",
      "type": "DESIGN_SYSTEM_INSTANCE",
      "width": 412,
      "height": 892,
      "x": 500,
      "y": 0,
      "hidden": false,
      "sourceAsset": "assets/design-system-123"
    }
  ]
}

designMd is truncated above — in practice it's a full auto-generated design system doc (often 500+ lines). namedColors typically contains 40+ semantic tokens; only the most common are shown here.

DesignTheme field reference

FieldTypeValues / Notes
colorModeenumLIGHT, DARK
customColorstringHex seed color (e.g. #6366F1). This is the color seed — NOT called primaryColor
colorVariantenumMONOCHROME, NEUTRAL, TONAL_SPOT, VIBRANT, EXPRESSIVE, FIDELITY, CONTENT, RAINBOW, FRUIT_SALAD
roundnessenumROUND_FOUR, ROUND_EIGHT, ROUND_TWELVE, ROUND_FULL
spacingScalenumber0–3 (density multiplier)
headlineFontenum68-font set: INTER, GEIST, DM_SANS, MANROPE, PLUS_JAKARTA_SANS, WORK_SANS, SPACE_GROTESK, SORA, OUTFIT, RALEWAY, QUICKSAND, MONTSERRAT, OSWALD, PLAYFAIR_DISPLAY, MERRIWEATHER, NOTO_SERIF, EB_GARAMOND, LITERATA, SOURCE_SERIF_4, SOURCE_SANS_3, NUNITO_SANS, JETBRAINS_MONO, BEBAS_NEUE, ANTON, ARCHIVO_NARROW — see stitch-ued-guide for the full 68-value list
bodyFontenumSame 68-font set
labelFontenumSame 68-font set
fontenumDeprecated — legacy single-font field, same enum
namedColorsobject40+ semantic color tokens (primary, on_primary, surface, surface_container, outline, error, etc.)
overridePrimaryColorstringHex override, empty string if unused
overrideSecondaryColorstringHex override, empty string if unused
overrideTertiaryColorstringHex override, empty string if unused
overrideNeutralColorstringHex override, empty string if unused
backgroundLightstringHex background for light mode
backgroundDarkstringHex background for dark mode
descriptionstringBrief aesthetic description of the theme
designMdstringAuto-generated design system markdown — the full token spec. Can be very long
spacingobjectOptional. Map of spacing token name → CSS value (e.g. {"sm": "8px"})
typographyobjectOptional. Map of typography level name (e.g. h1, body) → Typography token (fontFamily, fontSize, fontWeight, letterSpacing, lineHeight, all optional strings)

Project-level fields

FieldTypeValues / Notes
deviceTypestringMOBILE, DESKTOP, TABLET, AGNOSTIC, or DEVICE_TYPE_UNSPECIFIED
visibilityenumPRIVATE, PUBLIC
projectTypeenumTEXT_TO_UI, PROJECT_DESIGN, etc.
originenumSTITCH, IMPORTED_FROM_GALILEO
metadata.isRemixedbooleanWhether this project was remixed from another
metadata.userRolestringOWNER, VIEWER, etc.

ScreenInstance fields

FieldTypeNotes
idstringNumeric screen ID
sourceScreenstringPath reference to the source screen
typeenumSCREEN_INSTANCE, DESIGN_SYSTEM_INSTANCE, GROUP_INSTANCE
width / heightnumberPixel dimensions
x / ynumberCanvas position
hiddenbooleanWhether hidden in the project
sourceAssetstringPresent on DESIGN_SYSTEM_INSTANCE types — references the design system asset

Using the theme data

Use designMd and namedColors when generating new screens — they contain the authoritative design system for this project. Pass namedColors to stitch-design-system for instant token extraction.

After getting the project

  • Note the designTheme — use it to keep new screens visually consistent
  • Note the screenInstances list — extract screenId values if you need to inspect specific screens
  • Use stitch-mcp-list-screens for a richer view of the screen list including thumbnails
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall