Higgsfield MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Higgsfield MCP or direct API to generate images, create videos, build characters, and check credit balances through natural language.

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

Try Higgsfield MCP now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Higgsfield MCP
Try asking
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.

SETUP GUIDE

Connect Higgsfield MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Higgsfield MCP
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Higgsfield MCP API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Higgsfield MCP Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Higgsfield MCP actions with your Agent

Why Use Composio?

AI Native Higgsfield MCP Integration

  • Supports both Higgsfield MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for generating, reusing, and querying your Higgsfield MCP assets

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Higgsfield MCP access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Higgsfield MCP
  • Scoped, least privilege access to Higgsfield MCP resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Higgsfield MCP with any AI Agent Framework

Choose a Framework you want to connect Higgsfield MCP with

FAQ

Frequently asked questions

Yes, Higgsfield MCP requires you to configure your own Dcr Oauth credentials. Once set up, Composio handles secure credential storage and management for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

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