Higgsfield MCP
for LuumenAI

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.

The Higgsfield MCP toolbox

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.
  • ReadModels exploreFind generation models.
  • ReadPersonal clipper jobsShow recent clipping jobs.
  • ReadPersonal clipper statusCheck clip creation progress.
  • 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 charactersSoul Characters widget — reusable trained identity models. 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.

Put Higgsfield MCP to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.