← The evidence ledger
Evidence row 772084
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint de187d1b-a110-47d0-a3db-e553a9e8d52e
- Recorded
- Previous row
- #583728
- Body SHA-256
- 2ae0991c79dd03e0ee69653f3f30137190ba2922df0a378d5be5ec334c88947a
- Leaf
- 0x6ca769d48472e09b54b436f873cc448f365c01b6f496998ad1147293674c1064
What was observed
{
"count": 51,
"tools": [
{
"description": "Attach one of YOUR OWN Google accounts to the pool using an oauth_token captured\n on the USER'S OWN machine (password/2FA never leave it). This is the self-serve\n onboarding path — no server-side browser, no SSH.\n\n PREFERRED PATH — no oauth_token handling at all: call flow_status; its\n `next_step.command` holds a PERSONAL one-line command per OS (mac / linux / win) with\n the owner's ticket inside. RUN IT YOURSELF in the user's terminal. The script submits\n the token to the server by itself and prints \"Готово — аккаунт ... подключён\"; you do\n NOT call add_account_token afterwards. (The same command is shown to the user in the\n cabinet: https://openflowmcp.com/account#accounts.) Node 22+ is the only requirement.\n\n FALLBACK (only if flow_status has no command, or the script says it could not submit\n automatically) — run the generic command, which has no ticket and just prints a line:\n\n curl -sL https://openflowmcp.com/onboard_local.js | node\n\n Windows PowerShell:\n\n irm https://openflowmcp.com/onboard_local.js -OutFile o.js; node o.js\n\n It opens the user's own Chrome at accounts.google.com/EmbeddedSetup. Tell them to log\n in and press Accept, then wait until the page hangs on a spinner (normal, the token is\n already issued), then go BACK to the terminal window running the script and press\n Enter — the script grabs the token only after Enter, it does not do it by itself. Do\n not close the browser window before that. The script prints ONE JSON line: {\"status\":200,\"oauth_token\":...,\n \"email\":...}; with a personal command it also adds \"submitted\":true, which means the\n account is already connected and you are done. Without \"submitted\":true, pass\n oauth_token and email here.\n\n If it prints \"need_email\": true, the account address could not be read off the page —\n ask the user which Google account they just signed into and pass that as `email`, or\n re-run with ONBOARD_EMAIL=them@gmail.com in front of the command.\n\n The oauth_token is SINGLE-USE: if this call fails, the user must log in again for a\n FRESH token — never retry the same one.\n\n On success the account is bound to YOUR key's owner group and the worker picks it up\n within ~30s (no restart). Adding an account is always allowed — even for a key that\n has already spent its free quota, since that is a prerequisite, not a reward.\n\n Only onboard accounts YOU control — a master token grants full account access.",
"inputSchema": {
"properties": {
"email": {
"title": "Email",
"type": "string"
},
"oauth_token": {
"title": "Oauth Token",
"type": "string"
},
"reset_day": {
"default": 0,
"title": "Reset Day",
"type": "integer"
}
},
"required": [
"email",
"oauth_token"
],
"title": "add_account_tokenArguments",
"type": "object"
},
"name": "add_account_token"
},
{
"description": "Begin connecting a Google ANTIGRAVITY account (used by the Claude/Gemini models via\n OmniRoute — not a Google Flow account). Returns `authorize_url` and `state`.\n\n The next step is on the USER's side: give them `next_step` wording and the URL, they\n sign in and press Accept in their browser and hand you the `code=...` value from the\n antigravity.google/oauth-callback page. Then call add_antigravity_submit(code, state)\n with the `state` returned here.",
"inputSchema": {
"properties": {},
"title": "add_antigravity_startArguments",
"type": "object"
},
"name": "add_antigravity_start"
},
{
"description": "Finish connecting a Google Antigravity account started with add_antigravity_start.\n\n `code` is the value of `?code=...` on the antigravity.google/oauth-callback page the\n user landed on; `state` is what add_antigravity_start returned. Returns\n {status, account_id, account_email, requires_project}. By default this also creates\n the GCP project in one step (`complete=True`) and adds `project_id`. Pass\n `complete=False` to defer and call `complete_antigravity_account(account_id)` later.\n If auto-onboarding fails the result keeps `requires_project: true` and carries\n `onboard_error`; retry with `complete_antigravity_account(account_id)`. Errors:\n \"unknown state\" (start again) or \"google_api_error\" (the code was rejected or\n already used; start again).",
"inputSchema": {
"properties": {
"code": {
"title": "Code",
"type": "string"
},
"complete": {
"default": true,
"title": "Complete",
"type": "boolean"
},
"state": {
"title": "State",
"type": "string"
}
},
"required": [
"code",
"state"
],
"title": "add_antigravity_submitArguments",
"type": "object"
},
"name": "add_antigravity_submit"
},
{
"description": "Запрос к Claude Sonnet 4.6 через вашу подписку Anthropic (если подключена) или\n через подписку Google (Vertex). Поддерживает инструменты (tool_use).\n\n Args:\n messages: список {\"role\": \"user|assistant\", \"content\": \"...\"}.\n system: системный промпт (опционально).\n max_tokens: максимальное количество токенов в ответе.\n tools: описание инструментов в формате Anthropic tool_use (опционально).\n account_email: форсировать конкретный Google-аккаунт.\n account_tag: форсировать аккаунты с указанным тэгом.\n\n Returns:\n {\"text\": str, \"usage\": {...}}. Если модель решила звать инструмент,\n дополнительно вернётся \"tool_calls\": [...].\n\n Raises:\n MCPError: если ключ невалиден, подписка не подключена, или квота исчерпана.\n ",
"inputSchema": {
"properties": {
"account_email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account Email"
},
"account_tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account Tag"
},
"max_tokens": {
"default": 4000,
"title": "Max Tokens",
"type": "integer"
},
"messages": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Messages",
"type": "array"
},
"system": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "System"
},
"tools": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Tools"
}
},
"required": [
"messages"
],
"title": "chat_claude_sonnetArguments",
"type": "object"
},
"name": "chat_claude_sonnet"
},
{
"description": "Быстрый и дешёвый Gemini 3 Flash — для коротких запросов, классификации,\n извлечения полей из текста. Идёт в вашу подписку Google, наши токены не тратит.\n\n Args:\n messages: список {\"role\": \"user|assistant\", \"content\": \"...\"}.\n system: системный промпт (опционально).\n max_tokens: максимальное количество токенов в ответе (по умолчанию 65536 — максимум модели,\n допустимо 1..65536). ВАЖНО: токены «размышления» Gemini 3 входят в этот\n лимит — при малом значении ответ обрывается (finish_reason \"length\").\n thinking_budget: бюджет токенов на размышление (необязательно): 0 — выключить\n (если модель позволяет), -1 — динамически, N — верхняя граница.\n thinking_level: уровень размышления (необязательно): \"low\" | \"high\"\n (у Flash ещё \"minimal\" / \"medium\"). Приоритетнее thinking_budget.\n account_email: форсировать конкретный Google-аккаунт.\n account_tag: форсировать аккаунты с указанным тэгом.\n\n Returns:\n {\"text\": str, \"usage\": {\"input_tokens\": int, \"output_tokens\": int}}.\n\n Raises:\n MCPError: если ключ невалиден, Google не подключён, или квота исчерпана.\n ",
"inputSchema": {
"properties": {
"account_email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account Email"
},
"account_tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account Tag"
},
"max_tokens": {
"default": 65536,
"title": "Max Tokens",
"type": "integer"
},
"messages": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Messages",
"type": "array"
},
"system": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "System"
},
"thinking_budget": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Thinking Budget"
},
"thinking_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Thinking Level"
}
},
"required": [
"messages"
],
"title": "chat_gemini_flashArguments",
"type": "object"
},
"name": "chat_gemini_flash"
},
{
"description": "Запрос к Gemini 3 Pro через вашу подписку Google AI Pro.\n\n Использует ваш подключённый Google-аккаунт (подключите на /connect-google).\n Расходует вашу квоту Google, не наши токены.\n\n Args:\n messages: список {\"role\": \"user|assistant\", \"content\": \"...\"}.\n system: системный промпт (опционально).\n max_tokens: максимальное количество токенов в ответе (по умолчанию 65536 — максимум модели,\n допустимо 1..65536). ВАЖНО: токены «размышления» Gemini 3 входят в этот\n лимит — при малом значении ответ обрывается (finish_reason \"length\").\n thinking_budget: бюджет токенов на размышление (необязательно): 0 — выключить\n (если модель позволяет), -1 — динамически, N — верхняя граница.\n thinking_level: уровень размышления (необязательно): \"low\" | \"high\"\n (у Flash ещё \"minimal\" / \"medium\"). Приоритетнее thinking_budget.\n account_email: форсировать конкретный Google-аккаунт из вашего пула\n (например, \"user@gmail.com\"). Если такого в пуле нет — ошибка.\n account_tag: форсировать аккаунты с указанным тэгом (round-robin\n по подмножеству пула; тэги назначаются в кабинете).\n\n Returns:\n {\"text\": str, \"usage\": {\"input_tokens\": int, \"output_tokens\": int}}.\n\n Raises:\n MCPError: если ключ невалиден, Google не подключён, или квота исчерпана.\n ",
"inputSchema": {
"properties": {
"account_email": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account Email"
},
"account_tag": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account Tag"
},
"max_tokens": {
"default": 65536,
"title": "Max Tokens",
"type": "integer"
},
"messages": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Messages",
"type": "array"
},
"system": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "System"
},
"thinking_budget": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Thinking Budget"
},
"thinking_level": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Thinking Level"
}
},
"required": [
"messages"
],
"title": "chat_gemini_proArguments",
"type": "object"
},
"name": "chat_gemini_pro"
},
{
"description": "Check projects for a Google account (or all). NOTE: for the credit BALANCE and a\n full at-a-glance overview, prefer `flow_dashboard()` — it returns real credit\n numbers per account + totals. This tool only returns the project list.",
"inputSchema": {
"properties": {
"account": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account"
}
},
"title": "check_creditsArguments",
"type": "object"
},
"name": "check_credits"
},
{
"description": "Check the status/result of a job previously returned by generate_image,\n generate_video, generate_video_from_image, or generate_video_with_reference.\n\n Besides status/result it reports PROGRESS, so you can tell the person something\n truthful instead of \"still waiting\":\n queue_position — how many jobs are ahead (1 = next to be picked up); only while queued\n queue_seconds — how long it sat in the queue\n run_seconds — how long the generation itself has been running\n account_used — which Google account it ran on, once finished\n while running, also:\n elapsed_s — seconds since the worker picked it up\n attempt / accounts_total — which of the owner's Google accounts is being tried\n (attempt > 1 means earlier accounts failed and it rotated on)\n phase — submitting | voice_synth | polling (polling = Google accepted it and\n it is rendering; that is the normal wait)\n last_error — why the previous account's attempt failed (emails masked)\n hint — the same thing in one human sentence\n A job that is queued behind others needs patience; one that has been running far longer\n than its model's typical time (see list_models) is the one worth reporting as stuck.\n Rotation has a ceiling: a video stops trying new accounts after ~10 min (images and voice\n after ~3 min), and stops early when the same error repeats on 3 accounts in a row — the\n job then fails with that error and the number of accounts tried, so tell the person the\n reason instead of retrying the identical request.\n\n Once status is 'done', SAVE THE FILES: the response carries `download_urls` (no auth\n header needed) and `save_as` (filenames). Write them into the user's project — e.g.\n ./media/<save_as> — and tell them where. The URLs expire within the hour, and the\n server's own copy can be reclaimed when its disk fills; the copy in their project is\n the one that lasts.",
"inputSchema": {
"properties": {
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"job_id": {
"title": "Job Id",
"type": "string"
}
},
"required": [
"job_id"
],
"title": "check_jobArguments",
"type": "object"
},
"name": "check_job"
},
{
"description": "Finish an Antigravity account started with add_antigravity_submit. Creates the GCP\n project needed before the account can serve LLM requests. Idempotent — safe to retry;\n already-onboarded accounts return their project_id.",
"inputSchema": {
"properties": {
"account_id": {
"title": "Account Id",
"type": "integer"
}
},
"required": [
"account_id"
],
"title": "complete_antigravity_accountArguments",
"type": "object"
},
"name": "complete_antigravity_account"
},
{
"description": "Send a message to the openFlow human operator (no Telegram needed).\n Replies come from a human, usually within hours; read them with support_replies.",
"inputSchema": {
"properties": {
"context": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Context"
},
"message": {
"title": "Message",
"type": "string"
}
},
"required": [
"message"
],
"title": "contact_supportArguments",
"type": "object"
},
"name": "contact_support"
},
{
"description": "Create a new, empty Flow character (just gets you an entity_id — no portrait/body,\n no description yet). Plain HTTP, no browser involved.\n\n Low-level building block — for \"make me a character from a description and generate\n its portrait\", call create_character_from_description instead of this; it does this\n step plus the two below in the right order for you.\n\n Next steps after you have entity_id, IN THIS ORDER (reversing them 500s on the first\n portrait write, confirmed live 2026-07-25): 1) update_character with\n personality_notes (and display_name) — the slot generation below needs a saved\n description to succeed at all; 2) generate_character_image with\n character_slot_index=0 (portrait), then =1 (body) — each slot accepts exactly ONE\n write, a second call into an already-filled slot 500s rather than overwriting.\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
}
},
"required": [
"account"
],
"title": "create_characterArguments",
"type": "object"
},
"name": "create_character"
},
{
"description": "Invent a new character from a text description and generate its portrait — the\n full \"make me a character, no photo involved\" path in ONE call, instead of gluing\n together create_character + update_character + generate_character_image yourself.\n\n name: short and unique among YOUR OWN characters (see list_characters()) — how\n you'll refer to this character afterwards, e.g. character=\"detective_marlowe\" in\n generate_with_face.\n description: physical description — build, hair, eyes, clothing, distinguishing\n features. Saved on the character's card AND used to generate the portrait, so\n write it as concretely as you would any image prompt.\n account: Google account (and its project) to create the character under.\n\n The portrait is written to Flow's card exactly ONCE — that slot cannot be\n regenerated. Calling this again with the SAME name does not retry it: it fails\n fast with a clear message instead of hitting a raw HTTP 500 downstream. Want a\n different look? Use a new name.\n\n Returns {\"name\", \"entity_id\", \"portrait_media_id\", \"portrait_url\", \"hint\"} once\n done. Next step for ANY further image of this character: generate_with_face(\n character=name, prompt=\"...\") — never entity_id/character_slot_index, which only\n works for that one portrait write and cannot place the character into new scenes.\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"aspect": {
"default": "IMAGE_ASPECT_RATIO_PORTRAIT",
"enum": [
"IMAGE_ASPECT_RATIO_LANDSCAPE",
"IMAGE_ASPECT_RATIO_PORTRAIT",
"IMAGE_ASPECT_RATIO_SQUARE",
"IMAGE_ASPECT_RATIO_LANDSCAPE_FOUR_THREE",
"IMAGE_ASPECT_RATIO_PORTRAIT_THREE_FOUR"
],
"title": "Aspect",
"type": "string"
},
"description": {
"title": "Description",
"type": "string"
},
"display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Display Name"
},
"model": {
"default": "BELUGA",
"enum": [
"BELUGA",
"GEM_PIX_2",
"HARBOR_SEAL"
],
"title": "Model",
"type": "string"
},
"name": {
"title": "Name",
"type": "string"
},
"portrait_prompt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Portrait Prompt"
}
},
"required": [
"name",
"description",
"account"
],
"title": "create_character_from_descriptionArguments",
"type": "object"
},
"name": "create_character_from_description"
},
{
"description": "Create a new Flow character whose portrait (and optionally body) is a REAL\n PHOTO, not a text description or generation. Both photos become the character's\n slot-0 (portrait) and slot-1 (body) images directly — Flow's own upload mechanism\n in its New Character composer, discovered live 2026-07-11 — no image generation\n call happens for either slot, so resemblance is exact, not \"similar style\". Boots\n the on-demand Chrome for this account (~15-30s, longer if body_photo_base64 is\n also given), same as create_character, no Android/recaptcha involved.\n\n photo_base64: raw base64-encoded image bytes, no data: URI prefix — portrait.\n body_photo_base64: same format, optional — ideally a full-body photo of the same\n person, for a guaranteed-exact body image (no generation at all for that slot).\n\n physical_description: IMPORTANT, look at the photo yourself and write this —\n a detailed physical description (build, hair color/style, eye color, clothing,\n distinguishing features), similar in spirit to: \"Adult male, mid-20s, ~180cm,\n lean build. Medium-brown wavy hair, light blue-grey eyes, faint stubble. Wears\n a dark grey hoodie, dark jeans, white sneakers.\" This gets saved into the same\n \"Character Info\" field as Flow's own UI. CORRECTED same day as this tool was\n first built: an earlier version of this doc claimed body/multi-view generation\n can never stay consistent with a photo-seeded portrait — WRONG, confirmed live.\n The actual missing ingredient was this detailed text spec — with it, both\n generate_character_turnaround and generate_character_expression_sheet below\n produce genuinely consistent, on-model results (reproduced live against Flow's\n real UI, not just guessed). Skip this only for a bare portrait-only character\n with no further generation planned.\n\n Next step after you have entity_id: update_character for a display name, then\n generate_character_turnaround / generate_character_expression_sheet if you want\n those (skip if you already passed body_photo_base64 for an exact body photo —\n generating over it would replace the real photo with a generated approximation).\n\n Fidelity note added 2026-07-11 (later same day): \"genuinely consistent\" above means\n consistent WITH ITSELF across panels (same invented-looking person in every view),\n not necessarily an exact match to the real person's face — real-world feedback was\n \"I don't recognize myself.\" Good for stylized/invented character sheets; if the goal\n is content that's recognizably the actual person, use generate_video_with_reference\n (r2v) instead, which conditions on the real photo's pixels rather than a description.\n\n name: optional, added 2026-07-25 — give the character a short human-readable name\n and it's saved to YOUR list (list_characters()), keyed on the uploaded photo as the\n identity reference (portrait_media_id). Once named, use\n generate_with_face(character=name, prompt=...) for further images instead of\n tracking portrait_media_id yourself. Must be unique among your own characters; a\n clash does NOT fail the call — the character is still created in Flow, just\n reported back with a `registration_error` instead of a `name` in the result, so\n pick a different name and register it yourself later if that happens.\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"body_photo_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Body Photo Base64"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
},
"photo_base64": {
"title": "Photo Base64",
"type": "string"
},
"physical_description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Physical Description"
}
},
"required": [
"account",
"photo_base64"
],
"title": "create_character_from_photoArguments",
"type": "object"
},
"name": "create_character_from_photo"
},
{
"description": "Create a NEW Flow project on one of your Google accounts and return its project_id.\n\n Use this to give every one of YOUR OWN clients their own namespace: create a project\n per client once, then pass that project_id to generate_image / generate_video so\n their results never mix with anyone else's.\n\n account — which Google account creates it (see flow_dashboard / check_credits for the\n emails). The project is created under that account, but a project id is a label every\n account accepts: generation keeps rotating accounts as before, so results stay grouped\n by project_id, not by account. What is still account-bound is media_ids — a follow-up\n that reuses one (image_inputs edit-in-place, extend_video, upscale) only works on the\n account that produced that particular frame, exactly as today.\n name — optional human-readable title, e.g. the client's name.\n\n The returned project is usable for generation IMMEDIATELY. It may not show up in the\n Flow web UI's project list (`registered: false` in the result says so) — that only\n affects browsing in Google's own interface, not this API: every result comes back as\n urls/media_ids in the generation response either way.\n\n Returns {\"project_id\": ..., \"account\": ..., \"registered\": true|false}.\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Name"
}
},
"required": [
"account"
],
"title": "create_projectArguments",
"type": "object"
},
"name": "create_project"
},
{
"description": "Rewrite a video from a plain description: \"make the sky stormy\", \"take the\n passer-by out of the shot\", \"warmer light\", \"put the product from the image on the\n table\".\n\n Source — ONE of:\n media_id: id from a previous generate_video* result (OUR OWN generation). Job is\n pinned to the account that produced it.\n video_base64: base64-encoded YOUR OWN clip (mp4/mov/avi/3gp, up to 60s/1GB).\n Worker uploads it via Flow's Scotty resumable upload (reversed via\n Flow Web Ingredients, 2026-10-14) onto a healthy account, then runs\n the edit on that account. The upload itself costs no credits.\n\n start_sec / end_sec: edit only this piece of the source (both or neither, at most\n 10 s). The result is ONLY that piece — not the full clip with the piece replaced.\n reference_images_base64: up to 5 raw base64 images (no data: prefix); the object in\n the image is put into the clip — say in the prompt what to do with it.\n\n 20 credits per edit (abra_edit_360p: 10). Not a mask tool — describe the change and\n where it goes (\"on the left\", \"in the sky\"); mask/style image types are not honored.\n\n Prompt template that lands best — fill each part, one or two sentences each:\n Goal: what changes (\"Replace the man on the left with the character from image 1\").\n Source: \"The source video drives camera, motion, timing and lip movement.\"\n Reference: what to take from each image (\"use only the character's look; ignore\n the image background\").\n Scene: describe the room/background in words (helps the model keep it intact).\n Keep: \"Everything else stays exactly as in the source.\"\n Timing: \"The new character inherits the exact movement and position of the one\n it replaces, from the first frame to the last.\"\n Draft on abra_edit_360p (10 credits) to check the edit lands, then run abra_edit; the\n seed does not carry an edit take across resolutions, so the final can differ in details.\n Only edit footage the user owns or is licensed to use; do not put real people's\n likeness into clips without their consent.\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "VIDEO_ASPECT_RATIO_LANDSCAPE",
"enum": [
"VIDEO_ASPECT_RATIO_LANDSCAPE",
"VIDEO_ASPECT_RATIO_PORTRAIT"
],
"title": "Aspect",
"type": "string"
},
"end_sec": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "End Sec"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"media_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Media Id"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"reference_images_base64": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Reference Images Base64"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
},
"start_sec": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Start Sec"
},
"video_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Video Base64"
},
"video_model_key": {
"default": "abra_edit",
"enum": [
"abra_edit",
"abra_edit_360p"
],
"title": "Video Model Key",
"type": "string"
}
},
"required": [
"prompt"
],
"title": "edit_videoArguments",
"type": "object"
},
"name": "edit_video"
},
{
"description": "Continue a video this service already generated — Flow writes what happens next.\n\n media_id: the id from a previous generate_video* result (the bare id, not the\n /v1/media/... path). Only videos made through this service can be extended: the id\n belongs to a specific Google account's project, so the job is pinned to that account\n instead of rotating. An id we never produced comes back as a clear error, not a\n mystery failure.\n\n Use this for shots that need to run longer than one generation, or to keep a scene\n going without re-describing it: the continuation inherits the source clip's world,\n which a fresh text-to-video call cannot do.\n\n Default model veo_3_1_extension_lite: 10 credits, adds 8 seconds.\n\n project_id: which project the continuation lands in. The job is pinned to the source\n clip's account regardless, so pass the project the source was generated in (or omit it).\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "VIDEO_ASPECT_RATIO_LANDSCAPE",
"enum": [
"VIDEO_ASPECT_RATIO_LANDSCAPE",
"VIDEO_ASPECT_RATIO_PORTRAIT"
],
"title": "Aspect",
"type": "string"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"media_id": {
"title": "Media Id",
"type": "string"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
},
"video_model_key": {
"default": "veo_3_1_extension_lite",
"enum": [
"veo_3_1_extension_lite",
"veo_3_1_extend_fast_landscape",
"veo_3_1_extend_landscape"
],
"title": "Video Model Key",
"type": "string"
}
},
"required": [
"prompt",
"media_id"
],
"title": "extend_videoArguments",
"type": "object"
},
"name": "extend_video"
},
{
"description": "Download a generated media file (video, frame) and return its bytes,\n base64-encoded, so the file can be saved or shown even though the media endpoint\n isn't publicly reachable with your MCP key.\n\n THIS IS THE EXPENSIVE PATH — prefer `download_url` from the job result. Bytes returned\n here travel as TEXT, and text is where context dies: a 480 KB audio stem is ~640 thousand\n base64 characters, roughly 160 000 tokens, in ONE tool result. The same file behind\n `download_url` costs about twenty. An inline image preview is cheap by comparison (it\n travels as an image, ~450 tokens) — it is base64 in a text field that hurts.\n\n Because of that this tool REFUSES big files by default and hands back a download link\n instead. Pass force_bytes=True only when you genuinely need the bytes inside the\n conversation and know what it costs.\n\n path: the `download_path` / `first_frame_path` / `last_frame_path` value from a job\n result (e.g. \"/v1/media/<id>.mp4\"), or just the bare filename.\n max_kb: size ceiling for an in-band answer (default 64 KB ≈ 21 000 tokens).\n\n Returns {\"filename\", \"media_type\", \"base64\"}. The download is scoped to your own\n account group — you can only fetch media your key produced. Note videos can be\n several MB, so the base64 payload is large; fetch only when you actually need the\n bytes (to save/display), not to check status (use check_job for that).\n\n On storage: the server keeps a local cache of results and, when it runs short of disk,\n drops the OLDEST files first, whether fetched or not. A dropped file is fetched back\n from the Google account that made it on the next request; if that takes a while you get\n `retry_after_s` — call again then. If that account is disconnected, the error names it\n and gives `reconnect_url`: tell the user to reconnect it, then retry. Only when the\n original cannot be fetched back does it answer 410 with the date. Saving the bytes\n locally is still the way to keep something for good.",
"inputSchema": {
"properties": {
"force_bytes": {
"default": false,
"title": "Force Bytes",
"type": "boolean"
},
"max_kb": {
"default": 64,
"title": "Max Kb",
"type": "integer"
},
"path": {
"title": "Path",
"type": "string"
}
},
"required": [
"path"
],
"title": "fetch_mediaArguments",
"type": "object"
},
"name": "fetch_media"
},
{
"description": "The account-pool control panel: for EVERY Google account, the real credit\n balance, subscription tier, project count, and health status, plus totals — one\n call, formatted for reading. Use this to answer \"how many accounts, how many\n credits on each and in total, what projects\" — the operator's dashboard.\n\n Returns a `summary` string (human-readable table) plus structured `accounts` and\n `totals`. Credit numbers are live (Flow's /v1/credits). Credit REFRESH date is not\n exposed by Flow's API, so it's shown as an estimate note, not a hard date.\n ",
"inputSchema": {
"properties": {},
"title": "flow_dashboardArguments",
"type": "object"
},
"name": "flow_dashboard"
},
{
"description": "Check whether the Flow generation backend is reachable and see current queue\n depth (queued + warming + running jobs), plus disk state (`disk`: free_gb, below_target,\n below_floor, refusing_jobs); status is \"degraded\" when disk is below the floor. Note: the Android emulator is now OFF —\n generation runs on a pure-HTTP token path, so there's no warm-up delay anymore.",
"inputSchema": {
"properties": {},
"title": "flow_healthArguments",
"type": "object"
},
"name": "flow_health"
},
{
"description": "What this key still needs before it can do everything — READ-ONLY, spends nothing.\n\n Call this BEFORE the first generation of a session, whenever a call is refused, and\n whenever the user asks why something does not work. It answers in one shot: is a\n Google account connected, how much of the free trial is left, is the key linked to a\n GitHub identity, how much of this week's free limit is left (`weekly`).\n\n The important field is `next_step`: it is the single most blocking thing right now,\n with ready-made wording (`text` in Russian, `text_en` in English) and a `url` to open.\n When it is null, nothing is missing.\n\n DO NOT keep this to yourself. If `next_step` is set, say it to the user in their own\n language and give them the URL — a step like signing in happens in THEIR browser\n and cannot be done by you. When `next_step` is about connecting a Google account it\n also carries `command` (personal, per OS): run it for the user in their terminal, it\n submits the token by itself — no copying or pasting. add_account_token is only the\n fallback. To add an **Antigravity** Google account from inside this chat, use\n `add_antigravity_start` -> open the URL -> paste the `code` back with\n `add_antigravity_submit(code, state)`. `support` is the operator's Telegram, the service's only\n human channel; there is no email on file for a self-registered key, so nobody will\n reach out to the user first.",
"inputSchema": {
"properties": {},
"title": "flow_statusArguments",
"type": "object"
},
"name": "flow_status"
},
{
"description": "Generate a single image showing the character's FACE with several different\n expressions in one row, labeled — an \"expression sheet\". Same job type and same\n history as generate_character_turnaround — see its docstring for the full story:\n the 2026-07-11 finding (plain Android-bearer image path is inconsistent for\n multi-view prompts, the real web composer was reliably consistent) is why this\n tool exists, but as of 2026-07-26 it no longer drives that composer — pure HTTP\n with image_inputs=[portrait_media_id] instead (no browser). Multi-view consistency\n on THIS new path has not been re-verified live yet; the recommendation to keep a\n detailed physical description saved on the entity carries over from the old\n finding but hasn't been separately re-tested against the new mechanism either.\n\n account: Google account that owns this entity_id's project.\n expressions: list of expression labels, e.g. [\"нейтральное выражение\",\n \"удивление\", \"лёгкая улыбка\", \"смех\"] (default if omitted). Keep to 3-5 for a\n readable single-row layout.\n character_slot_index: which slot to write into (0 = portrait, default — this\n overwrites the existing portrait image with the expression sheet, matching how\n this was used when reproducing the feature; 1 = body slot also works).\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"character_slot_index": {
"default": 0,
"title": "Character Slot Index",
"type": "integer"
},
"entity_id": {
"title": "Entity Id",
"type": "string"
},
"expressions": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Expressions"
}
},
"required": [
"entity_id",
"account"
],
"title": "generate_character_expression_sheetArguments",
"type": "object"
},
"name": "generate_character_expression_sheet"
},
{
"description": "Generate a portrait or body image for an existing Flow character.\n\n entity_id: the character's entityId — from create_character or\n create_character_from_photo, or create_character_from_description's own result\n (which already calls this for slot 0 — no need to call it again for that slot).\n character_slot_index: 0 for portrait, 1 for body. Flow keeps the two slots\n visually consistent server-side once they share an entityId — no reference\n image needed for the body shot.\n\n ONE-SHOT PER SLOT, confirmed live 2026-07-25: each slot can be written exactly\n once — a second generate_character_image call into an ALREADY-FILLED slot fails\n (HTTP 500), it does not overwrite. Also confirmed: the FIRST write into a slot\n 500s on a card with no personality_notes saved yet — call update_character with\n personality_notes before the first generate_character_image on a fresh entity_id.\n If you're using create_character_from_description, both of these are already\n handled for slot 0; this caveat mainly matters if you're driving slot 1 (body) or\n entity_id yourself.\n\n THIS TOOL DOES NOT PLACE A CHARACTER INTO A NEW SCENE — it only ever (re)writes\n the character's own portrait/body slot, once. For \"generate a picture of this\n character doing X\", use generate_with_face(character=..., prompt=...) instead,\n which conditions on the reference image, not entity_id.\n\n CAVEAT confirmed live 2026-07-11: for a character seeded from a REAL PHOTO\n (create_character_from_photo), this text-prompt generation is NOT reliable for\n identity — it conditions on a text description, not the real photo's pixels, and\n was confirmed to drift to an unrelated-looking person even with a detailed\n physical description saved on the entity. Fine for invented/stylized characters.\n If the goal is \"content that looks like a real person,\" use\n generate_video_with_reference (r2v) instead — see its docstring.\n\n Only works for the account whose project actually owns this entity_id —\n characters are per-account, same as projects. Pass that account as `account`\n (optional for a character saved in list_characters(): it is looked up).\n ",
"inputSchema": {
"properties": {
"account": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account"
},
"aspect": {
"default": "IMAGE_ASPECT_RATIO_LANDSCAPE",
"enum": [
"IMAGE_ASPECT_RATIO_LANDSCAPE",
"IMAGE_ASPECT_RATIO_PORTRAIT",
"IMAGE_ASPECT_RATIO_SQUARE",
"IMAGE_ASPECT_RATIO_LANDSCAPE_FOUR_THREE",
"IMAGE_ASPECT_RATIO_PORTRAIT_THREE_FOUR"
],
"title": "Aspect",
"type": "string"
},
"character_slot_index": {
"title": "Character Slot Index",
"type": "integer"
},
"entity_id": {
"title": "Entity Id",
"type": "string"
},
"model": {
"default": "BELUGA",
"enum": [
"BELUGA",
"GEM_PIX_2",
"HARBOR_SEAL"
],
"title": "Model",
"type": "string"
},
"prompt": {
"title": "Prompt",
"type": "string"
}
},
"required": [
"prompt",
"entity_id",
"character_slot_index"
],
"title": "generate_character_imageArguments",
"type": "object"
},
"name": "generate_character_image"
},
{
"description": "Generate a single image showing the character's FULL BODY from 3 angles\n (front/side/back) in one row, labeled — a \"turnaround sheet\". Pure HTTP as of\n 2026-07-26 — no browser involved (see below for what changed and what that does\n and does NOT prove).\n\n History, so the mechanism change doesn't erase the reason this tool exists:\n confirmed live 2026-07-11 that the plain Android-bearer generate_character_image\n path produces an INCONSISTENT result for this exact kind of multi-view prompt,\n even with a detailed physical description already saved on the entity — a real\n web composer (Chrome/CDP) driving Flow's own translation/agent layer was reliably\n consistent for the same prompt. That is why this tool exists as a separate path\n from plain image generation, and that finding still stands.\n\n What changed 2026-07-26: this no longer drives that browser composer. The\n underlying job type (generate_character_scene) moved to a THIRD mechanism, not\n either of the two compared above — plain HTTP with image_inputs=[the character's\n own portrait_media_id from the registry], the same face-preserving mechanism\n generate_with_face uses. This was done to remove the last browser dependency\n (worker.py's BROWSER_JOB_TYPES is now empty), not because this new path's\n multi-view consistency was re-verified — it has NOT been checked live yet whether\n image_inputs alone holds up as well as the old composer did for a 3-angle sheet.\n Treat multi-view reliability here as unverified-but-plausible until confirmed by\n eye against real output, not as re-proven.\n\n Still recommend a detailed physical description saved first (create_character_from_photo's\n physical_description param, or update_character's personality_notes) — that\n recommendation carries over from the 2026-07-11 finding above; whether it still\n matters mechanically on this new image_inputs path (vs. the composer's own\n entityContext-driven translation layer, which this path does not use) has not been\n separately tested, so keeping it costs nothing and there's no evidence yet that\n it's safe to drop.\n\n account: Google account that owns this entity_id's project.\n character_slot_index: which slot to write the result into (0 = portrait, 1 =\n body — default 1).\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"character_slot_index": {
"default": 1,
"title": "Character Slot Index",
"type": "integer"
},
"entity_id": {
"title": "Entity Id",
"type": "string"
},
"outfit_description": {
"default": "обычная повседневная одежда",
"title": "Outfit Description",
"type": "string"
}
},
"required": [
"entity_id",
"account"
],
"title": "generate_character_turnaroundArguments",
"type": "object"
},
"name": "generate_character_turnaround"
},
{
"description": "Generate an image from a text prompt via Google Flow.\n\n model — pass ONE of these exact ids (from GET v1/flow/models, verified 2026-07-25):\n BELUGA = \"Nano Banana 2\" — the DEFAULT, ~30s (legacy id NARWHAL is accepted as an alias)\n GEM_PIX_2 = \"Nano Banana Pro\" — highest quality, ~40s, has a separate DAILY\n per-account quota (429 rotates accounts)\n HARBOR_SEAL = \"Nano Banana 2 Lite\" — ~40s\n Anything else is rejected with HTTP 400 — there is no silent fallback, so a wrong id\n wastes a round trip, not credits. Do NOT guess names like \"nano_banana_pro\": that is\n the model FAMILY key from the config, not the id the generate call takes.\n\n image_inputs: mediaIds from prior generations, edit-in-place (keeps them pixel-exact).\n control_images: up to 10 base64 image bytes (no data: prefix) of a locally rendered layout/control\n image — uploaded first, then prepended to image_inputs so the generator follows an exact\n spatial layout instead of prose. For whole-scene layout control prefer generate_scene.\n\n seed: 1..900000, fixes the generation so the same request returns the same image. Omit\n for a random seed. Needed to compare two prompts, two models or two control images\n honestly — without it every run is a fresh roll and the difference you are measuring\n drowns in noise. Measured 2026-08-09: with an UNCHANGED control image a fixed seed\n reproduces the frame to ~0.1%; once the control image changes, the seed no longer keeps\n the character — for that use image_inputs with a reference frame's mediaId.\n\n project_id: put the result into a project made with create_project instead of the\n account's default one — one project per end client keeps their work separate. Omit it\n and nothing changes from before.\n\n include_preview: ON by default since 2026-08-21 — a generated image nobody can see\n in the chat is half a result. Pass False to get the plain dict back and nothing else\n (worth doing in a loop of many generations, where the previews would fill the\n context). When on and the job finished with at least one url, the call returns the\n usual result dict, a short card naming the parameters actually used, and a small\n compressed JPEG (long side capped at 768px, ~100-160KB once base64-encoded) as an\n inline image content block, so a human can actually see the result without leaving\n the chat. This is deliberately a shrunk preview, never the original — the real Flow\n image is ~0.5MB (~740KB in base64), enough to burn a whole tool call's worth of a\n client's context budget on its own. The preview is for EYES ONLY: urls/media_ids\n stay the authoritative result in both modes, and every downstream call (upscale_image,\n image_inputs edit-in-place, ...) must keep using media_ids, never the preview bytes.\n If the preview download/shrink fails for any reason, this silently falls back to the\n plain (no-preview) result instead of failing the whole call.\n\n SAVE THE RESULT INTO THE USER'S PROJECT. A finished job also carries `download_urls`\n (plain URLs, no auth header needed) and `save_as` (the filenames to use). Unless the\n user said otherwise, write them to ./media/<save_as> in their working directory and\n tell them the path. The server keeps its own copy, but only the file in their project\n is theirs: our copy can be reclaimed when the disk fills, and the URLs expire within\n the hour. Downloading costs no credits and no quota.\n\n Returns {\"urls\": [...], \"media_ids\": [...]} when done, or a job_id to poll\n with check_job if it's not ready within ~60s (rare for images unless the\n device is cold). With the default include_preview=True and a finished result,\n returns [that dict, <card>, <inline image>] instead — see include_preview above.\n idempotency_key: optional, any string unique to this logical request (e.g. a uuid).\n Repeating a call with the same key within 24h returns the SAME job instead of a\n new one — use it when you may retry after a timeout or a busy error.\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "IMAGE_ASPECT_RATIO_LANDSCAPE",
"enum": [
"IMAGE_ASPECT_RATIO_LANDSCAPE",
"IMAGE_ASPECT_RATIO_PORTRAIT",
"IMAGE_ASPECT_RATIO_SQUARE",
"IMAGE_ASPECT_RATIO_LANDSCAPE_FOUR_THREE",
"IMAGE_ASPECT_RATIO_PORTRAIT_THREE_FOUR"
],
"title": "Aspect",
"type": "string"
},
"control_images": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Control Images"
},
"idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Idempotency Key"
},
"image_inputs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Image Inputs"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"model": {
"default": "BELUGA",
"enum": [
"BELUGA",
"GEM_PIX_2",
"HARBOR_SEAL"
],
"title": "Model",
"type": "string"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
}
},
"required": [
"prompt"
],
"title": "generate_imageArguments",
"type": "object"
},
"name": "generate_image"
},
{
"description": "Build a location precisely from a scene-layout/v2 map and generate its plate.\n\n This is the \"exact location building\" path: instead of describing the room in prose\n (which the model reinterprets — furniture drifts, depths change between shots), it\n renders a control image from the map's boxes (each object a colored block at its true\n position/size/depth, plus a 1-meter floor grid in true perspective), then asks the\n generator to REPLACE each block with its real object in the same camera — so the plate\n follows the geometry pixel-wise. Same room from another camera_id is the same space.\n\n scene_layout: a scene-layout/v2 dict — {format, units, room{w,d,h}, objects{...boxes},\n cameras{<id>:{pos,look_at,fov_deg,framing?}}, ...}. The camera must carry fov_deg.\n camera_id: which camera in scene_layout.cameras to render from.\n aspect: PORTRAIT (9:16), LANDSCAPE (16:9), SQUARE, PORTRAIT_THREE_FOUR (3:4) or\n LANDSCAPE_FOUR_THREE (4:3). 9:16 and 16:9 from one camera share the vertical FOV, so\n depths are identical across aspects.\n style / extra: prepended / appended prose (art style, mood) — geometry comes from the map.\n\n A box may carry `rot: [rx, ry, rz]` (degrees around the world X/Y/Z axes) and `pivot:\n [x, y, z]`, applied as p' = Rx·Ry·Rz·(p − pivot) + pivot, pivot defaulting to the box\n centre. That is how a POSE is expressed — a raised arm is a box rotated about the\n shoulder. Measured live 2026-08-09: moving a hand by 2–20 cm is ignored by the\n generator, rotating the arm by 15–60° comes through. Build motion out of angles.\n\n seed / image_inputs: same meaning as in generate_image. For a SEQUENCE of frames of one\n character, generate a reference frame first, then pass its mediaId as image_inputs on\n every following frame — that is what keeps the face, clothes and colours identical.\n A fixed seed alone does not: it only repeats an unchanged control image.\n\n depth: render the guide as a plain greyscale depth map instead of the colour hybrid\n (for an external depth-ControlNet). calibration: add frame markers, a back-wall grid\n and a 2 m ruler with 10 cm ticks — measured to cut the framing drift roughly fourfold.\n background: \"dark\" (default, unchanged) or \"light\". Use \"light\" when the plate must be\n on a white background: the generator sometimes copies the guide's own palette into the\n result, and a light guide makes that leak land as white rather than as a dark grid.\n\n control_png: return the layout guide itself, base64-encoded. OFF by default because it is\n hundreds of thousands of characters of TEXT — one guide can cost more context than the\n whole conversation around it. `control_png_kb` always reports its size.\n\n Returns {\"urls\", \"media_ids\", \"legend\", \"control_png_kb\"} — legend maps block colors to\n objects. Add control_png=True to also get the guide itself for inspection/acceptance.\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "LANDSCAPE",
"title": "Aspect",
"type": "string"
},
"background": {
"default": "dark",
"title": "Background",
"type": "string"
},
"calibration": {
"default": false,
"title": "Calibration",
"type": "boolean"
},
"camera_id": {
"title": "Camera Id",
"type": "string"
},
"control_png": {
"default": false,
"title": "Control Png",
"type": "boolean"
},
"depth": {
"default": false,
"title": "Depth",
"type": "boolean"
},
"extra": {
"default": "",
"title": "Extra",
"type": "string"
},
"image_inputs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Image Inputs"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"scene_layout": {
"additionalProperties": true,
"title": "Scene Layout",
"type": "object"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
},
"style": {
"default": "In the style of Pixar-like 3D cartoon animation, clean rounded shapes, soft even lighting from the left, muted natural palette.",
"title": "Style",
"type": "string"
}
},
"required": [
"scene_layout",
"camera_id"
],
"title": "generate_sceneArguments",
"type": "object"
},
"name": "generate_scene"
},
{
"description": "Generate a video from a text prompt via Google Flow (Veo models).\n\n video_model_key options: abra_t2v_4s (default, 7 credits), veo_3_1_t2v_lite\n (10cr, visibly cleaner), veo_3_1_t2v (100cr, \"Quality\" tier), veo_3_1_t2v_fast (20cr).\n\n project_id: put the clip into a project made with create_project instead of the\n account's default one — one project per end client keeps their work separate.\n\n Video generation routinely takes 1-3+ minutes, so this almost always returns\n a job_id rather than a finished result — call check_job with it, waiting a\n few seconds between checks, until status is 'done' or 'failed'.\n beats: how many DISTINCT action phases the prompt describes — \"ears flick back\",\n \"tail lashes\", \"strikes the ball\", \"ball flies off\" are four. Give it and the server\n picks the clip length for you (about two phases per second) and says in the reply what\n it picked and why. Measured 31.08.2026: the model STRETCHES whatever you describe over\n whatever length you ask for, so one phase in four seconds comes out as slow motion, and\n the same text at six seconds instead of four loses 15% of its movement. Adjectives are\n not phases: \"springy cartoon motion\" adds nothing. Leave beats out and the length you\n passed is used unchanged.\n\n seed (all video tools): the result always reports the seed it used. Same seed + same\n prompt + same inputs = the same clip, so a good take can be re-made. A fixed seed does\n NOT keep the composition when the prompt changes — use edit_video for that.\n idempotency_key: optional, any string unique to this logical request (e.g. a uuid).\n Repeating a call with the same key within 24h returns the SAME job instead of a\n new one — use it when you may retry after a timeout or a busy error.\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "VIDEO_ASPECT_RATIO_LANDSCAPE",
"enum": [
"VIDEO_ASPECT_RATIO_LANDSCAPE",
"VIDEO_ASPECT_RATIO_PORTRAIT"
],
"title": "Aspect",
"type": "string"
},
"beats": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Beats"
},
"idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Idempotency Key"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
},
"video_model_key": {
"default": "abra_t2v_4s",
"enum": [
"abra_t2v_4s",
"abra_t2v_6s",
"abra_t2v_8s",
"abra_t2v_10s",
"abra_t2v_4s_360p",
"abra_t2v_6s_360p",
"abra_t2v_8s_360p",
"abra_t2v_10s_360p",
"veo_3_1_t2v_lite",
"veo_3_1_t2v_fast",
"veo_3_1_t2v"
],
"title": "Video Model Key",
"type": "string"
},
"voice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice"
},
"voice_style": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice Style"
},
"voice_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice Text"
}
},
"required": [
"prompt"
],
"title": "generate_videoArguments",
"type": "object"
},
"name": "generate_video"
},
{
"description": "Generate the transition between TWO given frames: the video starts at the first\n image and ends at the second one, Flow invents everything in between.\n\n This is Flow's \"Кадры\" with both slots filled — a different mechanism from\n generate_video_from_image, which only pins the FIRST frame and lets the ending drift.\n Use this when the ending matters: a logo that must resolve exactly, a character that\n must land in a specific pose, two stills from a storyboard that need connecting.\n\n Both images are raw base64 bytes, no data: URI prefix. The default model\n (veo_3_1_interpolation_lite, 10 credits, 8 seconds) is the cheap one — transitions\n are something you retry a few times, and defaulting to the 100-credit key would make\n every experiment expensive.\n\n beats: how many DISTINCT action phases the prompt describes — \"ears flick back\",\n \"tail lashes\", \"strikes the ball\", \"ball flies off\" are four. Give it and the server\n picks the clip length for you (about two phases per second) and says in the reply what\n it picked and why. Measured 31.08.2026: the model STRETCHES whatever you describe over\n whatever length you ask for, so one phase in four seconds comes out as slow motion, and\n the same text at six seconds instead of four loses 15% of its movement. Adjectives are\n not phases: \"springy cartoon motion\" adds nothing. Leave beats out and the length you\n passed is used unchanged.\n\n project_id: put the clip into a project made with create_project instead of the\n account's default one.\n beats: how many DISTINCT action phases the prompt describes. The server then picks\n the clip length itself (about two phases per second) and says so in the reply. For a\n first+last-frame transition keep it low: the two frames already fix the endpoints, and\n asking for more seconds than the action needs only stretches it — measured 31.08.2026,\n the same text at six seconds instead of four lost 15% of its movement.\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "VIDEO_ASPECT_RATIO_LANDSCAPE",
"enum": [
"VIDEO_ASPECT_RATIO_LANDSCAPE",
"VIDEO_ASPECT_RATIO_PORTRAIT"
],
"title": "Aspect",
"type": "string"
},
"beats": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Beats"
},
"end_image_base64": {
"title": "End Image Base64",
"type": "string"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
},
"start_image_base64": {
"title": "Start Image Base64",
"type": "string"
},
"video_model_key": {
"default": "veo_3_1_interpolation_lite",
"enum": [
"omni_flash_i2v_4s_first_last",
"omni_flash_i2v_6s_first_last",
"omni_flash_i2v_8s_first_last",
"omni_flash_i2v_10s_first_last",
"omni_flash_i2v_4s_first_last_360p",
"omni_flash_i2v_6s_first_last_360p",
"omni_flash_i2v_8s_first_last_360p",
"omni_flash_i2v_10s_first_last_360p",
"veo_3_1_interpolation_lite",
"veo_3_1_i2v_s_fast_fl",
"veo_3_1_i2v_s_fl"
],
"title": "Video Model Key",
"type": "string"
}
},
"required": [
"prompt",
"start_image_base64",
"end_image_base64"
],
"title": "generate_video_between_framesArguments",
"type": "object"
},
"name": "generate_video_between_frames"
},
{
"description": "Generate a video that starts from a given image (i2v — image-to-video).\n\n Pass exactly one start: start_image_base64 (raw base64 image bytes, no data: URI\n prefix) or start_media_id (media_id of one of YOUR finished videos — the clip then\n starts from that video's `frame`, \"last\" by default, taken server-side).\n Mutually exclusive with reference-image (r2v) generation.\n\n Chain clips: every finished video carries `last_frame_path` and its media_id, so\n clip 2 = generate_video_from_image(prompt=\"...\", start_media_id=<clip 1 media_id>),\n clip 3 the same from clip 2's media_id. The chained job runs on the account that\n made the source clip.\n\n For \"make content that looks like this real photo of a person\" specifically,\n prefer generate_video_with_reference (r2v) over this — see its docstring for why.\n i2v is better suited to \"continue visually from this exact frame\" (e.g. chaining\n clips), not identity preservation across a whole new scene.\n\n beats: how many DISTINCT action phases the prompt describes — \"ears flick back\",\n \"tail lashes\", \"strikes the ball\", \"ball flies off\" are four. Give it and the server\n picks the clip length for you (about two phases per second) and says in the reply what\n it picked and why. Measured 31.08.2026: the model STRETCHES whatever you describe over\n whatever length you ask for, so one phase in four seconds comes out as slow motion, and\n the same text at six seconds instead of four loses 15% of its movement. Adjectives are\n not phases. Leave beats out and the length you passed is used unchanged.\n\n project_id: put the clip into a project made with create_project instead of the\n account's default one.\n\n voice / voice_style / voice_text: optional narration — same semantics as\n generate_video_with_reference. Only works with speech-capable Veo 3.1 i2v models.\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "VIDEO_ASPECT_RATIO_LANDSCAPE",
"enum": [
"VIDEO_ASPECT_RATIO_LANDSCAPE",
"VIDEO_ASPECT_RATIO_PORTRAIT"
],
"title": "Aspect",
"type": "string"
},
"beats": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Beats"
},
"frame": {
"default": "last",
"enum": [
"first",
"last"
],
"title": "Frame",
"type": "string"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
},
"start_image_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start Image Base64"
},
"start_media_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Start Media Id"
},
"video_model_key": {
"default": "abra_i2v_4s",
"enum": [
"abra_i2v_4s",
"abra_i2v_6s",
"abra_i2v_8s",
"abra_i2v_10s",
"abra_i2v_4s_360p",
"abra_i2v_6s_360p",
"abra_i2v_8s_360p",
"abra_i2v_10s_360p",
"veo_3_1_i2v_lite",
"veo_3_1_i2v_s_fast",
"veo_3_1_i2v_s"
],
"title": "Video Model Key",
"type": "string"
},
"voice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice"
},
"voice_style": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice Style"
},
"voice_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice Text"
}
},
"required": [
"prompt"
],
"title": "generate_video_from_imageArguments",
"type": "object"
},
"name": "generate_video_from_image"
},
{
"description": "Generate a video using up to 7 reference images (r2v — e.g. a consistent\n character/subject across the video). reference_images_base64: raw base64-encoded\n image bytes (no data: URI prefix), up to 7 with Omni Flash keys (abra_r2v_*, the\n default), up to 3 with Veo r2v keys (veo_3_1_r2v_*). Mutually exclusive with start-image\n (i2v) generation.\n\n THIS IS THE RECOMMENDED WAY to get content that actually looks like a real person\n from a real photo — confirmed live 2026-07-11: r2v conditions generation on the\n reference photo's actual pixels and reliably preserves the real face, unlike the\n character system's `generate_character_image`/`generate_character_turnaround`\n (those condition on a TEXT description + a loosely-attached reference and were\n confirmed to drift to an unrelated-looking person). For a still IMAGE rather than\n video, use this and read `first_frame_path` (or `last_frame_path`) off the result once done (via\n check_job) — same-day testing found no reliable image-only equivalent: a plain\n generate_image call with image_inputs pointed at an external photo was confirmed\n to silently ignore the reference entirely.\n\n project_id: put the clip into a project made with create_project instead of the\n account's default one.\n\n entity_id: optional — the entityId of a character you created and voiced with\n set_character_voice. Only meaningful together with video_model_key=\"veo_3_1_r2v_lite\"\n (the one r2v model that generates speech natively); for abra_r2v_* models passing\n entity_id has no effect (and was known to 500 historically). When set with the right\n model, Flow attaches the character's audioReferences and lip-syncs the generated\n speech in the assigned TTS voice. The job runs on the character's own Google account\n (that's where the entity and its audioReferences live) — so an account different\n from your other calls is normal here, no action needed.\n\n voice / voice_style / voice_text: optional one-shot narration without creating a\n character. Pass a voice name from list_voices() (e.g. \"Algieba\") and either a\n voice_text or embed the spoken line in the prompt between quotes. Mutually\n exclusive with entity_id — a character already carries its own voice. Only works\n with speech-capable r2v models (veo_3_1_r2v_lite).\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "VIDEO_ASPECT_RATIO_LANDSCAPE",
"enum": [
"VIDEO_ASPECT_RATIO_LANDSCAPE",
"VIDEO_ASPECT_RATIO_PORTRAIT"
],
"title": "Aspect",
"type": "string"
},
"entity_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Entity Id"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"prompt": {
"title": "Prompt",
"type": "string"
},
"reference_images_base64": {
"items": {
"type": "string"
},
"title": "Reference Images Base64",
"type": "array"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
},
"video_model_key": {
"default": "abra_r2v_4s",
"enum": [
"abra_r2v_4s",
"abra_r2v_6s",
"abra_r2v_8s",
"abra_r2v_10s",
"abra_r2v_4s_360p",
"abra_r2v_6s_360p",
"abra_r2v_8s_360p",
"abra_r2v_10s_360p",
"veo_3_1_r2v_lite"
],
"title": "Video Model Key",
"type": "string"
},
"voice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice"
},
"voice_style": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice Style"
},
"voice_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Voice Text"
}
},
"required": [
"prompt",
"reference_images_base64"
],
"title": "generate_video_with_referenceArguments",
"type": "object"
},
"name": "generate_video_with_reference"
},
{
"description": "Speak `text` aloud with a Gemini TTS voice and return a WAV (24 kHz, mono, 16-bit).\n\n Takes ~15-25 seconds for up to 300 characters. Costs no image/video quota. Russian,\n English and most other languages work; the voice name only sets the timbre.\n\n text: what to say, up to 5000 characters. Google's TTS itself takes at most 500\n characters (about 30 seconds of speech) per request, so text longer than 300\n characters is split at sentence boundaries, spoken piece by piece and joined into\n ONE WAV — about 30 seconds of waiting per 1000 characters; the result then also has\n `chunks` and `media_ids`. A lone word or a fragment that reads like an instruction\n (\"in a modern style.\") may still be refused: give it a full sentence.\n voice: one of list_voices() (default \"Algieba\").\n style: optional delivery hint, e.g. \"calm, slow\" or \"cheerful\". Empty = neutral.\n project_id: optional, a project from create_project; omit for the account's default.\n include_preview: also return `wav_preview_b64`, the FIRST 8 KB of the file as base64.\n Off by default: it is only the first fraction of a second and costs context. To get the\n whole file open `download_url`, or call fetch_media(path=download_path, force_bytes=True).\n\n Returns {audio_url, download_url, download_path, media_id, duration_sec_estimate,\n size_bytes, voice} — `audio_url` is Google's signed link and EXPIRES, `download_url`\n is ours. While still rendering, returns a job_id: call check_job.\n idempotency_key: optional, any string unique to this logical request (e.g. a uuid).\n Repeating a call with the same key within 24h returns the SAME job instead of a\n new one — use it when you may retry after a timeout or a busy error.\n ",
"inputSchema": {
"properties": {
"idempotency_key": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Idempotency Key"
},
"include_preview": {
"default": false,
"title": "Include Preview",
"type": "boolean"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"style": {
"default": "",
"title": "Style",
"type": "string"
},
"text": {
"title": "Text",
"type": "string"
},
"voice": {
"default": "Algieba",
"title": "Voice",
"type": "string"
}
},
"required": [
"text"
],
"title": "generate_voiceArguments",
"type": "object"
},
"name": "generate_voice"
},
{
"description": "Generate a NEW image of the SAME PERSON/character as an existing photo or\n portrait — dress them differently, move them somewhere else, make an avatar. This\n is the tool for \"here is my photo, now put me in a suit / in a park\", and also\n the ONLY tool for \"generate another picture of <character I already made>\".\n\n Pass exactly ONE of:\n character: the name you gave a character via create_character_from_description\n or create_character_from_photo(..., name=...). Looked up in your own list —\n see list_characters(). This is the normal way once a character has a name.\n photo_media_id: a mediaId directly (create_character_from_photo's\n `portrait_media_id`, or any earlier generate_image media_id) — for a one-off\n face you haven't registered as a named character.\n prompt: describe the NEW scene/outfit and say it is the same person, e.g.\n \"the same man, now in a navy suit in a bright office\".\n\n Why this and not entity_id/character_slot_index: a character's Flow CARD is not\n what carries resemblance into a NEW scene — the reference image itself does\n (verified live, repeatedly). Combining entity_id with an image reference in the\n same call also fails outright (HTTP 500). So this always generates from the\n reference image alone, never from entity_id — that is deliberate, not a\n workaround to fix later.\n\n project_id: put the result into a project made with create_project instead of the\n account's default one. photo_media_id itself stays account-bound, as always.\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "IMAGE_ASPECT_RATIO_LANDSCAPE",
"enum": [
"IMAGE_ASPECT_RATIO_LANDSCAPE",
"IMAGE_ASPECT_RATIO_PORTRAIT",
"IMAGE_ASPECT_RATIO_SQUARE",
"IMAGE_ASPECT_RATIO_LANDSCAPE_FOUR_THREE",
"IMAGE_ASPECT_RATIO_PORTRAIT_THREE_FOUR"
],
"title": "Aspect",
"type": "string"
},
"character": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Character"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"model": {
"default": "BELUGA",
"enum": [
"BELUGA",
"GEM_PIX_2",
"HARBOR_SEAL"
],
"title": "Model",
"type": "string"
},
"photo_media_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Photo Media Id"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"prompt": {
"title": "Prompt",
"type": "string"
}
},
"required": [
"prompt"
],
"title": "generate_with_faceArguments",
"type": "object"
},
"name": "generate_with_face"
},
{
"description": "Какие LLM-модели доступны этому ключу прямо сейчас, и какая у ключа квота.\n\n Делает два параллельных запроса: GET /llm/models (OmniRoute — список моделей и\n подключённых Google-аккаунтов) и GET /v1/me (openFlow — plan + квоты). ETag от\n /v1/me держится OmniRoute'ом в кэше ~5 минут; force_refresh=True добавляет\n Cache-Control: no-cache, чтобы заставить обновить.\n\n Returns:\n {\n \"accounts\": [{\"email\": \"...\", \"credits\": int, \"models\": [...]}, ...],\n \"models\": [{\"id\": \"gemini-3-pro\", \"label\": \"...\"}, ...],\n \"quota\": {\"llm_rpm\": int, \"llm_tokens_per_day\": int, \"plan\": \"...\"}\n }\n\n Raises:\n MCPError: ключ невалиден.\n ",
"inputSchema": {
"properties": {
"force_refresh": {
"default": false,
"title": "Force Refresh",
"type": "boolean"
}
},
"title": "list_available_llmArguments",
"type": "object"
},
"name": "list_available_llm"
},
{
"description": "List the characters YOU created (create_character_from_description, or\n create_character_from_photo with name=...) and can now generate more images of\n via generate_with_face(character=<name>, prompt=...). Read-only, no Flow calls,\n no credits spent.\n\n Returns {\"characters\": [{\"name\", \"source\", \"description\", \"portrait_media_id\",\n \"entity_id\", \"project\", \"account\", \"created_at\"}, ...]}, oldest first.\n `source` is \"description\" (create_character_from_description) or \"photo\"\n (create_character_from_photo). `portrait_media_id` is what generate_with_face\n actually uses — a character with it set to null has no usable reference yet.\n ",
"inputSchema": {
"properties": {},
"title": "list_charactersArguments",
"type": "object"
},
"name": "list_characters"
},
{
"description": "Live from Google, no credits, use to answer «is this model still working?».\n\n Reads Google Flow's own current model catalog (modelConfig: usage keys, per-tier\n credit prices, durations) and the availability status of each model family, through\n one of the caller's connected accounts. READ-ONLY: nothing is generated and no credits\n are spent. Cached for ~1 minute server-side. Use list_models instead for the short\n curated list of ids this service's tools accept; use this one when you need Google's\n ground truth (a key that is missing here has been withdrawn upstream).\n\n Returns {models: <modelConfig>, statuses: <family availability or {\"error\": ...}>,\n account_used: <email>}. Needs at least one connected Google account.\n ",
"inputSchema": {
"properties": {},
"title": "list_live_modelsArguments",
"type": "object"
},
"name": "list_live_models"
},
{
"description": "List the Google accounts you connected for the LLM relay with their tier (Free/Pro/Ultra); refresh=True re-checks the tier with Google.\n The model is chosen per request (chat tools / relay `model`); pin an account with the `X-Account-Email` header.",
"inputSchema": {
"properties": {
"refresh": {
"default": false,
"title": "Refresh",
"type": "boolean"
}
},
"title": "list_llm_accountsArguments",
"type": "object"
},
"name": "list_llm_accounts"
},
{
"description": "List every valid model id this service accepts — READ-ONLY, spends no credits,\n calls nothing outside this service. Call this BEFORE generate_image/generate_video\n if you're unsure of an exact id: guessing (e.g. the family key \"nano_banana_pro\" or\n a display name like \"Nano Banana 2\" instead of the id \"NARWHAL\") gets a hard HTTP\n 400 on a call that already committed to a task, not a helpful list.\n\n Returns:\n images: {id: {label, typical_seconds, notes}} for the three valid `model` values\n (generate_image, generate_character_image).\n videos: {id: {label, credits, duration_s, mode, orientation}} for the curated\n `video_model_key` values this server's tools accept via their Literal type —\n mode is one of t2v/i2v/r2v (which generate_* tool it belongs to). `credits` or\n `duration_s` is null where Google's docs never gave that number — a null does\n NOT mean free/instant, it means unconfirmed.\n defaults: the id each tool falls back to when you omit the parameter — unchanged\n from before this tool existed, so already-working callers aren't affected.\n\n Note: service/api.py (the HTTP layer these tools call through) additionally\n accepts a wider set of rarer, exotic video_model_key values not listed here\n (confirmed-real but uncommon r2v/i2v variants) — this tool only lists the ones\n actually worth choosing from, to stay a short, readable list.\n ",
"inputSchema": {
"properties": {},
"title": "list_modelsArguments",
"type": "object"
},
"name": "list_models"
},
{
"description": "The 30 Gemini TTS voices usable with generate_voice: name, gender, short description.\n Gender/description are a rough guide only; any voice reads any language.",
"inputSchema": {
"properties": {},
"title": "list_voicesArguments",
"type": "object"
},
"name": "list_voices"
},
{
"description": "Talk to the Google Flow Music Producer agent instead of one-shotting a track.\n\n Use this when the work is a conversation rather than a single brief: asking what it can\n do, having it write lyrics first, or editing a track it already made (\"drop the vocals\",\n \"same song, 30 seconds shorter\", \"make the chorus bigger\"). For a plain \"make me a song\n about X\", music_generate is the shorter path.\n\n message — what to say. conversation_id — omit on the first message, then pass the one\n that comes back so the Producer keeps its memory of the track. model — same choices as\n music_generate.\n\n Returns {\"conversation_id\", \"text\", \"suggested_actions\", \"clips\": [...], \"media\": [...]}.\n `text` is the Producer's reply. `suggested_actions` are the follow-ups it offers — show\n them to the user, they are good prompts for the next turn. `clips` is EMPTY when the\n Producer only talked, and filled when it decided to actually make audio; treat a filled\n `clips` exactly like a music_generate result and save the audio.\n\n A reply is usually seconds, but a turn that produces a song takes minutes and comes back\n as a job_id to poll with check_job.\n ",
"inputSchema": {
"properties": {
"conversation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Conversation Id"
},
"message": {
"title": "Message",
"type": "string"
},
"model": {
"default": "lyria",
"enum": [
"lyria",
"lyria-pro"
],
"title": "Model",
"type": "string"
}
},
"required": [
"message"
],
"title": "music_chatArguments",
"type": "object"
},
"name": "music_chat"
},
{
"description": "Check remaining flowmusic credits and subscription tier.",
"inputSchema": {
"properties": {},
"title": "music_creditsArguments",
"type": "object"
},
"name": "music_credits"
},
{
"description": "Download the raw .m4a file of a track to the server.",
"inputSchema": {
"properties": {
"clip_id": {
"title": "Clip Id",
"type": "string"
}
},
"required": [
"clip_id"
],
"title": "music_downloadArguments",
"type": "object"
},
"name": "music_download"
},
{
"description": "Generate a full song from a text brief via Google Flow Music (Lyria).\n\n prompt — free text: genre, mood, BPM, instruments, and whether you want vocals or an\n instrumental (e.g. \"dreamy synthwave, retro 80s, 110 bpm, instrumental\"). The Producer\n agent turns it into a finished track (usually ~2-3 minutes, and it returns TWO variants).\n\n model — \"lyria\" (Lyria 3.5, the default flagship) or \"lyria-pro\" (Lyria 3 Pro, legacy).\n lyrics — optional explicit words to sing; omit for the model to write its own / stay\n instrumental.\n\n SAVE THE RESULT. Each returned clip carries a public `audio_url` (a Google Cloud Storage\n .m4a, no auth header needed) plus `download_path` on our server. Unless the user said\n otherwise, download the audio into their project. Fields per clip: clip_id, title,\n duration (seconds), lyrics, audio_url, wav_url, image_id (cover, feeds music_video),\n image_url. Returns {\"clips\": [...], \"media\": [...], \"conversation_id\": \"...\"} when done,\n or a job_id to poll with check_job if it isn't ready within ~90s.\n\n conversation_id — pass the one from an earlier result to keep working on the same track\n (\"same song but 30 seconds shorter\"); the Producer remembers what it just made. Omit it\n for a fresh start. Every result carries one, so a follow-up is always possible.\n ",
"inputSchema": {
"properties": {
"conversation_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Conversation Id"
},
"lyrics": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Lyrics"
},
"model": {
"default": "lyria",
"enum": [
"lyria",
"lyria-pro"
],
"title": "Model",
"type": "string"
},
"prompt": {
"title": "Prompt",
"type": "string"
}
},
"required": [
"prompt"
],
"title": "music_generateArguments",
"type": "object"
},
"name": "music_generate"
},
{
"description": "Get metadata for a single music track.",
"inputSchema": {
"properties": {
"clip_id": {
"title": "Clip Id",
"type": "string"
}
},
"required": [
"clip_id"
],
"title": "music_getArguments",
"type": "object"
},
"name": "music_get"
},
{
"description": "List the user's music tracks.",
"inputSchema": {
"properties": {
"limit": {
"default": 20,
"title": "Limit",
"type": "integer"
}
},
"title": "music_listArguments",
"type": "object"
},
"name": "music_list"
},
{
"description": "Split a track we generated into stems (vocals, instrumental, drums, bass, …).\n\n clip_id — the id of a clip returned by music_generate (or music_video's song). Runs on\n the same account that made the track. Returns {\"stems\": {name: \"/v1/media/...\"}, \"media\":\n [...]} when done, or a job_id to poll with check_job. Each stem is a downloadable .m4a on\n our server (public download_path). Save the ones you need into the user's project.\n ",
"inputSchema": {
"properties": {
"clip_id": {
"title": "Clip Id",
"type": "string"
}
},
"required": [
"clip_id"
],
"title": "music_stemsArguments",
"type": "object"
},
"name": "music_stems"
},
{
"description": "Re-make a video with YOUR character in place of the person in it: same camera,\n movement, gestures, timing and mouth movement, the character's look.\n\n character: name from list_characters (its portrait is used as the look).\n Source — ONE of media_id (a video this service made) or video_base64 (your own clip).\n who: which person to replace when there are several (\"the man on the left\").\n scene: one sentence about the room/background — helps keep it intact.\n extra: anything else for the model (\"keep the on-screen text\").\n start_sec/end_sec: recast only that piece (at most 10 s); the result is that piece.\n\n Two steps:\n 1. final=False (default) -> draft on abra_edit_360p, 10 credits: cheap check that\n the recast works on this clip (who gets replaced, does the scene hold).\n 2. final=True -> 720p on abra_edit, 20 credits. NOTE: for edits the seed does NOT\n carry a take across resolutions (checked live 2026-10-15: the draft kept the\n person's hoodie, the 720p run replaced the whole body), so expect the final to\n differ in details from the draft. To repeat a FINAL take, reuse its seed with\n final=True.\n Only for footage the user owns or is licensed to use; never put a real person's\n likeness into a clip without their consent.\n ",
"inputSchema": {
"properties": {
"aspect": {
"default": "VIDEO_ASPECT_RATIO_LANDSCAPE",
"enum": [
"VIDEO_ASPECT_RATIO_LANDSCAPE",
"VIDEO_ASPECT_RATIO_PORTRAIT"
],
"title": "Aspect",
"type": "string"
},
"character": {
"title": "Character",
"type": "string"
},
"end_sec": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "End Sec"
},
"extra": {
"default": "",
"title": "Extra",
"type": "string"
},
"final": {
"default": false,
"title": "Final",
"type": "boolean"
},
"include_preview": {
"default": true,
"title": "Include Preview",
"type": "boolean"
},
"media_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Media Id"
},
"scene": {
"default": "",
"title": "Scene",
"type": "string"
},
"seed": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Seed"
},
"start_sec": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Start Sec"
},
"video_base64": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Video Base64"
},
"who": {
"default": "the person in the video",
"title": "Who",
"type": "string"
}
},
"required": [
"character"
],
"title": "recast_videoArguments",
"type": "object"
},
"name": "recast_video"
},
{
"description": "Получить актуальный список LLM-моделей из каталога OmniRoute.\n\n OmniRoute сам опрашивает Google раз в час; `force_live=True` просит релей\n сходить в Google прямо сейчас (жёсткий rate-limit на стороне релея:\n не чаще 10 секунд). Полезно, когда клиент видит 404 на недавно\n добавленную модель.\n\n Args:\n force_live: True — передать `?live=1` на /v1/models и дождаться\n свежего каталога; False (по умолчанию) — вернуть кэш.\n\n Returns:\n {\n \"models\": [...], # OpenAI-совместимый список\n \"aliases\": {\"gemini-flash\": \"gemini-3.5-flash-lite\", ...},\n \"last_refreshed_at\": float, # unix timestamp\n \"source\": \"cache\" | \"live\",\n }\n\n Raises:\n MCPError: ключ невалиден или OmniRoute недоступен.\n ",
"inputSchema": {
"properties": {
"force_live": {
"default": false,
"title": "Force Live",
"type": "boolean"
}
},
"title": "refresh_llm_modelsArguments",
"type": "object"
},
"name": "refresh_llm_models"
},
{
"description": "Attach a preset Gemini TTS voice to a Flow character for auto-lipsync in future videos.\n\n Synthesizes a short reference audio in the chosen voice and attaches its media_id to\n the character's `audio_references`. This is a ONE-TIME setup per character: any\n subsequent video generation that references this character will auto-lipsync with this\n voice (same mechanism Flow Web uses when you set a voice via its UI).\n\n Calling it again overwrites the voice. Pass sample_text=null for a short default sample\n — only the resulting audio is kept as a reference; the content of the text is not used\n for later videos.\n\n character_id: entityId from create_character / create_character_from_photo.\n account: Google account email that owns this character.\n voice: one of list_voices() (default \"Algieba\").\n style: optional delivery hint, e.g. \"calm, slow\".\n sample_text: optional short sentence; default is a short neutral Russian sentence.\n project_id: optional project; omit for the account's default.\n\n Returns {entity_id, voice, media_id, audio_url, duration_sec_estimate, audio_references}.\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"character_id": {
"title": "Character Id",
"type": "string"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"sample_text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Sample Text"
},
"style": {
"default": "",
"title": "Style",
"type": "string"
},
"voice": {
"default": "Algieba",
"title": "Voice",
"type": "string"
}
},
"required": [
"character_id",
"account"
],
"title": "set_character_voiceArguments",
"type": "object"
},
"name": "set_character_voice"
},
{
"description": "Your support thread, including operator replies (from a human, usually within\n hours). `since` is a unix timestamp: only newer messages.",
"inputSchema": {
"properties": {
"since": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Since"
}
},
"title": "support_repliesArguments",
"type": "object"
},
"name": "support_replies"
},
{
"description": "Save a character's display name and/or personality notes. Without this, a\n character stays 'Untitled Character' with no description even after portrait/body\n images exist. account must be whichever Google account's project owns this entity_id.",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"display_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Display Name"
},
"entity_id": {
"title": "Entity Id",
"type": "string"
},
"personality_notes": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Personality Notes"
}
},
"required": [
"entity_id",
"account"
],
"title": "update_characterArguments",
"type": "object"
},
"name": "update_character"
},
{
"description": "Upscale an existing generated image (from a prior generate_image call) to a\n higher resolution -- the same \"1K/2K/4K\" choice Flow offers when downloading.\n\n account: the Google account whose project owns media_id. Do not guess it and do not\n ask the user: the generate_image result you already have carries it in the\n `account_used` field -- pass that value verbatim. A media_id only exists inside the\n project of the account that produced it, so any other account returns a clean error.\n\n target_resolution: \"2K\" or \"4K\". Not every image supports upscaling (depends on the\n source model/size) and 4K may be locked behind a paid plan tier on some accounts --\n both cases come back as a clean error rather than a crash, so just report it if that\n happens instead of retrying.\n\n Takes roughly 15-30s -- returns a job_id to poll with check_job if it is not done\n within ~35s.\n\n Returns {\"media_id\": <new upscaled mediaId>, \"download_path\": \"/v1/media/....jpg\",\n \"resolution\": ...} when done.\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"media_id": {
"title": "Media Id",
"type": "string"
},
"target_resolution": {
"default": "2K",
"enum": [
"2K",
"4K"
],
"title": "Target Resolution",
"type": "string"
}
},
"required": [
"media_id",
"account"
],
"title": "upscale_imageArguments",
"type": "object"
},
"name": "upscale_image"
},
{
"description": "Upscale an existing generated video (from a prior generate_video call) to a\n higher resolution -- the same \"270p/720p/1080p/4K\" choice Flow offers when downloading.\n\n Counts against the weekly free video limit (3 a week without a subscription), like\n any other video operation, and spends the account's own Flow credits.\n\n account: the Google account whose project owns media_id. Do not guess it and do not\n ask the user: the generate_video result you already have carries it in the\n `account_used` field -- pass that value verbatim. A media_id only exists inside the\n project of the account that produced it, so any other account returns a clean error.\n\n target_resolution: \"1080p\", \"4K\" or \"from_360p\" (omni_upsampler_360p -- lifts a 360p\n draft to normal quality; not yet live-tested). 4K may be locked behind a paid plan tier on some\n accounts -- comes back as a clean error rather than a crash, just report it.\n\n Slower than generation: it is kicked off and then polled like a normal video\n generation -- returns a job_id to poll with check_job if it is not done within ~40s.\n\n Returns {\"media_id\": <new upscaled mediaId>, \"download_path\": \"/v1/media/....mp4\",\n \"resolution\": ...} when done.\n ",
"inputSchema": {
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"media_id": {
"title": "Media Id",
"type": "string"
},
"target_resolution": {
"default": "1080p",
"enum": [
"1080p",
"4K",
"from_360p"
],
"title": "Target Resolution",
"type": "string"
}
},
"required": [
"media_id",
"account"
],
"title": "upscale_videoArguments",
"type": "object"
},
"name": "upscale_video"
}
]
}What the leaf hashes
{"body":"2ae0991c79dd03e0ee69653f3f30137190ba2922df0a378d5be5ec334c88947a","id":772084,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793192552674290,"prev":583728,"subject":"de187d1b-a110-47d0-a3db-e553a9e8d52e","subject_kind":"endpoint"}Proof
Fold these into the leaf in order, hashing each sorted pair with keccak256, to reach the root of (231336 rows).
- 0x6ca7705527171025f37275a2ffc6cfc2e29f856f5a4e604f5ffe3d84baaedc5c
- 0x9658cd6a70f4b8d66094db8d82c683ab2c8a7a7e8b43df2203c07bc20a82c2cd
- 0x36e3aea7d717cb100d3dd682162f9526c5255362e000b3378ac7cec41434d067
- 0x05bece6c15d7c997e16190b39623cfd7dc76e43b387626d723c7d87ca21e5423
- 0x51fbeeb1c8d523337246a1f15aee3462695294efd23d71ae0c98c721a239cca0
- 0xb7dce9806c6659374480a003d8c3a4f30d41c813d6c6654e7805e775acdfa239
- 0x4a3415058c5503d2c9ec08b6e25a26f5a1d7e2cd7247c6497e7a72cc7ce7cce7
- 0x5a522461784344e0e58f064fbda34bbc1947e1823f9f5d676ceedb028d263d7e
- 0xfbc65361cd42ce511b7b9352d8ae807f53fdec9b5a07be4aa7c2f90b41d4d9e5
- 0x9eec8e69262d3ea9ae1725c646b7900d3d6957b3306094f94d685f23f0978ab8
- 0xe41388208d64ac28fecdff79c7cc50bbb41ac0b13babfea658504aedeec03594
- 0xa5dc8bde09a0592357df20e8407be89c2531fc0bf17e0d5a15a0464d79e7bf90
- 0xc0e02389eb414c04a7dc9b6703be98601510da00046cf6f744adbfe5e43bf146
- 0x9629b9515160844aacc33a6aff292bbb444ac65e0d773f2fa899885c3481fa54
- 0xe6054de1f67b1e6f15bcf16d2b6536cf35dd9705fdf6ce59853e79784693ab5f
- 0xa99a40fe210d675bb6ab72d4bb72ab40eb44ac345773c457fbe58e67a47b03df
- 0x7a743a0a09057bae687051274e1d45bf973bd36a1a4ba16a191b5d29e3bdfa2a
- 0xe027395fafb7fc41921c42ca0542524ea22204cbd5908b70b27f3d5fb26f5d0f
- Day root
- 0x2c19037464cc4c493624565f01775d6446fc78eaa118fc6865bfe2bfca9ff78e
- Chained
- 0xd1d7dee8322ceff8f4c8d83aa1fe4a4466825c2af1c97dbde3d35db61234f7be
- Published
- On Arc Testnet, block 69584042: 0x8bae2b1d097834c8b458513862d70d29ee807e98dc2e863b27250131c15b35ae