Skip to content

Higgsfield MCP guide for Claude, ChatGPT, setup and credits

Set up Higgsfield MCP with the official server URL, Claude and ChatGPT connection paths, credit rules, troubleshooting and a downloadable first-test brief.

Higgsfield MCP guide cover with a cinema camera and sunset storyboard prints on a cobalt-lit production desk

Higgsfield official setup Independent setup and workflow guide by Clout

Looking for the connector? Open the official Higgsfield MCP setup page. The remote server address is below. This guide helps you choose the right connection, check it before spending credits, and finish one useful creative test. Clout is a separate creative platform.

https://mcp.higgsfield.ai/mcp

What is Higgsfield MCP

MCP means Model Context Protocol: a way for an assistant to call external tools. Higgsfield’s explanation describes generation, reusable characters, audio and access to past assets. The assistant supplies the conversation; Higgsfield supplies the connected creative operations. A connector is not itself an image or video model.

The useful difference is where you direct the work. A conversation can hold your creative brief, reference choices and revisions together. It still needs an actual tool call to retrieve an account or submit a job. An assistant saying that it made a video is not enough: inspect the returned job and file.

Original editorial concept of a glass conversation bubble connected to three cinematic scenes
Independent conceptual artwork, not a Higgsfield result or interface

Choose the connection for your assistant

Where you workOfficial starting pointWhat to check
Claude web or DesktopCustom connector with the server URLThe intended account is authorized
ChatGPTHiggsfield plugin linked from its official MCP pageThe plugin is available and enabled in your account
CursorHiggsfield marketplace entrySign-in completes in the selected workspace
Coding agentsOfficial CLI and companion skillsUse the CLI setup rather than copying a web connector recipe
Another MCP clientRemote server URL in the client settingsThe client supports the server’s authorization flow

These routes follow Higgsfield’s current connection guide, which requires an active paid subscription. Client access is a separate requirement. A paid assistant account does not purchase Higgsfield access, and a Higgsfield subscription does not enable a missing client feature.

Connect Higgsfield MCP to Claude

Claude’s custom connector instructions currently use Customize → Connectors. Higgsfield’s help uses Settings → Connectors. Locate the connector screen in your version of the client.

  1. Add a custom connector and name it Higgsfield.
  2. Enter https://mcp.higgsfield.ai/mcp.
  3. Review the detected authentication and complete the provider’s sign-in.
  4. Enable the connector in the conversation.
  5. Run the read-only check below before requesting media.

Claude documents custom connectors across Free, Pro, Max, Team and Enterprise, with one custom connector on Free. Organization owners or other authorized administrators configure team access before members connect. Check that setup if the option is absent. Keep provider sign-in in the authorization window; do not paste a password into the creative brief.

Use ChatGPT or a coding agent

For ChatGPT, follow the Add Higgsfield link on the official MCP page and complete its plugin connection. Do not substitute the Clout endpoint or an API base URL. Product names, available tools and client permissions should match the service you intend to use.

For a terminal workflow, Higgsfield publishes a CLI and skills route. Its MCP page currently gives these commands:

npm i -g @higgsfield/cli
higgsfield auth login
npx skills add higgsfield-ai/skills

These install software and complete browser sign-in; they are instructions for your own environment, not commands this article runs. The official CLI guide distinguishes companion skills from skills inside Supercomputer. Use our CLI and Hermes walkthrough for that separate workflow. You do not need to install both routes just to test one connection.

Verify the connection without generating media

Use Higgsfield to look up my credit balance and recent generations. Do not create, edit, upscale or publish anything. Show the returned information. If the connector is unavailable or a lookup fails, report the error rather than guessing.

This is an original diagnostic prompt. Check the actual tool result and intended account before proceeding. If the assistant only writes an explanation without invoking a tool, the connection has not been demonstrated. A read-only lookup isolates account access from model selection, reference preparation and media generation.

Our October 29 public endpoint check returned 401 Unauthorized and an OAuth discovery challenge. That confirms an unauthenticated request was challenged, not that a user session works. It does not establish your entitlement, available operations or a successful generation. We did not connect an account for this update.

Authored diagram separating connect and account lookup from quote approval generation and output review
Original workflow diagram, not a provider interface or a completed generation

Is Higgsfield MCP free with Claude

A Claude Free connector allowance does not pay for Higgsfield access or generations. Higgsfield documents a paid subscription requirement for the connection. Compare both accounts separately; see our Higgsfield free-access guide for the web distinction.

How much does Higgsfield MCP cost

Higgsfield states that MCP generations spend credits. Web Unlimited access and free web generations do not extend to connected-agent generation. Ask for the selected operation, settings and charge each time; do not use a web promotion as your agent budget.

Check Higgsfield’s current plans and our pricing guide for the account decision. This page does not quote a single universal generation price.

Write an approval rule in the brief: one proposed output, no batch expansion, and no further generation until the result is reviewed. Treat a prompt budget as an instruction, not an enforced account limit. Check actual usage after the attempt. If the charge cannot be established, resolve that uncertainty before proceeding.

Track production cost against accepted work. In a hypothetical experiment, three completed attempts costing twelve credits in total with one accepted image means twelve credits per accepted image, before editing. Those are invented numbers to explain the arithmetic, not a Higgsfield rate or observed success rate. Use your own charged spend and include rejected paid attempts.

Run one useful first creative test

Start with one deliverable that is easy to judge. For an original orange ceramic cup campaign, the first question might be whether the approved cup silhouette and handle survive a new setting. A short still-image experiment answers that before you commit to motion, speech or a multi-scene edit.

Draft one vertical still of my approved orange ceramic cup on a pale kitchen table beside a folded cream cloth. Keep the cup’s handle, silhouette and color from the reference. Use soft window light and leave clear space above the cup. First identify the selected reference, proposed model, output settings and charge. Wait for my approval before generating. Do not create variations automatically.

This is a proposed brief, not an executed request or a model-specific schema. It names the fixed object, allowed scene change and acceptance criteria. Adapt those details to a reference you own. Exact product lettering, delicate handles and contact with a surface deserve inspection even when the overall image looks attractive.

Download the setup and first-test brief and blank review worksheet. Record your actual account check, reference, proposal, job identifier and acceptance decision. The files contain no credentials or prefilled results.

Give every reference one clear role

Name the input by its job: character identity, product geometry, setting or motion. An attractive lifestyle picture may explain lighting while obscuring the item you need to preserve. Keep the accepted reference separate from a rejected generated image so the next attempt starts from the intended source.

Higgsfield documents a provider upload window for local references. Confirm the uploaded or saved asset before submission. A file attached to a conversation is not, by itself, proof that the generation tool received it.

For a creator campaign, review the person and product separately. Face shape, hair and wardrobe belong to the identity check. Handle shape, color and contact belong to the cup check. If the still fails either, name that defect before moving on. Our character consistency exercise provides a visual comparison framework.

Troubleshoot the stage that failed

SymptomFirst diagnosticEvidence to keep
No connector optionCheck client and organization accessClient version and account type
Connected badge but no tool callEnable it in a fresh conversation and request only the account lookupThe returned lookup or exact error
Authorization errorFollow the provider’s reconnect flowFailure stage without tokens or passwords
Missing referenceInspect the provider upload or saved assetReference identifier and intended role
No output after submissionInspect the existing job and usage before another attemptJob identifier and submission time
File exists but picture is wrongReview the brief against the exported mediaThe failing frame or instruction

This is a diagnostic order, not a claim that every error has one cause. A network failure, expired connection and failed creative instruction require different fixes. Change one condition at a time. If a job was already accepted, inspect that job before submitting a replacement; a local timeout does not prove the remote work stopped.

For broader service problems, use the Higgsfield troubleshooting guide. If a downloaded clip plays outside the editor but not inside it, use the editor preview diagnosis. Neither problem is solved by repeatedly adding the same connector.

Compare MCP with the API and Clout

The official API explanation describes a separate developer product with an API key and a US dollar balance. MCP and CLI use the creator account’s credits. Choose the API when building generation into your own application; choose an agent connection when directing work in a conversation. Follow the API integration guide for request lifecycle and storage decisions.

If your aim is to reuse Clout characters, products and media in an assistant, use Clout MCP. Its server is https://app.tryclout.ai/api/mcp, a separate service and account. This guide does not claim that Clout runs Higgsfield’s connector or shares its plans, model catalog or credits.

Choose by the assets and operations the project needs. Plan a brief, identify the right inputs, inspect the quote, review the complete file, then decide whether to expand. Continue with Content Factory for faceless episodes or Katana for reference-led editing when that is the next task. To use your own Clout workspace, sign in to Clout.

Sources and testing

Independent guide published by Clout. Official Higgsfield and Claude documentation checked October 29, 2026. A public unauthenticated endpoint check returned HTTP 401 with OAuth discovery metadata. No account was connected and no paid generation was run for this update. The cover is independently generated editorial artwork, the connection map is an authored diagram, and the prompts and worksheets are original planning aids. Client interfaces and account access can change.

Questions, answered

Frequently asked questions

How do I connect Claude to Higgsfield MCP

Add the official remote URL as a custom connector, authorize the intended account, enable it in the conversation and verify a read-only lookup before generating.

Is Higgsfield MCP free with Claude

A free Claude connector allowance does not cover Higgsfield access. Higgsfield documents an active paid subscription requirement, with credits charged for media generations.

How much is Higgsfield MCP

There is no single generation price quoted here. Check the current subscription and the selected action’s model, settings and credit charge before approving a job.

What is the Higgsfield MCP server URL

The official remote server is https://mcp.higgsfield.ai/mcp. Start from Higgsfield’s own setup page and authorize the intended account.

Does Higgsfield MCP need an API key

The MCP connection uses OAuth. API keys belong to the separate Higgsfield API product.

Is Higgsfield MCP generation free

MCP generations use plan credits. Web Unlimited access and free web generations do not carry over to connected-agent generation.

How do I use Higgsfield with ChatGPT

Follow the Higgsfield plugin link on the official MCP page, complete sign-in and check that it is enabled for your conversation.

Why does the endpoint show Unauthorized in a browser

An unauthenticated endpoint request is not an authorized MCP session. Use your client’s connection flow; the public endpoint check alone does not test your account.

Does a successful lookup prove generation will work

No. It verifies account access for that lookup. Reference selection, job submission and the finished media need their own checks.

Are Clout MCP and Higgsfield MCP the same service

No. They have different endpoints, accounts and credit balances. Use the connection belonging to the workspace you intend to create in.