MCP eszközök referenciaanyaga

Minden eszköz az content MCP tartalmi blokkok tömbjét adja vissza. A szöveg eszközök { type: "text", text: "<json-string>" } értéket adnak vissza. A kép eszközök { type: "image", data: "<base64>", mimeType: "image/png" } értéket adnak vissza. Hiba esetén az isError: true beállítva van, és a szöveg blokk tartalmazza a hibaüzenetet.

Fájl eszközök

`list-files`

Listázza az aktuális felhasználó Flowstep fájljait. Bemenet

Parameter	Type	Default	Description
`orderByCreation`	`boolean`	`true`	Rendezés a létrehozás dátuma szerint
`limit`	`integer` (1–100)	`20`	Visszaadandó fájlok száma
`offset`	`integer` (≥0)	`0`	Lapozási eltolás

Kimenet – A fájlobjektumok JSON-tömbjei.

[
  {
    "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`

Egyetlen fájl lekérése azonosító alapján. A fájl tartalma szándékosan ki van hagyva – a képernyők ellenőrzéséhez a get-screen vagy get-screen-image címet használja, az csatolt irányelvek lekéréséhez a get-design-guidelines címet. Bemenet

Parameter	Type	Description
`id`	`uuid`	Fájl azonosítója

Kimenet – JSON fájl objektum.

{
  "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`

Új Flowstep fájl létrehozása. Bemenet

Parameter	Type	Description
`title`	`string` (min 1)	Fájl neve

Kimenet – JSON fájl objektum az új fájl id értékével.

{
  "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"
}

Használja a visszaadott id értéket az azt követő eszközhívások fileId értékeként.

`update-file`

Fájl átnevezése. Bemenet

Parameter	Type	Description
`id`	`uuid`	Fájl azonosítója
`name`	`string` (min 1)	Új név

Kimenet – Frissített fájl objektum azonos alakzatban, mint a get-file.

{
  "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`

Fájl végleges törlése. Az átadott name érték az a fájl tényleges neve alapján kerül ellenőrzésre az előző törléshez – ha nem egyezik, a törlés abbamarad. Ez megakadályozza a rossz fájl véletlen törlését. Bemenet

Parameter	Type	Description
`id`	`uuid`	Fájl azonosítója
`name`	`string`	A fájl aktuális neve – pontosan meg kell egyeznie, különben a törlés abbamarad

Kimenet – "File deleted successfully"

Ez visszafordíthatatlan. A fájl összes képernyője törlésre kerül.

Képernyő eszközök

`list-screens`

Fájl összes generált képernyőjének listázása. A visszaadott screenId értékeket a képernyőkre a get-screen, get-screen-image címekben, valamint a célt az edit-design, regenerate-design vagy expand-design függvényekben. Bemenet

Parameter	Type	Description
`fileId`	`uuid`	Fájl azonosítója

Kimenet – A képernyő-összefoglalások JSON-tömbje.

[
  {
    "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"
  }
]

A name a felhasználó által kijelölt képernyő neve, vagy null, ha névtelen.

`get-screen`

Képernyő JSX-kódját. Lehetővé teszi a kód szerkesztését vagy a Flowstep-en kívüli felhasználást. A vizuális előnézethez használja a get-screen-image függvényt. Bemenet

Parameter	Type	Description
`fileId`	`uuid`	Fájl azonosítója
`screenId`	`uuid`	Az `list-screens` által visszaadott vagy egy tervezési eszköz által visszaadott `screenIds` tömbből kapott `screenId`

Kimenet – A képernyő kódként (JSX). Figyelje meg az első sor megjegyzéseket, amely a add-screen eszköz használatakor szükséges.

<!-- screenType: "iphone-x-vertical" width: "375" height: "812" name: "Change to a light theme" colorTheme: "blue" screenId: "c13d3707-0efe-49f5-b6cb-0ca5ac5223d0" -->
<div className="bg-white text-zinc-950 w-full h-fit">
  <div className="flex p-6 flex-col gap-6">
    <div className="flex pt-4 justify-between items-center">
      <ArrowLeft className="size-5 text-[#71717b]" />
      <span className="font-semibold text-zinc-950 text-lg leading-7">
        World Clock
      </span>
      <Plus className="size-5 text-[#2b7fff]" />
    </div>
    <div className="rounded-xl bg-zinc-100 flex p-2 items-center gap-2">
      <Search className="size-4 text-[#71717b] ml-2" />
      <span className="text-[#71717b] text-sm leading-5">Search cities...</span>
    </div>
...
    <div className="flex pt-2 pb-4 justify-center items-center gap-4">
      <Button variant="outline" className="rounded-full px-6 gap-2">
        <Clock className="size-4" />
        <span>Compare</span>
      </Button>
      <Button className="rounded-full bg-[#2b7fff] text-blue-50 px-6 gap-2">
        <Bell className="size-4" />
        <span>Set Alert</span>
      </Button>
    </div>
  </div>
</div>;

`add-screen`

Adds a new screen to a Flowstep file from a raw JSX string. Bemenet

Parameter	Type	Description
`fileId`	`uuid`	Fájl azonosítója
`jsxContent`	`string`	JSX, amely a fájlhoz képernyőként kerül hozzáadásra
`screenType`	`string`	Szükséges, ha a képernyő típusa nem lett megjegyzésként meghatározva a JSX elején

Megjegyzés - A JSX első sorában egy az alábbihoz hasonló megjegyzésnek jelen kell lennie, mivel az a képernyő helyes hozzáadásához használatos. A screenType, name és screenId opcionálisak – a screenId használva van (belsőleg), ha jelen van (pl. ha a get-screen kimenetből másolt JSX kerül átadásra), de nem kötelező. A képernyő neve a megjegyzés name mezőjéből származik (megjelenik mint “Copy of <name>”), vagy “Untitled” ha hiányzik.  Kimenet – Az újonnan hozzáadott képernyő identifikátora.

{ "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbf" }

`get-screen-image`

Render a screen to PNG and return it as an inline image. Requires a client that supports image content blocks. Bemenet

Parameter	Type	Description
`fileId`	`uuid`	Fájl azonosítója
`screenId`	`uuid`	Az `list-screens` által visszaadott vagy egy tervezési eszköz által visszaadott `screenIds` tömbből kapott `screenId`

Kimenet – MCP képtartalmi blokk (image/png).

AI eszközök

A regenerate-design, expand-design és edit-design szükséges tervkontextust, amely csak a designs tömbbel generált képernyőn létezik. A tervkontextus nélkül generált képernyők hibát adnak vissza.

`create-new-design`

Generate one or more screen designs from a text prompt. Omit fileId to create a new file automatically. Blocks until generation completes or times out (180 seconds). Bemenet

Parameter	Type	Default	Description
`fileId`	`uuid`	—	Target file — omit to create a new file automatically. Required when `targets` is set
`message`	`string`	—	Prompt describing the screens to generate
`targets`	`uuid[]`	`[]`	Optional visual references — `screenId`s from `list-screens` and/or subelement IDs from `get-screen`. The referenced screens are used only as visual inspiration; they are not edited in place
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	Pre-uploaded attachments — images, PDFs, or code files. Always upload via `upload-attachment` first; do not inline file contents in the message
`designs`	`DesignRequestData[]`	`[]`	Design references

Kimenet – { fileId, screenIds, designGuidelinesUpdated }. Adja meg mindegyik screenId értéket a get-screen-image függvénynek az eredmények megtekintéséhez. designGuidelinesUpdated azt jelzi, hogy a fájl tervezési irányelvei megváltoztak-e az adott generálás részeként.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenIds": ["3f9e6eb6-5525-4383-9375-67e0bd762dbe"]
}

`regenerate-design`

Redo existing screens from scratch or with a style variation. Requires at least one screenId in targets. Blocks until generation completes or times out (180 seconds). Bemenet

Parameter	Type	Default	Description
`fileId`	`uuid`	—	Target file
`message`	`string`	—	Prompt text
`targets`	`uuid[]` (min 1)	—	screenIds of screens to regenerate
`operationVariant`	`"different_layout" \| "different_style" \| "from_scratch"`	—	Required — how to redo the screen: `different_layout` (keep style and content, change the layout), `different_style` (keep layout and content, change colors and visual treatment), or `from_scratch` (new layout, style, and content for the same purpose)
`designs`	`DesignRequestData[]`	`[]`	Design references (resolved automatically)

Kimenet – { fileId, screenIds, designGuidelinesUpdated }. Adja meg mindegyik screenId értéket a get-screen-image függvénynek az eredmények megtekintéséhez.

`expand-design`

Add follow-on screens to an existing design. Requires at least one screenId in targets and a mandatory operationVariant. Blocks until generation completes or times out (180 seconds). Bemenet

Parameter	Type	Default	Description
`fileId`	`uuid`	—	Target file
`message`	`string`	—	Prompt text
`targets`	`uuid[]` (min 1)	—	screenIds of screens to expand from
`operationVariant`	`"next_screen" \| "error_state" \| "empty_state" \| "web_version" \| "mobile_version" \| "tablet_version" \| "mobile_ios_version" \| "mobile_android_version"`	—	Required — type of follow-on screen to generate
`designs`	`DesignRequestData[]`	`[]`	Design references (resolved automatically)

Kimenet – { fileId, screenIds, designGuidelinesUpdated }. Adja meg mindegyik screenId értéket a get-screen-image függvénynek az eredmények megtekintéséhez.

`edit-design`

Modify existing screens via a prompt. Requires at least one screenId in targets. Blocks until generation completes or times out (180 seconds). Bemenet

Parameter	Type	Default	Description
`fileId`	`uuid`	—	Target file
`message`	`string`	—	Instructions describing the edits to apply
`targets`	`uuid[]` (min 1)	—	screenIds of screens to edit
`operationVariant`	`"dark_theme" \| "light_theme" \| "make_pretty"`	—	Optional style shortcut
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	Pre-uploaded attachments. Always upload via `upload-attachment` first
`designs`	`DesignRequestData[]`	`[]`	Design references (resolved automatically)

Kimenet – { fileId, screenIds, designGuidelinesUpdated }. Adja meg mindegyik screenId értéket a get-screen-image függvénynek az eredmények megtekintéséhez.

`upload-attachment`

Upload a file to use as an attachment in create-new-design or edit-design (not regenerate-design or expand-design). File bytes never pass through the model, and the server never fetches URLs on your behalf. There are two modes — use exactly one, and don’t combine them. Mode A — files and images (mimeType + fileName) A required three-step flow for any image, PDF, or larger text file:

Call upload-attachment with mimeType and fileName only (for example image/png and dog.png). The response is a prepared upload, not a stored file:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "image",
  "mimeType": "image/png",
  "signedUrl": "https://…",
  "uploadCommand": "curl -sS -f -X PUT '…' -H 'Content-Type: image/png' -H 'x-metadata: …' --data-binary @LOCAL_FILE_PATH",
  "nextStep": "…"
}

Replace LOCAL_FILE_PATH in uploadCommand with the absolute path to your file and run that exact command in your shell — it must exit 0. The token in signedUrl authorizes only this single upload. Skipping this step leaves storage empty and the design tool fails its preflight check.
Pass only { id, path, type } into the design tool’s attachments array — not signedUrl, uploadCommand, or nextStep.

To attach a remote file, download it to a local path yourself first (for example with curl), then follow the same three steps. Never pass a URL to upload-attachment.

Parameter	Type	Description
`mimeType`	enum	File MIME type. One of `image/jpeg`, `image/png`, `image/webp`, `application/pdf`, `text/markdown`, `text/plain`, `text/javascript`. Use `text/javascript` for `.jsx`, `.tsx`, `.js`, `.ts` files
`fileName`	`string` (min 1)	Original filename with extension, for example `cat.png` or `design.md`

Mode B — short text (text + mimeType) Upload text that’s already in context — no shell command needed. The response is ready to use directly:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "document",
  "mimeType": "text/plain"
}

Parameter	Type	Description
`text`	`string` (max 64,000 chars)	Raw text content. Text files only — don’t use for images or PDFs. Longer than 64,000 characters? Use Mode A instead
`mimeType`	enum	One of `text/markdown`, `text/plain`, `text/javascript`

Pass the resulting { id, path, type } into the attachments array of create-new-design or edit-design. Maximum file size is 3 MB across both modes, and PDFs are capped at 100 pages. type is "image" for image files and "document" for PDFs and text files.

Chat tools

`get-chat-history`

Get the chat message history for a file. Bemenet

Parameter	Type	Description
`fileId`	`uuid`	File ID

Kimenet – JSON objektum egy messages tömbbel. Minden üzenetnek van egy type ("request" vagy "response"), author ("human" vagy "ai"), és content_type ("text", "summary", vagy "followup") értéke.

{
  "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": []
    }
  ]
}

Design tools

`get-design-guidelines`

Get the design guidelines stored for a file. Bemenet

Parameter	Type	Default	Description
`resourceId`	`uuid`	—	File ID
`linkedTo`	`"file"`	`"file"`	Resource type

Kimenet

{
  "guidelines": "## Colors\n\nPrimary: #6366F1\nBackground: #FFFFFF\n\n## Typography\n\nFont: Inter",
  "linkedTo": "file"
}

guidelines az null, ha nincs beállított irányelvek.

`update-design-guidelines`

Set or replace the design guidelines for a file. Guidelines are passed as a plain text string in Google’s design.md format — do not pass an object or JSON. The server performs soft validation and may return a Warnings: section in the response listing issues (unknown keys, non-hex colours) that were accepted but may be ignored by the AI. Surface these to the user. Bemenet

Parameter	Type	Default	Description
`resourceId`	`uuid`	—	File ID
`designGuidelines`	`string` (min 1)	—	Raw text content of the guidelines. Must be a plain string — not JSON-encoded
`linkedTo`	`"file"`	`"file"`	Resource type

Validation rules

Frontmatter must be opened and closed correctly
Frontmatter lines must be valid block-style YAML
Markdown body must not contain duplicate ## section headings

Kimenet – "Design guidelines updated successfully", opcionálisan ezt követi az Warnings: szakasz.

`delete-design-guidelines`

Clear the design guidelines for a file. Bemenet

Parameter	Type	Default	Description
`resourceId`	`uuid`	—	File ID
`linkedTo`	`"file"`	`"file"`	Resource type

Kimenet – "Design guidelines deleted successfully"

Figma tools

`import-figma`

Import a Figma frame into a Flowstep file as editable elements on its canvas. Re-importing the same frame updates it in place. The file’s organization must have Figma connected in Flowstep settings. Bemenet

Parameter	Type	Description
`figmaUrl`	`string`	Link to a specific Figma frame. In Figma, right-click the frame and choose Copy link to selection. A link to a page imports all top-level frames on that page (capped at 20 frames over MCP).
`fileId`	`uuid`	The Flowstep file to import the frame into

Kimenet – { fileId, screenId }. screenId az importált képernyő elem azonosítója – adja meg a get-screen-image függvénynek az eredmény megtekintéséhez. Amikor egy oldal URL-je több keretet importál, a screenId értéke null, és helyette a frameCount kerül visszaadásra.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe"
}

Billing tools

`get-plan-details`

Get the current user’s plan, subscription status, and remaining quota. Takes no input. Kimenet

{
  "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 }
  }
}

Limits vary by plan. Call this tool before a batch of generations to check available quota.

Első lépések

A Flowstep használata

Csapatok és szervezetek

Exportálás és integrációk

MCP-szerver

Számlázás és csomagok

Biztonság és adatvédelem

MCP eszközök referenciaanyaga

Fájl eszközök

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Képernyő eszközök

`list-screens`

`get-screen`

`add-screen`

`get-screen-image`

AI eszközök

`create-new-design`

`regenerate-design`

`expand-design`

`edit-design`

`upload-attachment`

Chat tools

`get-chat-history`

Design tools

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Figma tools

`import-figma`

Billing tools

`get-plan-details`

​Fájl eszközök

​list-files

​get-file

​create-file

​update-file

​delete-file

​Képernyő eszközök

​list-screens

​get-screen

​add-screen

​get-screen-image

​AI eszközök

​create-new-design

​regenerate-design

​expand-design

​edit-design

​upload-attachment

​Chat tools

​get-chat-history

​Design tools

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Figma tools

​import-figma

​Billing tools

​get-plan-details

Fájl eszközök

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Képernyő eszközök

`list-screens`

`get-screen`

`add-screen`

`get-screen-image`

AI eszközök

`create-new-design`

`regenerate-design`

`expand-design`

`edit-design`

`upload-attachment`

Chat tools

`get-chat-history`

Design tools

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Figma tools

`import-figma`

Billing tools

`get-plan-details`