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.

Choose the connection for your assistant
| Where you work | Official starting point | What to check |
|---|---|---|
| Claude web or Desktop | Custom connector with the server URL | The intended account is authorized |
| ChatGPT | Higgsfield plugin linked from its official MCP page | The plugin is available and enabled in your account |
| Cursor | Higgsfield marketplace entry | Sign-in completes in the selected workspace |
| Coding agents | Official CLI and companion skills | Use the CLI setup rather than copying a web connector recipe |
| Another MCP client | Remote server URL in the client settings | The 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.
- Add a custom connector and name it Higgsfield.
- Enter
https://mcp.higgsfield.ai/mcp. - Review the detected authentication and complete the provider’s sign-in.
- Enable the connector in the conversation.
- 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.

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
| Symptom | First diagnostic | Evidence to keep |
|---|---|---|
| No connector option | Check client and organization access | Client version and account type |
| Connected badge but no tool call | Enable it in a fresh conversation and request only the account lookup | The returned lookup or exact error |
| Authorization error | Follow the provider’s reconnect flow | Failure stage without tokens or passwords |
| Missing reference | Inspect the provider upload or saved asset | Reference identifier and intended role |
| No output after submission | Inspect the existing job and usage before another attempt | Job identifier and submission time |
| File exists but picture is wrong | Review the brief against the exported media | The 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.



