Higgsfield

Read a 3D Jutsu project's current revision, scene sequence, active operation, and committed artifacts. Obtain `projectId` from `scene_builder_3d_list_projects`, `scene_builder_3d_create_project`, or an explicit user selection. An authorized project with `exists: false` is a valid empty scene at revision 0. Use `scene_builder_3d_query_python` to inspect actual objects, dimensions, materials, cameras, and lights before editing. If an operation is active, use `scene_builder_3d_get_operation` to settle it before another mutation. Scene edits use `scene_builder_3d_run_python` with the exact revision and scene sequence inspected; never guess these guards. Before building or editing a scene, load get_preset_instructions with { preset: "/3d-jutsu" } once for the full workflow, runtime limits and scene-building references.

scene_builder_3d_get_project

Resolve a signed GET for a scene asset referenced by an object.create.from_glb journal operation from scene_builder_3d_get_collaboration. Widget-only; use the asset ID, not a catalog ID or URL.

scene_builder_3d_get_scene_asset

Import a confirmed catalog GLB from `scene_builder_3d_search_assets` into the selected project as a collaborative scene entity. Supply the catalog's asset ID, not a URL. The tool runtime resolves and uploads the bytes, reads the project guards, submits the import, and waits for it to appear in the settled scene. Do not import while another mutation is active. After import, inspect dimensions, placement, orientation, contact, and materials with `scene_builder_3d_query_python` before further edits. Do not repeat the whole import to poll: it can create a duplicate. If an import fails, report the error; never fall back to Python network calls or base64-encoded model bytes. Copy catalogSearch from the search result's importArguments. If settled is false, poll scene_builder_3d_get_project until appliedSceneSequence reaches targetSceneSequence. If submissionUnknown is true, inspect the returned entityId before deciding to retry. This version accepts catalog assets only. Finish each completed scene creation, edit, or import task by calling `scene_builder_3d_show_scene` once as the final scene inspection/edit call of that review phase, after mutations have settled and verification is complete. Pass the same `projectId` and the exact committed `revision` of the final result: `revisionAfter` from the final successful mutation, or the settled `project.revision` after an import. Do not guess the revision. Show an unchanged revision only once. Authorized generation and status calls may follow; later feedback or a verified mismatch can reopen scene editing. Verify and show the corrected revision at its next review boundary. This shows the result to the user; a text summary or download link alone does not finish scene delivery.

scene_builder_3d_import_asset

Read the shared image/video generation history of a 3D Jutsu project, newest accepted first. Includes pending and failed attempts. Pass nextCursor as before for older records; status changes never reorder records. Use scene_builder_3d_get_generation for an individual result.

scene_builder_3d_list_generations

Discover the authenticated user's 3D Jutsu projects before choosing a scene to read or edit. Follow `nextCursor` to see more results. Use the selected project's `id` as `projectId` in every project-scoped 3D Jutsu tool; no call sets a global active project. Match the user's named project, and ask them to choose if the result is ambiguous. Then call `scene_builder_3d_get_project` for its current state. A project's presence here does not bypass permission checks on subsequent calls. To start a new project, use scene_builder_3d_create_project. Before building or editing a scene, load get_preset_instructions with { preset: "/3d-jutsu" } once for the full workflow, runtime limits and scene-building references.

scene_builder_3d_list_projects

App-only phone pairing for the 3D Angles recorder after scene_builder_3d_get_project. Create a room, renew its host ticket, or stop it. Does not modify project cameras or generate media.

scene_builder_3d_phone_camera

Inspect the latest settled Blender scene without committing changes. `bpy` and the `artifacts` registry are available; assign concise JSON-serializable findings to `result`. Query exact names, metre-scale dimensions, transforms, parents, collections, materials, cameras, lights, visibility, and animation settings as needed. Inspect Blender RNA when an API or enum is uncertain. Temporary scene changes are discarded, including camera changes used for inspection. A query can render and publish images for visual inspection: allocate a target with `artifacts.file(name="preview.png", media_type="image/png")`, write the image to `target.path`, and call `target.publish()`. Resolve published IDs with `scene_builder_3d_get_artifact`. Use the successful query's `revisionBefore` and `sceneSequenceAfter` as the guards for the next `scene_builder_3d_run_python` call. If still active, poll `scene_builder_3d_get_operation`. Reuse an operation ID only to retry the identical request. Imported model bytes must enter through `scene_builder_3d_import_asset`; do not fetch URLs or embed file bytes in Python.

scene_builder_3d_query_python

Commit one coherent Blender scene edit against the exact revision and scene sequence you inspected with `scene_builder_3d_get_project` or `scene_builder_3d_query_python`. `bpy` and `artifacts` are available; assign JSON-serializable findings to `result`. Keep one mutation active per project, including imports. If this operation remains active, poll `scene_builder_3d_get_operation` before editing again. Reuse `operationId` only for the identical code and preconditions. On a stale-state conflict, inspect the scene again and regenerate the edit with fresh guards and a new operation ID. REVISION_CONFLICT rejects the submission: do not poll that operation ID. A successful mutation advances `revisionAfter`. This worker pins Blender 5.2: use `BLENDER_EEVEE`, `BLENDER_WORKBENCH`, or `CYCLES`, not `BLENDER_EEVEE_NEXT`. Code is capped at 256 KiB, and execution and checkpoint/export must fit the configured worker deadline; keep renders small and split expensive work into coherent edits. Do not invent texture paths or fetch external files from Blender; use `scene_builder_3d_import_asset` for models. Successful execution does not establish visual correctness. Render from the delivery camera, publish the image through `artifacts`, retrieve it with `scene_builder_3d_get_artifact`, and inspect it before claiming completion. If visual inspection is unavailable, state what remains unverified. Use `scene_builder_3d_get_glb` or `scene_builder_3d_get_blend` when the user needs the committed files. Before building or editing a scene, load get_preset_instructions with { preset: "/3d-jutsu" } once for the full workflow, runtime limits and scene-building references. Finish each completed scene creation, edit, or import task by calling `scene_builder_3d_show_scene` once as the final scene inspection/edit call of that review phase, after mutations have settled and verification is complete. Pass the same `projectId` and the exact committed `revision` of the final result: `revisionAfter` from the final successful mutation, or the settled `project.revision` after an import. Do not guess the revision. Show an unchanged revision only once. Authorized generation and status calls may follow; later feedback or a verified mismatch can reopen scene editing. Verify and show the corrected revision at its next review boundary. This shows the result to the user; a text summary or download link alone does not finish scene delivery.

scene_builder_3d_run_python

Search the curated GLB model catalog available to 3D Jutsu. This read is authorized against `projectId`; the catalog itself is shared. Pass a returned `assetId` to `scene_builder_3d_import_asset` for the same selected project. Search results are available models, not objects already present in the scene. Inspect existing scene objects with `scene_builder_3d_query_python` before deciding what to add. Never invent an asset ID or turn a catalog URL into Python download code. Copy the returned importArguments, including catalogSearch, into scene_builder_3d_import_asset.

scene_builder_3d_search_assets

Show an interactive 3D scene preview of an existing 3D Jutsu project. Choose projectId with scene_builder_3d_list_projects, scene_builder_3d_create_project, or the user's explicit selection. Pass revisionAfter from a successful edit to show that exact result, or omit revision for the latest committed GLB. Wait for edits to settle with scene_builder_3d_get_operation before showing their result. This reads an existing export; it never starts Blender, edits the scene, or includes uncommitted collaborative changes. Call this when the user asks to see the scene. For a completed scene creation, edit, or import task, call it once at the scene review boundary after settlement and verification. Do not repeat an unchanged revision. Authorized generation/status calls may follow; feedback or a verified mismatch can reopen editing and lead to a newly verified revision. The widget is for the user to inspect; it does not give the agent visual evidence. Use scene_builder_3d_query_python and scene_builder_3d_get_artifact for the agent's visual verification. If the client cannot display widgets, provide the returned projectUrl.

scene_builder_3d_show_scene

Upload a confirmed catalog GLB into the authorized project's current settled revision. Widget-only. sha256 must match the bytes displayed by the editor. Returns only the uploaded scene asset ID, which the editor references in one object.create.from_glb operation through scene_builder_3d_apply_scene_operations. This does not create a scene object.

scene_builder_3d_upload_catalog_asset

Quote or generate a batch of one to four character sheets from the builder, or check a job. Free generations always submit one sheet. Returns job_id for the first accepted job and job_ids for a batch; track every returned job. Submit only after the user clicks Generate with a displayed price. Free generations require the builder’s explicit Use free gens toggle; never retry a rejected free request on credits automatically. The Motion tab quotes and submits influencer Genjutsu jobs using motion_quote/motion_submit, with the dedicated ai_influencer job types.

ai_influencer_builder

Open the main Higgsfield AI Influencer Builder. For a bare 'ai influencer' request, open the builder immediately: the user chooses the design inside the UI, so no brief or clarification is needed before opening. Also use for the OpenAI /build-ai-influencer entrypoint, or when the user asks to open the builder UI. If current user or host context explicitly says the builder is already open, continue in chat without reopening unless requested. A previous open call does not establish current visibility. For creating described characters, multiple variants or a sheet directly in chat, use ai_influencer_prepare followed by ai_influencer_generate. Opens the existing builder directly, without generating a character sheet or video. Do not use for questions asking only to explain AI influencers.

open_ai_influencer

App-only: load a page of AI Influencer character sheet presets with preview media and recreate parameters.

ai_influencer_character_sheet_presets

Generate and save one to four AI Influencer character sheets in the selected Higgsfield workspace from exact params returned by ai_influencer_prepare. Does not train a Soul or generate video. Rechecks price before submission and rejects paid prices above max_credits. Paid generation spends existing credits; it does not purchase credits or subscriptions. use_free_gens=true requires explicit user intent and backend eligibility, with max_credits=0 for free-only requests; never falls back to paid generation. Returns job_id for the first accepted job and job_ids for a batch before completion; wait for every returned job. Free generations always submit one sheet. Repeating this call can create another job and spend credits again; never automatically retry an uncertain submission. An auto-updating generation widget shows every accepted sheet and its progress. Wait with jobs_wait (timeout_seconds <= 15); do not call show_generation_by_ids or job_display again unless the user requests a separate display. After completion, offer Genjutsu animation and wait for agreement before opening motion presets.

ai_influencer_generate

List available AI Influencer character traits for human and animal tiers. Optionally filter by tier; returns option IDs and tier constraints for ai_influencer_prepare. Does not randomize, quote, create or save a character.

ai_influencer_get_options

Read reusable settings from an existing AI Influencer sheet using its job_id. Returns human or animal traits, identity and Style references, body color and saved appearance variants when present. Does not replay the original batch count, quote, save or generate an image. Pass returned params to ai_influencer_prepare with randomize=false to preserve the design.

ai_influencer_get_settings

Browse AI Influencer character-sheet presets with previews and reusable settings. Does not generate a sheet. Pass selected preset settings to ai_influencer_prepare with randomize=false.

ai_influencer_list_presets

Prepare an AI Influencer character design and quote the total credit cost for batch_size (one to four sheets, default one) without creating a job or spending credits. Accepts human or animal tiers, traits, brief, seed, at most one confirmed identity image in medias and up to three Style references in item_medias. Preserves animal-v3 look and animal trait choices from saved settings; FNF validates variant IDs against the current catalog. Default randomize=true fills unspecified traits using builder shuffle rules; reference identity traits stay unset unless explicitly selected. randomize=false preserves explicit settings and defaults tier to freak (Bold). Returns exact params, credits and free_gens_remaining when known. For generation, pass these params unchanged to ai_influencer_generate; preview-only requests stop here. Repeating preparation may produce a different random design.

ai_influencer_prepare

Retrieve the authenticated user's available free-trial offer and account URL for display in the app. Fetching the offer may create a checkout session, but does not start a trial or charge a payment method. Invoked only by the app.

get_account_overview

Quote an Ad Multiplier v2 recreation or the maximum credit reservation for Hook/CTA replacement in the app.

ad_multiplier_quote

Add a product to Ads Studio - under a brand, or with no brand at all - from its page link and/or a pasted description. Answers as soon as the row is queued - Ads Studio reads the page in the background. Do not poll and do not list products to check. Read ads_studio_get_product when the user asks about it. Use this when the research missed a product or the user names a new one. To refresh an existing product from its page, pass its id in overwrite instead of adding a second row.

ads_studio_add_product

Add items to an existing Higgsfield canvas board in the authenticated user's workspace: sticky notes, text, shapes, images, image and video generation nodes, and connections between items. It does not create pages; page_id puts an item on a page that is already on the board. Use it when the user asks to put something on a board; canvas_update changes existing items and canvas_remove deletes them. Added items are saved to the board and appear live for everyone viewing it, including an open_canvas view already shown: do not call open_canvas again to refresh it. A generation item saves its model, prompt and settings only: this tool does not start generation or charge generation credits; canvas_run does. Give a generation item only the settings the user asked for: the others stay the model's defaults, and the result lists the settings each generation node got and any value the model did not take. An image item imports a Higgsfield generation or upload image URL into the user's Higgsfield media; unsupported URL origins are rejected before the board changes, and imported media may remain even if adding to the board fails. A connection into a generation node feeds it: the source (an image, a video, another generation node's result, or text for the prompt) fills the node's matching free input (an image fills reference images before a start or end frame; set the connection's input to choose, e.g. start_image for an exact first frame), and canvas_run uses it. That is how to generate from an image on a board, e.g. image to video. Between other items a connection draws an arrow. Give items a key to connect them in the same call; connect to items an earlier call added by the ids it returned. To add more than 5 items, make several calls of up to 5 items each, in the order a person would lay them out (a card or a step at a time), so everyone viewing the board sees it grow, and set final on your last change to the board. Additions can partially apply: inspect applied and rejected before retrying, since repeating an addition creates duplicates. Returns the new items' ids in order, and each connection's id and the input it fills.

canvas_add

Open the Higgsfield Ads Studio page inside the Higgsfield app: brands and ad generations.

open_ads_studio

What the Ads Studio card shows: brands, one brand, products or one product. Used by the card.

ads_studio_card

Progress of one Ads Studio generation run. Used by the generation card.

ads_studio_run_progress

Read-only catalog of the 3D rig animation library (678 actions: locomotion, gestures, dancing, combat, daily actions). Search by name or browse by group/category to find the animation_action_id for 3D generation with enable_animation=true. Each result has a preview_url GIF — when several candidates fit (e.g. many Idle or Walk variants), show the user the previews as markdown images and let them pick instead of choosing blindly. Does not create jobs.

animation_actions

Archive one project reversibly. Inspect get_project capabilities first when permissions are unclear. Restore it with unarchive_project.

archive_project

Read the public profile of an asset's author for its showcase sidebar.

soul_feed_author

List existing uploaded, generated, or liked image/video assets for an app picker. Invoked only by the app; never uploads, generates, or modifies assets. Generations and liked assets support combined image/video kinds and an accessible project or exact folder scope. Sort generations by creation time, project assets by time added, and liked assets by time liked. Uploads also support last-used. Available sorts depend on source and scope.

assets_picker_list

Attach an existing accessible typed source ID to folder_id. Upload and confirm a new file using media_upload/media_confirm with source_type=file_input first. Reattaching the same source to the same folder reuses its placement. Inspect assets after an uncertain receipt; never blindly repeat mutations.

attach_project_asset

Read-only catalog lookup: filters and preset_id select catalog records. Returned input requirements refine the published execute_preset input variants; this lookup does not execute a preset. Search and browse reusable image and video generation presets from Higgsfield's Viral, Marketing Studio, Genjutsu, Katana, Soul and personal Recraft style galleries, or retrieve a preset's inputs and preview without starting a generation. For sources other than Katana, Soul and Recraft: A bare preset slash command or a request to open, preview, or browse a preset only opens its widget. For supplied attachments, use input_schema from get_preset_instructions to map and upload the relevant files before opening any widget. Call get_presets exactly once with source, preset_id and initial_inputs in the exact schema fields. Do not call get_presets just to inspect the schema. Leave omitted settings to schema defaults; never reopen the detail merely to repeat default selections. Never assume one photo satisfies all requirements or guess ambiguous slot assignments. Leave missing fields in the prefilled widget for the user. Stop after opening the detail and let the user interact with it. Do not call execute_preset unless the user explicitly asks to generate, or submits with Recreate in the widget. Check execution.readiness for the supplied inputs before execution; collect missing or invalid fields instead of submitting. execution.available indicates capability, not permission; optional inputs and built-in media do not authorize generation. Readiness checks input structure, not media ownership or upload confirmation; use only confirmed media IDs. If the widget reports submitted job IDs, display and wait for those jobs without executing again. For sources other than Katana and Recraft, pass query to search preset names, descriptions and types before pagination. All query words must match; omit source to search Viral and Marketing Studio. Pass preset_id to open a published preset detail preview directly. Omit source to browse Viral and Marketing Studio; limit applies to the complete page. source='genjutsu' lists only Higgsfield Genjutsu motion presets with category='genjutsu'; legacy 'genjutsu-trending' and 'genjutsu-new' categories open the same Higgsfield catalog; a bare /genjutsu opens this gallery. To choose motion for an existing AI Influencer, pass initial_inputs:{character_sheet:[{id:"<confirmed sheet job UUID>",type:"image_job"}]} — character_sheet must be a one-item array, not a single object; legacy source='marketing_studio' still accepts these categories and genjutsu: IDs. category='genjutsu-styles' lists Genjutsu Styles: named looks (e.g. Knitted Yarn World, Rounded Toy CGI) that redraw the user's own video while keeping its motion. When the user names a look, search it with query; preset_id 'genjutsu-style:<id>' opens its form, and initial_inputs {video:[<confirmed video UUID>], references?, resolution} adds readiness and price. source='soul' browses curated Soul 2.0 image styles. Search with query or open a style with preset_id and source='soul'. Each item's id is the style_id for generate_image or generate_image_batch with model='soul_2'; do not call execute_preset for Soul styles. A style can be combined with soul_id, but not with medias/image references. Preview images are catalog samples, not generation inputs. Browsing or selecting a style does not authorize generation. source='recraft' browses the caller's own completed Recraft styles saved in Higgsfield, not general presets or styles in a separate Recraft account. Search names by substring with query or open a style with its UUID as preset_id. Each item's id is the style_id for generate_image or generate_image_batch with model='recraft_v4_styles', not recraft_v4_1. Do not call execute_preset for these styles. Preview images are samples, not generation inputs. Browsing or selecting a style does not authorize generation. An empty catalog means no matching ready personal styles are available; do not substitute a general style. source='viral' lists Viral Hub chain presets for /effects requests; source='marketing_studio' lists Marketing Studio templates: for /product use category='product-shot', for /motion use category='motion'. source='katana' is a user-facing catalog, not headless search: query and initial_inputs are unsupported. preset_id:'<slug>' opens one Katana preset's input form directly; use it only as the loaded /katana/slug instructions direct, when the user asked to run that preset and its inputs are missing. To find or choose a Katana preset for a task, call get_preset_instructions with preset omitted, match the returned titles/descriptions, then load its exact /katana/slug. Do not open this gallery merely to choose a preset for supplied media. Explicit catalog browsing opens the Katana catalog without default filters; category supports personalized_edits, style_transfer and motion_transfer, katana_source supports community or higgsfield. Katana uses opaque string cursors and backend-default page sizes (explicit limit maximum 20). Recreate selections resolve exact /katana/slug instructions with get_preset_instructions. Katana browsing does not execute a preset. source='what_if' opens the What If style gallery of /content-factory, where the user picks a style and types the prompt; call it only for a bare /content-factory or when the user asks to browse What If styles, never when a topic is given. It takes no other filters and does not start a generation. Use category slugs returned by this tool and pass next_cursor only when the user asks for another page.

get_presets

Cancel an owned pending Ad Multiplier v2 generation from the app's Cancel action.

ad_multiplier_cancel

Cancel the CURRENT open publication review after explicit user approval. No review-ID binding exists. Cancellation does not roll back metadata already saved by preview/update/publish, and does not unpublish an existing publication. Obtain explicit user approval through the MCP host before invoking this tool. The host owns its approval policy; the server cannot independently verify a human decision. Do not invoke based only on inferred intent. After an uncertain response, stop and read get_project_publication to observe current state. There is no per-operation receipt or automatic replay guarantee; do not blindly repeat a publication mutation. The private working-project name, public publication title (settings.name), and URL slug (settings.slug) are distinct; never infer a title or slug change from a working-project rename. For a share-link request, preserve any existing slug; prepare a nonempty URL-safe slug in the proposal only when absent or when the user requests a URL change, before approval and verify public_url after completion. show_canvas does not establish whether chats are hidden; no separate chat-privacy control or complete composition inventory is available, so do not promise that chats are excluded. Pending moderation runs automatically: wait and read state; only awaiting_confirm needs a separate flagged-item decision. Capture can include changes made while publication is in flight; after a completed snapshot, later working-project changes require republishing. Report completion only from observed state and review, never merely an accepted mutation response. For republish, compare snapshot_id and processing state with the prior observation. An unchanged snapshot may be a successful no-op when current content is already served, or the old version while work is in flight; do not infer pending from an unchanged ID. Report observed state and any attribution uncertainty; neither a new snapshot nor current state is a per-call receipt.

cancel_project_publication_review

Cancel a queued or running Ads Studio generation. Pictures already rendered stay; a run too far along to stop answers that it can no longer be canceled. Only cancel when the user asks.

ads_studio_cancel_run

Show a canvas board to the user in the Higgsfield app. Pass room_id (or the canvas URL) to open that board live: changes made with canvas_add, canvas_update or canvas_remove, and canvas_run results, appear in it as they happen, and the user can select items to give you context. Call it once per board; do not call it again to refresh after edits or runs. Without room_id it shows the user's boards. Does not change the board.

open_canvas

Read-only balance: credits, workspace plan, free generations (free_gens — Genjutsu on generate_video, Viral on execute_preset, and AI Influencer Builder via its Use free gens toggle), and free-trial state (free_trial.unlim_available says whether unlimited generations can be spent). Call it for credits / plan / trial questions or after an out-of-credits error. Report the current balance and entitlement state, and explain any insufficient-credit limitation. Do not provide pricing links, purchase or upgrade directions, or trial-start instructions.

balance

Check the status and results of an async job. Returns instantly. For non-terminal jobs the response includes poll_after_seconds — wait that many seconds before calling again. Typical total times: image ~10-20s, video ~60-180s.

job_status

Clear the active workspace selection so subsequent MCP operations use the user's default private workspace. This changes selection only; it does not delete any workspace.

workspace_clear_selection

Validate a filled Katana preset form and return the chat message that starts the preset.

katana_compose_message