> ## Documentation Index > Fetch the complete documentation index at: https://docs.flowstep.ai/llms.txt > Use this file to discover all available pages before exploring further. # MCP-verktøyreferanse > Innskjema, utdataformat og eksempler for alle 20 Flowstep MCP-verktøy. Alle verktøy returnerer en `content`-matrise med MCP-innholdsblokker. Tekstverktøy returnerer `{ type: "text", text: "" }`. Bildeverktøy returnerer `{ type: "image", data: "", mimeType: "image/png" }`. Ved feil settes `isError: true` og tekstblokken inneholder feilmeldingen. *** ## Filverktøy ### `list-files` List Flowstep-filer for gjeldende bruker. **Inndata** | Parameter | Type | Standard | Beskrivelse | | ----------------- | ----------------- | -------- | -------------------------------- | | `orderByCreation` | `boolean` | `true` | Sorter etter opprettelsesdato | | `limit` | `integer` (1–100) | `20` | Antall filer som skal returneres | | `offset` | `integer` (≥0) | `0` | Paginasjonsforskyvning | **Utdata** — JSON-matrise med filobjekter. ```json theme={"system"} [ { "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0", "name": "Dashboard redesign", "created_at": "2026-04-30T15:02:13.120152+00:00", "updated_at": "2026-04-30T15:02:13.120152+00:00", "owner": true, "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0" } ] ``` *** ### `get-file` Hent en enkelt fil etter ID. Filinnholdet er med vilje utelatt — bruk `get-screen` eller `get-screen-image` for å inspisere skjermer, og `get-design-guidelines` for å hente tilknyttede retningslinjer. **Inndata** | Parameter | Type | Beskrivelse | | --------- | ------ | ----------- | | `id` | `uuid` | Fil-ID | **Utdata** — JSON-filobjekt. ```json theme={"system"} { "file": { "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0", "name": "Dashboard redesign", "project_id": "81cb84d6-c69f-492c-a895-7421b60d1a6d", "created_at": "2026-04-30T15:02:13.120152+00:00", "updated_at": "2026-04-30T15:02:13.120152+00:00", "access_level": "private", "owner": true, "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0" }, "user_access_level": "write" } ``` *** ### `create-file` Opprett en ny Flowstep-fil. **Inndata** | Parameter | Type | Beskrivelse | | --------- | ---------------- | ----------- | | `title` | `string` (min 1) | Filnavn | **Utdata** — JSON-filobjekt med den nye filens `id`. ```json theme={"system"} { "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0", "name": "Dashboard redesign", "project_id": "81cb84d6-c69f-492c-a895-7421b60d1a6d", "created_at": "2026-04-30T15:02:13.120152+00:00", "updated_at": "2026-04-30T15:02:13.120152+00:00", "access_level": "private", "user_access_level": "write", "owner": true, "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0" } ``` Bruk den returnerte `id`-en som `fileId` i senere verktøykall. *** ### `update-file` Gi nytt navn til en fil. **Inndata** | Parameter | Type | Beskrivelse | | --------- | ---------------- | ----------- | | `id` | `uuid` | Fil-ID | | `name` | `string` (min 1) | Nytt navn | **Utdata** — Oppdatert filobjekt i samme format som `get-file`. ```json theme={"system"} { "file": { "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0", "name": "Dashboard redesign (v2)", "project_id": "81cb84d6-c69f-492c-a895-7421b60d1a6d", "created_at": "2026-04-30T15:02:13.120152+00:00", "updated_at": "2026-04-30T15:02:13.120152+00:00", "access_level": "private", "owner": true, "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0" }, "user_access_level": "write" } ``` *** ### `delete-file` Slett en fil permanent. `name`-verdien du oppgir valideres mot filens faktiske navn før sletting — hvis den ikke stemmer, avbrytes slettingen. Dette forhindrer utilsiktet sletting av feil fil. **Inndata** | Parameter | Type | Beskrivelse | | --------- | -------- | ---------------------------------------------------------------------- | | `id` | `uuid` | Fil-ID | | `name` | `string` | Gjeldende navn på filen — må stemme nøyaktig eller slettingen avbrytes | **Utdata** — `"File deleted successfully"` Dette er permanent. Alle skjermer i filen slettes. *** ## Skjermverktøy ### `list-screens` List alle genererte skjermer for en fil. Bruk de returnerte `screenId`-verdiene for å referere til skjermer i `get-screen`, `get-screen-image`, `upload-attachment`, og som `targets` i `edit-design`, `regenerate-design` eller `expand-design`. **Inndata** | Parameter | Type | Beskrivelse | | --------- | ------ | ----------- | | `fileId` | `uuid` | Fil-ID | **Utdata** — JSON-matrise med skjermoppsummeringer. ```json theme={"system"} [ { "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe", "name": "Mobile login screen", "fidelity": "ui", "prompt": "Generate a simple mobile login screen with email and password fields and a sign in button", "createdAt": "2026-04-30T15:02:37.444139+00:00" } ] ``` `name` er det brukertildelte skjermnavnet, eller `null` hvis skjermen ikke er navngitt. *** ### `get-screen` Hent JSX-koden for en skjerm slik at du kan redigere eller bruke koden utenfor Flowstep. Bruk `get-screen-image` for en visuell forhåndsvisning i stedet. **Inndata** | Parameter | Type | Beskrivelse | | ---------- | ------ | ----------------------------------------------------------------------------------------------------------------- | | `fileId` | `uuid` | Fil-ID | | `screenId` | `uuid` | Den `screenId` som returneres av `list-screens` eller fra `screenIds`-matrisen som returneres av et designverktøy | **Utdata** — Skjermen som kode (JSX). Legg merke til kommentaren på første linje, som er påkrevd når du bruker `add-screen`-verktøyet. ```json theme={"system"}
World Clock
Search cities...
...
; ``` *** ### `add-screen` Legger til en ny skjerm i en Flowstep-fil fra en rå JSX-streng. **Inndata** | Parameter | Type | Beskrivelse | | ------------ | -------- | -------------------------------------------------------------------------------- | | `fileId` | `uuid` | Fil-ID | | `jsxContent` | `string` | JSX som skal legges til filen som en skjerm | | `screenType` | `string` | Påkrevd hvis skjermtypen ikke er definert som en kommentar på begynnelsen av JSX | **Merknad** — En kommentar lignende den nedenfor MÅ være tilstede som første linje i JSX fordi den brukes til å legge til skjermen riktig. `screenType`, `name` og `screenId` er alle valgfrie — `screenId` brukes (internt) hvis den er tilstede (for eksempel når du viderefører JSX kopiert fra `get-screen`-utdata) men er ikke obligatorisk. Skjermnavnet hentes fra kommentarens `name`-felt (vist som "Copy of \"), eller "Untitled" hvis fraværende. `` **Utdata** — Den nylig tillagte skjerm-ID-en. ```json theme={"system"} { "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbf" } ``` *** ### `get-screen-image` Gjengi en skjerm til PNG og returner den som et inline-bilde. Krever en klient som støtter innholdsblokker for bilder. **Inndata** | Parameter | Type | Beskrivelse | | ---------- | ------ | ----------------------------------------------------------------------------------------------------------------- | | `fileId` | `uuid` | Fil-ID | | `screenId` | `uuid` | Den `screenId` som returneres av `list-screens` eller fra `screenIds`-matrisen som returneres av et designverktøy | **Utdata** — MCP-innholdsblokk for bilde (`image/png`). *** ## AI-verktøy `regenerate-design`, `expand-design` og `edit-design` krever designkontekst som kun er tilstede på skjermer som opprinnelig ble generert med en `designs`-matrise. Skjermer som ble generert uten designkontekst vil returnere en feil. Løsning: bruk `upload-attachment` for å gjengi skjermen som et bilde, og kall deretter `create-new-design` med bildet i `attachments` og en melding som beskriver ønskede endringer. ### `create-new-design` Generer en eller flere skjermdesign fra en tekstprompt. Utelat `fileId` for å opprette en ny fil automatisk. Blokkerer inntil genereringen er fullført eller tidsavbrudd oppstår (180 sekunder). **Inndata** | Parameter | Type | Standard | Beskrivelse | | ------------- | ---------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `fileId` | `uuid` | — | Målfil — utelat for å opprette en ny fil automatisk | | `message` | `string` | — | Prompt som beskriver skjermene som skal genereres | | `attachments` | `AttachmentRequestData[]` (maks 5) | `[]` | Forhåndsopplastede vedlegg — bilder, PDF-er eller kodefiler. Last alltid opp via `upload-attachment` først; ikke innebygd filinnhold i meldingen | | `designs` | `DesignRequestData[]` | `[]` | Designreferanser | **Utdata** — `{ fileId, screenIds }`. Videoføring hver `screenId` til `get-screen-image` for å se resultatene. ```json theme={"system"} { "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0", "screenIds": ["3f9e6eb6-5525-4383-9375-67e0bd762dbe"] } ``` *** ### `regenerate-design` Gjøre eksisterende skjermer om igjen fra bunnen av eller med en stilvariant. Krever minst en `screenId` i `targets`. Blokkerer inntil genereringen er fullført eller tidsavbrudd oppstår (180 sekunder). **Inndata** | Parameter | Type | Standard | Beskrivelse | | ------------------ | ----------------------------------------------------------- | -------- | ------------------------------------------ | | `fileId` | `uuid` | — | Målfil | | `message` | `string` | — | Prompttekst | | `targets` | `uuid[]` (min 1) | — | screenIds av skjermer som skal regenereres | | `operationVariant` | `"different_layout" \| "different_style" \| "from_scratch"` | — | Valgfri stilvariant | | `designs` | `DesignRequestData[]` | `[]` | Designreferanser (løst automatisk) | **Utdata** — `{ fileId, screenIds }`. Videoføring hver `screenId` til `get-screen-image` for å se resultatene. *** ### `expand-design` Legg til oppfølgingsskjermer til et eksisterende design. Krever minst en `screenId` i `targets` og en obligatorisk `operationVariant`. Blokkerer inntil genereringen er fullført eller tidsavbrudd oppstår (180 sekunder). **Inndata** | Parameter | Type | Standard | Beskrivelse | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------------------------------------------------------------ | | `fileId` | `uuid` | — | Målfil | | `message` | `string` | — | Prompttekst | | `targets` | `uuid[]` (min 1) | — | screenIds av skjermer som skal utvides fra | | `operationVariant` | `"next_screen" \| "error_state" \| "empty_state" \| "web_version" \| "mobile_version" \| "tablet_version" \| "mobile_ios_version" \| "mobile_android_version"` | — | **Obligatorisk** — type oppfølgingsskjerm som skal genereres | | `designs` | `DesignRequestData[]` | `[]` | Designreferanser (løst automatisk) | **Utdata** — `{ fileId, screenIds }`. Videoføring hver `screenId` til `get-screen-image` for å se resultatene. *** ### `edit-design` Endre eksisterende skjermer via en prompt. Krever minst en `screenId` i `targets`. Blokkerer inntil genereringen er fullført eller tidsavbrudd oppstår (180 sekunder). **Inndata** | Parameter | Type | Standard | Beskrivelse | | ------------------ | ------------------------------------------------ | -------- | ------------------------------------------------------------------------- | | `fileId` | `uuid` | — | Målfil | | `message` | `string` | — | Instruksjoner som beskriver redigeringene som skal brukes | | `targets` | `uuid[]` (min 1) | — | screenIds av skjermer som skal redigeres | | `operationVariant` | `"dark_theme" \| "light_theme" \| "make_pretty"` | — | Valgfri stilgenveien | | `attachments` | `AttachmentRequestData[]` (maks 5) | `[]` | Forhåndsopplastede vedlegg. Last alltid opp via `upload-attachment` først | | `designs` | `DesignRequestData[]` | `[]` | Designreferanser (løst automatisk) | **Utdata** — `{ fileId, screenIds }`. Videoføring hver `screenId` til `get-screen-image` for å se resultatene. *** ### `upload-attachment` Last opp en fil som skal brukes som vedlegg i `create-new-design` eller `edit-design`. Returnerer `{ id, path, type, mimeType }` — send dette objektet direkte inn i `attachments`-matrisen. To modus: **Modus 1 — Skjerm etter ID** Pass `screenId` og `fileId`. Serveren henter skjermtilstanden fra databasen og gjengivelsen som et bilde. | Parameter | Type | Beskrivelse | | ---------- | ------ | ------------------------------------------ | | `fileId` | `uuid` | Fil som inneholder skjermen (obligatorisk) | | `screenId` | `uuid` | Skjerm som skal gjengivelser | **Modus 2 — Ekstern fil** Pass filinnholdet direkte. Binære filer må være base64-kodet; tekstfiler (inkludert kildekode) sendes som vanlige UTF-8-strenger. | Parameter | Type | Beskrivelse | | ---------- | ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | | `fileData` | `string` | Filinnhold — base64 for binær, UTF-8-streng for tekst | | `fileName` | `string` | Opprinnelig filnavn | | `mimeType` | `"image/jpeg" \| "image/png" \| "image/webp" \| "application/pdf" \| "text/plain" \| "text/javascript"` | MIME-type. Bruk `text/javascript` for `.jsx`-, `.tsx`-, `.js`- og `.ts`-filer | Maksimal filstørrelse: **3 MB**. For store bilder foretrekkes `image/jpeg` fremfor `image/png`. **Utdata** ```json theme={"system"} { "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890", "type": "image", "mimeType": "image/jpeg" } ``` `type` er `"image"` for bilde/PDF-opplastinger og `"document"` for tekst-/kodefiler. *** ## Chat-verktøy ### `get-chat-history` Hent meldingshistorikken for en fil. **Inndata** | Parameter | Type | Beskrivelse | | --------- | ------ | ----------- | | `fileId` | `uuid` | Fil-ID | **Utdata** — JSON-objekt med en `messages`-matrise. Hver melding har en `type` (`"request"` eller `"response"`), `author` (`"human"` eller `"ai"`), og `content_type` (`"text"`, `"summary"` eller `"followup"`). ```json theme={"system"} { "messages": [ { "id": "453f593d-2380-425b-ba29-127db08d6a8e", "chat_id": "146d0f19-497e-450c-ba53-3de15f6bd70b", "type": "request", "status": "success", "content": "Generate a simple mobile login screen with email and password fields", "author": "human", "content_type": "text", "sequence": 1, "request_message_id": null, "targets": [], "attachments": [] }, { "id": "d860186b-82d5-4bd1-8e8e-8ba5377a14bf", "chat_id": "146d0f19-497e-450c-ba53-3de15f6bd70b", "type": "response", "status": "success", "content": "Generated a mobile login screen with email and password input fields, sign in button, remember me checkbox, forgot password link, social login options (Apple/Google), and sign up link.", "author": "ai", "content_type": "summary", "sequence": 7, "request_message_id": "453f593d-2380-425b-ba29-127db08d6a8e", "targets": [{ "target_id": "3f9e6eb6-5525-4383-9375-67e0bd762dbe" }], "attachments": [] } ] } ``` *** ## Designverktøy ### `get-design-guidelines` Hent designretningslinjene som er lagret for en fil. **Inndata** | Parameter | Type | Standard | Beskrivelse | | ------------ | -------- | -------- | ----------- | | `resourceId` | `uuid` | — | Fil-ID | | `linkedTo` | `"file"` | `"file"` | Ressurstype | **Utdata** ```json theme={"system"} { "guidelines": "## Colors\n\nPrimary: #6366F1\nBackground: #FFFFFF\n\n## Typography\n\nFont: Inter", "linkedTo": "file" } ``` `guidelines` er `null` hvis ingen retningslinjer har blitt angitt. *** ### `update-design-guidelines` Angi eller erstatt designretningslinjene for en fil. Retningslinjer sendes som en vanlig tekststreng i Googles `design.md`-format — ikke send et objekt eller JSON. Serveren utfører mykt validering og kan returnere en `Warnings:`-seksjon i svaret som viser problemer (ukjente nøkler, ikke-heksdesimalfarger) som ble akseptert men kan bli ignorert av AI. Vis disse til brukeren. **Inndata** | Parameter | Type | Standard | Beskrivelse | | ------------------ | ---------------- | -------- | ----------------------------------------------------------------------------- | | `resourceId` | `uuid` | — | Fil-ID | | `designGuidelines` | `string` (min 1) | — | Rå tekstinnhold av retningslinjen. Må være en vanlig streng — ikke JSON-kodet | | `linkedTo` | `"file"` | `"file"` | Ressurstype | **Valideringsregler** * Frontmatter må åpnes og lukkes riktig * Frontmatter-linjer må være gyldig blokk-stil YAML * Markdown-kroppen må ikke inneholde duplikat `##`-seksjonstitler **Utdata** — `"Design guidelines updated successfully"`, eventuelt fulgt av en `Warnings:`-seksjon. *** ### `delete-design-guidelines` Fjern designretningslinjene for en fil. **Inndata** | Parameter | Type | Standard | Beskrivelse | | ------------ | -------- | -------- | ----------- | | `resourceId` | `uuid` | — | Fil-ID | | `linkedTo` | `"file"` | `"file"` | Ressurstype | **Utdata** — `"Design guidelines deleted successfully"` *** ## Figma-verktøy ### `import-figma` Importer en Figma-ramme inn i en Flowstep-fil som redigerbare elementer på lerretet. Reimportering av samme ramme oppdaterer den på stedet. Filorganisasjonen må ha Figma koblet i Flowstep-innstillinger. **Inndata** | Parameter | Type | Beskrivelse | | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `figmaUrl` | `string` | Lenke til en bestemt Figma-ramme. I Figma, høyreklikk på rammene og velg **Copy link to selection**. En lenke til en side importerer alle toppnivårammene på den siden (begrenset til 20 rammer over MCP). | | `fileId` | `uuid` | Flowstep-filen som skal importere rammene til | **Utdata** — `{ fileId, screenId }`. `screenId` er ID-en for det importerte skjermelementet — send det til `get-screen-image` for å se resultatet. Når en siden-URL importerer flere rammer, er `screenId` `null` og `frameCount` returneres i stedet. ```json theme={"system"} { "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0", "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe" } ``` *** ## Faktureringsverktøy ### `get-plan-details` Hent gjeldende brukers plan, abonnementstatus og gjenværende kvota. Tar ingen inndata. **Utdata** ```json theme={"system"} { "plan": { "name": "Starter", "code": "starter", "type": "paid" }, "subscription": { "isPaid": true, "isTrial": false, "startDate": "2025-01-01T00:00:00Z", "endDate": null, "trialDaysRemaining": null }, "limits": { "messages": { "daily": { "max": 50, "warn": 40 }, "monthly": { "max": 500, "warn": 400 }, "unlimited": false } }, "usage": { "messages": { "daily": 12, "monthly": 87 } }, "remaining": { "messages": { "daily": 38, "monthly": 413 } } } ``` Grenser varierer etter plan. Kall dette verktøyet før en rekke generasjoner for å sjekke tilgjengelig kvota.