Generate images, video, voice, and 3D assets from the terminal
Connect Higgsfield MCP and your agent can work inside Higgsfield's creative platform from the terminal. It reads the voice list, the animation and preset catalogs, credit balance, and the status of past jobs without asking. Generation, dubbing, and website deploys are proposed first, then run after you approve them. Authentication uses OAuth with dynamic client registration.
101 tools: 47 read, 54 write. Reads answer instantly. Writes require approval by default. Everything is logged.
ReadAnimation actionsRead-only catalog of the 3D rig animation library (678 actions: locomotion, gestures, dancing, combat, daily actions).
ReadApps describeGet an app's action contract: with `action`, the full input/output schema + execution mode for that one action; without it, a summary of every action.
ReadApps searchSearch Higgsfield Marketplace apps callable through MCP.
ReadBalanceGet the user's available credits and current subscription plan.
ReadGet explainer presetsShow the explainer video style presets (CMS-managed catalog).
ReadGet workflow bundle fileRead a safe text file or directory from a workflow's resource folder.
ReadGet workflow instructionsAd Multiplier — load workflow 'ad-multiplier' when the user asks to 'multiply my video', 'multiply my ad', create multiple independently edited versions of one supplied 4-30 second video, or…
ReadJob displayShow one specific previous generation in the single-result UI widget by job ID.
ReadJob statusCheck the status and results of an async job.
ReadJobs waitLong-poll 1-12 generation jobs together without opening a widget.
ReadList voicesList available voices for speech and voice tools.
ReadList website categoriesList the content categories a website can be filed under — each with a slug, label, description, and display position.
ReadList websitesList the websites you own — each with its id, name, slug, and live URL.
ReadList workspacesList every workspace the user can access (their private workspace plus any shared/team workspaces).
ReadMarketing studio v2 avatarsWidget-internal: list the user's Marketing Studio avatars (preset and custom) for the avatar picker.
ReadMarketing studio v2 costsWidget-internal: the Marketing Studio v2 pricing document.
ReadMarketing studio v2 presetsWidget-internal: load a page of the Marketing Studio v2 preset feed for a category.
ReadMarketing studio v2 statusWidget-internal: poll status and results of submitted Marketing Studio v2 jobs.
ReadPresets showShow available Higgsfield presets for image-to-video generation.
ReadScene builder 3d get artifactResolve a short-lived download for an image or video that a successful Python operation published through `artifacts`.
ReadScene builder 3d get blendResolve a short-lived download for the current committed editable Blender file, or a specified historical revision.
ReadScene builder 3d get glbFor an interactive scene preview use `scene_builder_3d_show_scene`.
ReadScene builder 3d get operationRead or wait for a submitted Python operation in this project.
ReadScene builder 3d get projectRead a 3D Jutsu project's current revision, scene sequence, active operation, and committed artifacts.
ReadScene builder 3d list projectsDiscover the authenticated user's 3D Jutsu projects before choosing a scene to read or edit.
ReadScene builder 3d search assetsSearch the curated GLB model catalog available to 3D Jutsu.
ReadScene builder 3d show sceneShow a minimal interactive 3D Jutsu scene preview with orbit, pan, zoom, a basic animation timeline with play/pause and seeking, and a link to the website.
ReadShorts studio list presetsBrowse Shorts Studio style presets — the visual STYLE a short is restyled toward.
ReadShorts studio list sessionsList the caller's past Shorts Studio sessions (newest first) to find a session_id to poll with shorts_studio_status.
ReadShorts studio statusPoll one Shorts Studio session.
ReadShow generation by idsRender exactly 1-60 requested generation jobs in the full-profile gallery widget, ordered by index and paginated locally in groups of 12.
ReadShow generationsBrowse completed non-Marketing Studio generation history and render one paginated page in the gallery widget.
ReadShow marketing studio generationsBrowse past completed Marketing Studio generations only.
ReadShow marketing studio v2Open Marketing Studio — a template gallery widget with category tabs (UGC ads, product shots, motion graphics, posters, ads, marketplace) and a preset grid the user browses and recreates from with…
ReadShow mediasList your uploaded media files by type.
ReadTiktok accountsList the user's connected TikTok accounts.
ReadTiktok music trendingList trending commercially licensed tracks from TikTok's Commercial Music Library for the connected account.
ReadTiktok music tuneOpen the tuning editor for one Commercial Music Library track the user already picked (via tiktok_music_trending): trim start/end and set track/original volumes.
ReadTiktok publish statusStep 3 of publishing.
ReadTransactionsList the user's credit transactions (spend/refund/grant/deduct), newest first.
ReadVideo analysis jobsList the user's video analyses in the current workspace, newest first.
ReadVideo analysis statusGet the status and result of a video analysis.
ReadWebsite dbInspect the website's database (D1 / SQLite), READ-ONLY.
ReadWebsite statusGet the website's deploy status — the live URL and the status of the last deploy.
WriteApps invokeRun one described action on a Marketplace app AS the current user. Approval by default
WriteCancel trial auto renewalCancel the auto-renewal of the Higgsfield MCP free trial. Approval by default
WriteConfirm billing purchaseINTERNAL — invoked ONLY by the plans widget on an explicit user Confirm click. Approval by default
WriteConfirm trial cancelINTERNAL — invoked ONLY by the cancel-trial confirmation widget on an explicit user click of 'Cancel auto-renewal'. Approval by default
WriteCreate voiceOpen the Create Voice Apps UI. Approval by default
WriteCreate voice from confirmed audioBackend-only creation of a cloned voice from an already confirmed audio upload. Approval by default
WriteCreate websiteStart a new full-stack website. Approval by default
WriteDeploy websiteBuild and deploy the website via CI, then return its live URL. Approval by default
WriteDubbingDub a video into another language: translate the spoken audio, synthesize it in the target language, and lip-sync the result back onto the video. Approval by default
WriteGenerate 3dGenerate a 3D GLB mesh. Approval by default
WriteGenerate audioGenerate one speech/voice request (text-to-speech) and render it in the generation widget. Approval by default
WriteGenerate audio batchSubmit 1-12 independent audio generations in parallel without opening a widget. Approval by default
WriteGenerate imageGenerate one image request and render its result(s) in the generation widget. Approval by default
WriteGenerate image batchSubmit 1-12 independent image generations in parallel without opening a widget. Approval by default
WriteGenerate videoGenerate one direct video request and render it in the generation widget. Approval by default
WriteGenerate video batchSubmit 1-12 independent video generations in parallel without opening a widget. Approval by default
WriteMarketing studio v2 createWidget-internal: recreate a Marketing Studio v2 preset — validates inputs against the preset's recreate contract and submits one generation. Approval by default
WriteMedia confirmConfirm file uploads after using media_upload's upload_url method. Approval by default
WriteMedia import urlImport an HTTPS image, video, or audio URL into Higgsfield storage and return a confirmed media_id. Approval by default
WriteMedia uploadUpload media for use in generation, or general files (documents, archives, code) for sharing. Approval by default
WriteMedia upload widgetRequired local-media intake for Higgsfield in Apps UI-capable clients. Approval by default
WriteMotion controlAnimate an existing character image with the motion and camera movement from a reference video using Kling 3.0 Motion Control. Approval by default
WriteOutpaint imageExpand or uncrop an existing image by outpainting beyond the original frame while preserving the source content. Approval by default
WriteParticipate in contestEnter the website in the current Higgsfield app contest, together with the social-media links promoting it. Approval by default
WritePersonal clipper createTurn YouTube videos into ready-to-share clips. Approval by default
WritePublish websitePublish the website: lists the website's CURRENT LIVE production deploy on the Higgsfield community feed ('show in feed'), where other users can discover it. Approval by default
WriteReframeExpand or reframe an existing video to a new aspect ratio while preserving the source content. Approval by default
WriteRemove backgroundRemove or cut out the background from an existing image or video. Approval by default
WriteRename websiteRename the website's SUBDOMAIN (the slug in its public URL). Approval by default
WriteResolve explainer presetResolve a explainer video style preset (from get_explainer_presets) into a style reference media_id: the backend imports the preset's style image into the user's media storage. Approval by default
WriteReveal generationConfirm the user has rights to the content of an `ip_detected` generation and flip its status to `completed`. Approval by default
WriteSandbox execExecute a shell command in a remote Higgsfield cloud Linux sandbox — NOT your local machine or the client's own shell. Approval by default
WriteScene builder 3d create projectCreate a new private 3D Jutsu project for the authenticated user. Approval by default
WriteScene builder 3d import assetImport a confirmed catalog GLB from `scene_builder_3d_search_assets` into the selected project as a collaborative scene entity. Approval by default
WriteScene builder 3d query pythonInspect the latest settled Blender scene without committing changes. Approval by default
WriteScene builder 3d run pythonCommit 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`. Approval by default
WriteSelect workspaceSet or clear the active workspace — the one all subsequent MCP operations bill against and read from (generations, balance, transactions, uploads, custom references). Approval by default
WriteShorts studio createStart a Shorts Studio short: restyle one uploaded source video (4s–120s) into a set of AI-generated short-form clips using a style preset. Approval by default
WriteShorts studio create presetCreate a user-owned Shorts Studio style preset from reference media (videos + images). Approval by default
WriteShow plans and creditsOpen the single combined pricing widget for everything billing-related. Approval by default
WriteShow reference elementsElements widget — reusable characters / environments / props per workspace. Approval by default
WriteSync agentsSync Agents — imports the user's user-authored Skills and a personality dump from the current host LLM into Higgsfield. Approval by default
WriteTiktok connectStart connecting the user's TikTok account. Approval by default
WriteTiktok prepare publishStep 1 of publishing to TikTok. Approval by default
WriteTiktok publishStep 2 of publishing. Approval by default
WriteTiktok reconnectRe-run the TikTok OAuth for an existing connector in `error` status (expired/revoked access). Approval by default
WriteUpscale imageUpscale and enhance an existing image. Approval by default
WriteUpscale videoUpscale and enhance an existing video. Approval by default
WriteVideo analysis createStart a scene-by-scene analysis of a video. Approval by default
WriteVirality predictorVirality Predictor predicts a video's virality potential, engagement, attention, audience response, retention risk, hook strength, and creative performance with an interactive dashboard. Approval by default
WriteVoice changeReplace the spoken voice in a video with a different voice while keeping the original timing and visuals, then re-merge the new audio onto the video. Approval by default
WriteWebsite repo accessGet direct git access to a website's repo to edit it — THE way to get the website's code. Approval by default
WriteWebsite secretsManage a website's SECRETS (environment variables: API keys, tokens). Approval by default
One prompt, start to finish
What a governed Higgsfield MCP run looks like inside Luumen.
Questions
How does LuumenAI connect to Higgsfield MCP?
Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Can LuumenAI change things in Higgsfield MCP on its own?
Read actions answer immediately. Anything that writes — apps invoke, cancel trial auto renewal, confirm billing purchase, confirm trial cancel, and more — is shown as a plan and requires approval by default, including the 5 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
Who gets access to the integration?
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Is there an audit trail?
Every call to Higgsfield MCP — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.