SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Higgsfield MCP with Hermes

Connect Hermes to Higgsfield MCP. Generate a photorealistic hero character portrait, create a 30-second product video with voiceover, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Higgsfield MCP logoHiggsfield MCP
Dcr Oauth

Higgsfield MCP is a creative media platform for generating images, videos, characters, and audio. Use it to produce authorized assets, reuse prior creations, and monitor credit balances.

101 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Higgsfield account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Higgsfield MCP with

ChatGPTClaude CoworkAtomic Agent

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Higgsfield with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Higgsfield

Ask your agent to connect to Higgsfield, or simply request any Higgsfield-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Higgsfield connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Higgsfield or request any Higgsfield-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Higgsfield MCP server, and what's possible with it?

The Higgsfield MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Higgsfield account. It provides structured and secure access to your creative tools, media, generation history, websites, and credit balance, so your agent can generate visual and audio content, dub videos, create 3D meshes, deploy websites, and inspect past creations on your behalf.

  • Image and video generation: Have your agent generate individual images or videos, submit batches of up to 12 requests, and wait for the results.
  • Speech and video dubbing: Direct your agent to create speech with available voices or translate spoken video audio into another language with lip synchronization.
  • Media and 3D creation: Let the agent upload or import images, videos, and audio for creative tasks, or generate a single 3D mesh.
  • Generation tracking and reuse: Instruct your agent to check active generation jobs and display a specific creation from your generation history.
  • Website creation and account insights: Have your agent create and deploy websites, list your existing sites and workspaces, or check your available credits and subscription plan.

Way Forward

With Higgsfield connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Higgsfield MCP action and event your agent gets out of the box.

Animation actions

Read-only catalog of the 3D rig animation library (678 actions: locomotion, gestures, dancing, combat, daily actions).

Apps describe

Get 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.

Apps invoke

Run one described action on a Marketplace app AS the current user.

Apps search

Search Higgsfield Marketplace apps callable through MCP.

Balance

Get the user's available credits and current subscription plan.

Cancel trial auto renewal

Cancel the auto-renewal of the Higgsfield MCP free trial.

Confirm billing purchase

INTERNAL — invoked ONLY by the plans widget on an explicit user Confirm click.

Confirm trial cancel

INTERNAL — invoked ONLY by the cancel-trial confirmation widget on an explicit user click of 'Cancel auto-renewal'.

Create voice

Open the Create Voice Apps UI.

Create voice from confirmed audio

Backend-only creation of a cloned voice from an already confirmed audio upload.

Create website

Start a new full-stack website.

Deploy website

Build and deploy the website via CI, then return its live URL.

Dubbing

Dub a video into another language: translate the spoken audio, synthesize it in the target language, and lip-sync the result back onto the video.

Generate 3d

Generate a 3D GLB mesh.

Generate audio

Generate one speech/voice request (text-to-speech) and render it in the generation widget.

Generate audio batch

Submit 1-12 independent audio generations in parallel without opening a widget.

Generate image

Generate one image request and render its result(s) in the generation widget.

Generate image batch

Submit 1-12 independent image generations in parallel without opening a widget.

Generate video

Generate one direct video request and render it in the generation widget.

Generate video batch

Submit 1-12 independent video generations in parallel without opening a widget.

Get explainer presets

Show the explainer video style presets (CMS-managed catalog).

Get workflow bundle file

Read a safe text file or directory from a workflow's resource folder.

Get workflow instructions

Ad 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 regenerate the same ad with different people or products.

Job display

Show one specific previous generation in the single-result UI widget by job ID.

Job status

Check the status and results of an async job.

Jobs wait

Long-poll 1-12 generation jobs together without opening a widget.

List voices

List available voices for speech and voice tools.

List website categories

List the content categories a website can be filed under — each with a slug, label, description, and display position.

List websites

List the websites you own — each with its id, name, slug, and live URL.

List workspaces

List every workspace the user can access (their private workspace plus any shared/team workspaces).

Marketing studio v2 avatars

Widget-internal: list the user's Marketing Studio avatars (preset and custom) for the avatar picker.

Marketing studio v2 costs

Widget-internal: the Marketing Studio v2 pricing document.

Marketing studio v2 create

Widget-internal: recreate a Marketing Studio v2 preset — validates inputs against the preset's recreate contract and submits one generation.

Marketing studio v2 presets

Widget-internal: load a page of the Marketing Studio v2 preset feed for a category.

Marketing studio v2 status

Widget-internal: poll status and results of submitted Marketing Studio v2 jobs.

Media confirm

Confirm file uploads after using media_upload's upload_url method.

Media import url

Import an HTTPS image, video, or audio URL into Higgsfield storage and return a confirmed media_id.

Media upload

Upload media for use in generation, or general files (documents, archives, code) for sharing.

Media upload widget

Required local-media intake for Higgsfield in Apps UI-capable clients.

Models explore

Find generation models.

Motion control

Animate an existing character image with the motion and camera movement from a reference video using Kling 3.

Outpaint image

Expand or uncrop an existing image by outpainting beyond the original frame while preserving the source content.

Participate in contest

Enter the website in the current Higgsfield app contest, together with the social-media links promoting it.

Personal clipper create

Turn YouTube videos into ready-to-share clips.

Personal clipper jobs

Show recent clipping jobs.

Personal clipper status

Check clip creation progress.

Presets show

Show available Higgsfield presets for image-to-video generation.

Publish website

Publish the website: lists the website's CURRENT LIVE production deploy on the Higgsfield community feed ('show in feed'), where other users can discover it.

Reframe

Expand or reframe an existing video to a new aspect ratio while preserving the source content.

Remove background

Remove or cut out the background from an existing image or video.

Rename website

Rename the website's SUBDOMAIN (the slug in its public URL).

Resolve explainer preset

Resolve 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.

Reveal generation

Confirm the user has rights to the content of an `ip_detected` generation and flip its status to `completed`.

Sandbox exec

Execute a shell command in a remote Higgsfield cloud Linux sandbox — NOT your local machine or the client's own shell.

Scene builder 3d create project

Create a new private 3D Jutsu project for the authenticated user.

Scene builder 3d get artifact

Resolve a short-lived download for an image or video that a successful Python operation published through `artifacts`.

Scene builder 3d get blend

Resolve a short-lived download for the current committed editable Blender file, or a specified historical revision.

Scene builder 3d get glb

For an interactive scene preview use `scene_builder_3d_show_scene`.

Scene builder 3d get operation

Read or wait for a submitted Python operation in this project.

Scene builder 3d get project

Read a 3D Jutsu project's current revision, scene sequence, active operation, and committed artifacts.

Scene builder 3d import asset

Import a confirmed catalog GLB from `scene_builder_3d_search_assets` into the selected project as a collaborative scene entity.

Scene builder 3d list projects

Discover the authenticated user's 3D Jutsu projects before choosing a scene to read or edit.

Scene builder 3d query python

Inspect the latest settled Blender scene without committing changes.

Scene builder 3d run 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`.

Scene builder 3d search assets

Search the curated GLB model catalog available to 3D Jutsu.

Scene builder 3d show scene

Show 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.

Select workspace

Set or clear the active workspace — the one all subsequent MCP operations bill against and read from (generations, balance, transactions, uploads, custom references).

Shorts studio create

Start a Shorts Studio short: restyle one uploaded source video (4s–120s) into a set of AI-generated short-form clips using a style preset.

Shorts studio create preset

Create a user-owned Shorts Studio style preset from reference media (videos + images).

Shorts studio list presets

Browse Shorts Studio style presets — the visual STYLE a short is restyled toward.

Shorts studio list sessions

List the caller's past Shorts Studio sessions (newest first) to find a session_id to poll with shorts_studio_status.

Shorts studio status

Poll one Shorts Studio session.

Show characters

Soul Characters widget — reusable trained identity models.

Show generation by ids

Render exactly 1-60 requested generation jobs in the full-profile gallery widget, ordered by index and paginated locally in groups of 12.

Show generations

Browse completed non-Marketing Studio generation history and render one paginated page in the gallery widget.

Show marketing studio generations

Browse past completed Marketing Studio generations only.

Show marketing studio v2

Open 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 their own product image.

Show medias

List your uploaded media files by type.

Show plans and credits

Open the single combined pricing widget for everything billing-related.

Show reference elements

Elements widget — reusable characters / environments / props per workspace.

Sync agents

Sync Agents — imports the user's user-authored Skills and a personality dump from the current host LLM into Higgsfield.

Tiktok accounts

List the user's connected TikTok accounts.

Tiktok connect

Start connecting the user's TikTok account.

Tiktok music trending

List trending commercially licensed tracks from TikTok's Commercial Music Library for the connected account.

Tiktok music tune

Open 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.

Tiktok prepare publish

Step 1 of publishing to TikTok.

Tiktok publish

Step 2 of publishing.

Tiktok publish status

Step 3 of publishing.

Tiktok reconnect

Re-run the TikTok OAuth for an existing connector in `error` status (expired/revoked access).

Transactions

List the user's credit transactions (spend/refund/grant/deduct), newest first.

Upscale image

Upscale and enhance an existing image.

Upscale video

Upscale and enhance an existing video.

Video analysis create

Start a scene-by-scene analysis of a video.

Video analysis jobs

List the user's video analyses in the current workspace, newest first.

Video analysis status

Get the status and result of a video analysis.

Virality predictor

Virality Predictor predicts a video's virality potential, engagement, attention, audience response, retention risk, hook strength, and creative performance with an interactive dashboard.

Voice change

Replace 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.

Website db

Inspect the website's database (D1 / SQLite), READ-ONLY.

Website repo access

Get direct git access to a website's repo to edit it — THE way to get the website's code.

Website secrets

Manage a website's SECRETS (environment variables: API keys, tokens).

Website status

Get the website's deploy status — the live URL and the status of the last deploy.

FRAMEWORKS

How to build Higgsfield MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Higgsfield MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Higgsfield MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Higgsfield MCP with Atomic Agent

FAQ

Frequently asked questions

With a standalone Higgsfield MCP server, the agents and LLMs can only access a fixed set of Higgsfield tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Higgsfield and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Higgsfield tools.

Yes, absolutely. You can configure which Higgsfield scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Higgsfield data and credentials are handled as safely as possible.

Start with Higgsfield MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Higgsfield MCP tool your agent needs.Free to start.

Start building