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.

89 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

ChatGPT WorkClaude Cowork

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 so your agent can perform Higgsfield operations on your behalf.

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.

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 Work logo

ChatGPT Work

Use Higgsfield MCP with ChatGPT Work

Claude Cowork logo

Claude Cowork

Use Higgsfield MCP with Claude Cowork

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