MCP rīku atsauce

Visi rīki atgriež content masīvu ar MCP satura blokiem. Teksta rīki atgriež { type: "text", text: "<json-string>" }. Attēlu rīki atgriež { type: "image", data: "<base64>", mimeType: "image/png" }. Kļūmes gadījumā isError: true tiek iestatīts un teksta bloks satur kļūdas ziņojumu.

Faila rīki

`list-files`

Uzskaitīt Flowstep failus pašreizējam lietotājam. Ieejas

Parametrs	Tips	Noklusējums	Apraksts
`orderByCreation`	`boolean`	`true`	Kārtot pēc izveides datuma
`limit`	`integer` (1–100)	`20`	Atgriezt failu skaits
`offset`	`integer` (≥0)	`0`	Lapošanas nobīde

Izvade — JSON masīvs ar failu objektiem.

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

Iegūt atsevišķu failu pēc ID. Faila saturs apzināti tiek izlaists — izmantojiet get-screen vai get-screen-image, lai pārbaudītu ekrānus, un get-design-guidelines, lai iegūtu pievienotās vadlīnijas. Ieejas

Parametrs	Tips	Apraksts
`id`	`uuid`	Faila ID

Izvade — JSON faila objekts.

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

Izveidot jaunu Flowstep failu. Ieejas

Parametrs	Tips	Apraksts
`title`	`string` (min 1)	Faila nosaukums

Izvade — JSON faila objekts ar jaunā faila id.

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

Atgrieztā id izmantojiet kā fileId nākamajā rīku izsaukumā.

`update-file`

Pārdēvēt failu. Ieejas

Parametrs	Tips	Apraksts
`id`	`uuid`	Faila ID
`name`	`string` (min 1)	Jaunais nosaukums

Izvade — Atjaunināts faila objekts tādā pašā formā kā 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`

Neatgriezenski izdzēst failu. Jūsu norādītais name tiek pārbaudīts pret faila faktisko nosaukumu pirms dzēšanas — ja tas neatbilst, dzēšana tiek atcelta. Tas novērš nejaušu nepareizā faila dzēšanu. Ieejas

Parametrs	Tips	Apraksts
`id`	`uuid`	Faila ID
`name`	`string`	Pašreizējais faila nosaukums — jābūt precīzai atbilstībai, citādi dzēšana tiek atcelta

Izvade — "File deleted successfully"

Tas ir neatgriezenisks. Visi faila ekrāni tiek izdzēsti.

Ekrāna rīki

`list-screens`

Uzskaitīt visus ģenerētos ekrānus failam. Izmantojiet atgrieztos screenId vērtības, lai atsauktos uz ekrāniem get-screen, get-screen-image, upload-attachment un kā targets edit-design, regenerate-design vai expand-design. Ieejas

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID

Izvade — JSON masīvs ar ekrāna kopsummariem.

[
  {
    "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 ir lietotāja piešķirtais ekrāna nosaukums vai null, ja tas nav nosaukts.

`get-screen`

Iegūt ekrāna JSX kodu, ļaujot jums rediģēt vai izmantot kodu ārpus Flowstep. Izmantojiet get-screen-image vizuālas priekšskatījuma iegūšanai. Ieejas

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID
`screenId`	`uuid`	`screenId` ko atgrieza `list-screens` vai no `screenIds` masīva ko atgrieza dizaina rīks

Izvade — Ekrāns kā kods (JSX). Ievērojiet pirmo rindu komentāru, kas ir nepieciešams, izmantojot add-screen rīku.

<!-- 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`

Pievienot jaunu ekrānu Flowstep failam no raw JSX virknes. Ieejas

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID
`jsxContent`	`string`	JSX, ko pievienot failam kā ekrānu
`screenType`	`string`	Nepieciešams, ja ekrāna tips nav norādīts kā komentārs JSX sākumā

Piezīme — Komentārs, kas līdzīgs zemāk esošajam, JĀBŪT kā pirmajam JSX rindai, jo tas tiek izmantots, lai pareizi pievienotu ekrānu. screenType, name un screenId visi ir fakultatīvi — screenId tiek izmantots (iekšēji), ja tas ir klāt (piemēram, kad tiek izsūtīts JSX, ko nokopēts no get-screen izvades), bet tas nav obligāts. Ekrāna nosaukums tiek ņemts no komentāra name lauka (parādīts kā “Copy of <name>”), vai “Untitled”, ja tas trūkst.  Izvade — Jaunizveidotā ekrāna Id.

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

`get-screen-image`

Renderēt ekrānu PNG formātā un atgriezt to kā iekļautu attēlu. Nepieciešams klients, kas atbalsta attēlu satura blokus. Ieejas

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID
`screenId`	`uuid`	`screenId` ko atgrieza `list-screens` vai no `screenIds` masīva ko atgrieza dizaina rīks

Izvade — MCP attēla satura bloks (image/png).

AI rīki

regenerate-design, expand-design un edit-design pieprasa dizaina kontekstu, kas ir klāt tikai ekrānos, kas ģenerēti ar designs masīvu. Ekrāni, kas ģenerēti bez dizaina konteksta, atgriezīs kļūdu. Risinājums: izmantojiet upload-attachment, lai renderētu ekrānu kā attēlu, tad izsauciet create-new-design ar attēlu attachments un ziņojumu, kas apraksta vēlamos izmaiņas.

`create-new-design`

Ģenerēt vienu vai vairākus ekrāna dizainus no teksta uzvednes. Izlaidiet fileId, lai automātiski izveidotu jaunu failu. Bloķē līdz ģenerēšana ir pabeigta vai izskatņa dēļ (180 sekundes). Ieejas

Parametrs	Tips	Noklusējums	Apraksts
`fileId`	`uuid`	—	Mērķa fails — izlaidiet, lai automātiski izveidotu jaunu failu
`message`	`string`	—	Uzvedne, kas apraksta ģenerējamos ekrānus
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	Iepriekš augšupielādēti pielikumi — attēli, PDF vai koda faili. Vienmēr vispirms augšupielādējiet caur `upload-attachment`; neiekļaujiet faila saturu paziņojumā
`designs`	`DesignRequestData[]`	`[]`	Dizaina atsauces

Izvade — { fileId, screenIds }. Nododiet katru screenId uz get-screen-image, lai skatītu rezultātus.

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

`regenerate-design`

Pārdarīt esošus ekrānus no sākuma vai ar stila variantu. Nepieciešams vismaz viens screenId targets. Bloķē līdz ģenerēšana ir pabeigta vai izskatņa dēļ (180 sekundes). Ieejas

Parametrs	Tips	Noklusējums	Apraksts
`fileId`	`uuid`	—	Mērķa fails
`message`	`string`	—	Uzvedne teksts
`targets`	`uuid[]` (min 1)	—	screenIds no ekrāniem, ko regenerēt
`operationVariant`	`"different_layout" \| "different_style" \| "from_scratch"`	—	Fakultatīvs stila variants
`designs`	`DesignRequestData[]`	`[]`	Dizaina atsauces (automātiski atrisinātas)

Izvade — { fileId, screenIds }. Nododiet katru screenId uz get-screen-image, lai skatītu rezultātus.

`expand-design`

Pievienot turpinājuma ekrānus esošam dizainam. Nepieciešams vismaz viens screenId targets un obligāts operationVariant. Bloķē līdz ģenerēšana ir pabeigta vai izskatņa dēļ (180 sekundes). Ieejas

Parametrs	Tips	Noklusējums	Apraksts
`fileId`	`uuid`	—	Mērķa fails
`message`	`string`	—	Uzvedne teksts
`targets`	`uuid[]` (min 1)	—	screenIds no ekrāniem, no kuriem paplašināt
`operationVariant`	`"next_screen" \| "error_state" \| "empty_state" \| "web_version" \| "mobile_version" \| "tablet_version" \| "mobile_ios_version" \| "mobile_android_version"`	—	Nepieciešams — ģenerējamā turpinājuma ekrāna tips
`designs`	`DesignRequestData[]`	`[]`	Dizaina atsauces (automātiski atrisinātas)

Izvade — { fileId, screenIds }. Nododiet katru screenId uz get-screen-image, lai skatītu rezultātus.

`edit-design`

Modificēt esošus ekrānus caur uzvedni. Nepieciešams vismaz viens screenId targets. Bloķē līdz ģenerēšana ir pabeigta vai izskatņa dēļ (180 sekundes). Ieejas

Parametrs	Tips	Noklusējums	Apraksts
`fileId`	`uuid`	—	Mērķa fails
`message`	`string`	—	Norādījumi, kas apraksta lietojamos rediģējumus
`targets`	`uuid[]` (min 1)	—	screenIds no ekrāniem, ko rediģēt
`operationVariant`	`"dark_theme" \| "light_theme" \| "make_pretty"`	—	Fakultatīvs stila saīsinājums
`attachments`	`AttachmentRequestData[]` (max 5)	`[]`	Iepriekš augšupielādēti pielikumi. Vienmēr vispirms augšupielādējiet caur `upload-attachment`
`designs`	`DesignRequestData[]`	`[]`	Dizaina atsauces (automātiski atrisinātas)

Izvade — { fileId, screenIds }. Nododiet katru screenId uz get-screen-image, lai skatītu rezultātus.

`upload-attachment`

Augšupielādēt failu, lai izmantotu kā pielikumu create-new-design vai edit-design. Atgriež { id, path, type, mimeType } — nodod šo objektu tieši attachments masīvā. Divi režīmi: Režīms 1 — Ekrāns pēc ID Nododiet screenId un fileId. Serveris iegūst ekrāna stāvokli no datu bāzes un renderē to kā attēlu.

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Fails, kas satur ekrānu (nepieciešams)
`screenId`	`uuid`	Renderējamais ekrāns

Režīms 2 — Ārējais fails Nodot faila saturu tieši. Binārie faili jākodē base64; teksta faili (ieskaitant pirmkodu) tiek nodoti kā parasts UTF-8 strings.

Parametrs	Tips	Apraksts
`fileData`	`string`	Faila saturs — base64 bināram, UTF-8 strings tekstam
`fileName`	`string`	Sākotnējais faila nosaukums
`mimeType`	`"image/jpeg" \| "image/png" \| "image/webp" \| "application/pdf" \| "text/plain" \| "text/javascript"`	MIME tips. Izmantojiet `text/javascript` `.jsx`, `.tsx`, `.js`, `.ts` failiem

Maksimālais faila izmērs: 3 MB. Lielem attēliem, dod priekšroku image/jpeg pār image/png. Izvade

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "image",
  "mimeType": "image/jpeg"
}

type ir "image" attēlu/PDF augšupielādes un "document" teksta/koda failiem.

Tērzēšanas rīki

`get-chat-history`

Iegūt tērzēšanas ziņojumu vēsturi failam. Ieejas

Parametrs	Tips	Apraksts
`fileId`	`uuid`	Faila ID

Izvade — JSON objekts ar messages masīvu. Katram ziņojumam ir type ("request" vai "response"), author ("human" vai "ai"), un content_type ("text", "summary" vai "followup").

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

Dizaina rīki

`get-design-guidelines`

Iegūt dizaina vadlīnijas, kas uzglabātas failam. Ieejas

Parametrs	Tips	Noklusējums	Apraksts
`resourceId`	`uuid`	—	Faila ID
`linkedTo`	`"file"`	`"file"`	Resursa tips

Izvade

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

guidelines ir null, ja vadlīnijas nav iestatītas.

`update-design-guidelines`

Iestatīt vai aizstāt dizaina vadlīnijas failam. Vadlīnijas tiek nodotas kā vienkāršs teksts virkne Google design.md formātā — nelikt objektu vai JSON. Serveris veic mīkstu validāciju un var atgriezt Warnings: sekciju atbildē, kurā uzskaitīti problēmas (nezināmi atslēgas, ne-heksadecimālas krāsas), kas tika pieņemtas, bet var tikt ignorētas no AI. Parādiet tās lietotājam. Ieejas

Parametrs	Tips	Noklusējums	Apraksts
`resourceId`	`uuid`	—	Faila ID
`designGuidelines`	`string` (min 1)	—	Raw teksts saturs vadlīnijām. Jābūt vienkāršam stringam — ne JSON-encoded
`linkedTo`	`"file"`	`"file"`	Resursa tips

Validācijas noteikumi

Frontmatter jābūt atkal atvērtam un aizvērtam pareizi
Frontmatter rindas jābūt derīgam blokkstila YAML
Markdown ķermenis nedrīkst saturēt dubultos ## sekciju virsrakstus

Izvade — "Design guidelines updated successfully", fakultatīvi sekojot Warnings: sekcija.

`delete-design-guidelines`

Notīrīt dizaina vadlīnijas failam. Ieejas

Parametrs	Tips	Noklusējums	Apraksts
`resourceId`	`uuid`	—	Faila ID
`linkedTo`	`"file"`	`"file"`	Resursa tips

Izvade — "Design guidelines deleted successfully"

Norēķinu rīki

`get-plan-details`

Iegūt pašreizējā lietotāja plānu, abonēšanas statusu un atlikušo kvotu. Neņem ieeju. Izvade

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

Ierobežojumi atšķiras atkarībā no plāna. Izsauciet šo rīku pirms ģenerēšanas partijas, lai pārbaudītu pieejamo kvotu.

​Faila rīki

​list-files

​get-file

​create-file

​update-file

​delete-file

​Ekrāna rīki

​list-screens

​get-screen

​add-screen

​get-screen-image

​AI rīki

​create-new-design

​regenerate-design

​expand-design

​edit-design

​upload-attachment

​Tērzēšanas rīki

​get-chat-history

​Dizaina rīki

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Norēķinu rīki

​get-plan-details

Faila rīki

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Ekrāna rīki

`list-screens`

`get-screen`

`add-screen`

`get-screen-image`

AI rīki

`create-new-design`

`regenerate-design`

`expand-design`

`edit-design`

`upload-attachment`

Tērzēšanas rīki

`get-chat-history`

Dizaina rīki

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Norēķinu rīki

`get-plan-details`