Higgsfield MCP in Claude: Setup, Real Costs, No Unlimited

Higgsfield MCP lets Claude make images and videos on your Higgsfield account: add one URL, sign in once, and Claude gets Higgsfield's tools. We connected it to Claude Code on a paid Plus plan. Three jobs cost 5.5 credits, about 0.27 USD, and every quote matched the charge. The catch: Higgsfield's "unlimited" generations did not work from Claude Code, so every job was paid in credits.

Measured on 11 Nov 2026 between 07:09 and 07:12 Vietnam time, from Claude Code on a Windows 11 PC (WSL), on the Higgsfield Plus plan we pay for. Higgsfield's MCP page, its help page on how credits work and its terms (last updated 23 Oct 2026) were read the same morning.

At a glance

Key results

• Setup takes one command in Claude Code. The server URL is https://mcp.higgsfield.ai/mcp. Sign-in is OAuth in the browser; there is no API key to paste.
• 150 Higgsfield tools appeared in our session. They cover image, video, audio, 3D, projects, websites and TikTok publishing, plus balance and transactions for checking spend.
• The quote matched the bill. get_cost said 0.25 credits for a GPT Image 2.6 image and 5 for a 5-second Seedance 2.0 Mini clip. The ledger charged exactly that. Quotes themselves cost nothing.
• An image took about 17 seconds, a 5-second clip about 80. The clip came back at 1280x720, 5.09 seconds, and matched the prompt.
• "Unlimited" was refused in Claude Code, at no charge. The Unlimited and free generations that come with paid plans apply only on higgsfield.ai; Higgsfield's MCP help page says plainly that "MCP always uses credits." The separate Unlimited MCP trial, the server told us, works only in Claude chat, Claude Cowork and ChatGPT.
• Total spend: 5.5 credits. The balance went from 573.75 to 568.25. At Plus pricing (49 USD for 1,000 credits a month) that is about 0.27 USD.

Hands-on test

Setup

• Account: Higgsfield Plus, monthly billing, 49 USD. Ours started as an MCP trial: the plan data the connection returns lists the trial as 100 credits, ended 3 Oct 2026, status "converted". It turned into the paid plan after that.
• Client: Claude Code, which ran the test itself, on Windows 11 with WSL. We did not test claude.ai or ChatGPT.
• Calls: balance, then get_cost quotes, then one image (GPT Image 2.6, default quality, 16:9), one 5-second 16:9 video (Seedance 2.0 Mini), one image with use_unlim set to true, then transactions and balance again.
• Timing: from the charge time in the ledger to the result file's timestamp. This is server time, not the time Claude spent waiting.

How to connect Higgsfield MCP to Claude

Claude Code. Run this in a terminal:

claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp

Then open Claude Code, type /mcp, pick higgsfield and finish the sign-in that opens in your browser. --scope user makes the tools available in every project on your machine. Leave it out to add the server to the current project only. The syntax is from the Claude Code MCP docs. Higgsfield's own Claude Code tab suggests a different route, its CLI plus companion skills. We used the plain MCP server because it needs no extra install.

Claude on the web or desktop. Higgsfield's MCP page gives the steps: "Open Customize → Connectors, add a custom connector named Higgsfield, paste the URL, and sign in." Use the same URL.

Check it works. Ask Claude to call balance. If it returns your credits and plan, the connection is live.

What one run really costs

We also asked for quotes we did not run. A 5-second Kling 3.0 clip was quoted 10 credits, a 5-second Seedance 2.5 clip 35, and a Nano Banana 2 image 1.5. These match what we were charged in our Higgsfield pricing test on 2 Nov, so prices had not moved in nine days.

To turn credits into dollars, divide by your plan. Plus is 49 USD for 1,000 credits, or 4.9 cents a credit. If you run out mid-month, the top-up packs the connection showed us cost more per credit. 500 credits are 29.41 USD (5.9 cents each) and 4,000 are 210.53 USD (5.3 cents each). Top-up credits expire after 90 days. Plan credits do not roll over at all.

Why "unlimited" did not apply

Higgsfield sells three kinds of free generation, and none of them worked in our Claude Code session.

• Plan Unlimited and free generations. Every unlimited item in the plan data the connection returned says "Available on web". The help page says the same in plain words: these apply only on higgsfield.ai, and "any generation made outside it, including through MCP, CLI, Canvas, Supercomputer, and other automated tools, always deducts credits, regardless of plan."
• The Unlimited MCP trial. Higgsfield's launch post (28 Jul 2026) says the trial works on the web and "directly inside Claude or ChatGPT through MCP", one generation at a time.
• Claude Code is not on that list. When we set use_unlim to true, the server answered: "Unlimited generations are not available in the app you are using. They are available in: Claude chat, Claude Cowork, ChatGPT." Nothing was charged.

So if you plan to lean on unlimited image models, do that on the website. Use Claude Code for jobs you are happy to pay for in credits.

What worked

What worked

• The quote tool. Every job cost exactly what get_cost said. Ask Claude to quote before each run.
• The ledger. transactions lists every charge with a model name and a timestamp, so you can check an agent's spend after a long session.
• Waiting for jobs. jobs_wait polls up to 15 seconds per call. Claude called it again until the clip was done, with no prompting from us.
• Text in images. The Vietnamese prompt came back with the sign text spelled correctly, accents included.

Where it fell short

What didn't work

• Unlimited generation, as above. The refusal was clean and free, but it means no free path from Claude Code.
• Higgsfield's own Claude Code steps point to the CLI, not the MCP server we used. If you follow its page, you install different things.
• The model added things we did not ask for. In the Vietnamese test it placed a national flag and a landmark tower in the scene. Read every result before you use it.
• Agent spend is on you. Section 11.12 of the terms makes you "solely responsible" for actions an agent takes with your credentials. Claude will happily queue paid jobs, and a Seedance 2.5 clip costs 35 credits.

Our verdict

Connect Higgsfield MCP to Claude if you already pay for a Higgsfield plan and want images or short clips without leaving your chat or terminal. It takes two minutes, the quotes are honest, and the ledger lets you audit every call. Do not connect it to save money. From Claude Code every generation is charged, and the unlimited offers stay on the website or the Claude chat trial. Start with cheap models (0.25 credits an image, 5 a clip), ask for a quote first, and check transactions at the end of a session. If you want to try it, Higgsfield is here. This is an affiliate link: we may earn a commission if you subscribe, at no extra cost to you.

FAQ

Does Higgsfield MCP need an API key?

No. It connects to your existing Higgsfield account through a browser sign-in and spends your plan credits. The separate Higgsfield API is for building generation into your own product.

Is Higgsfield MCP free?

Connecting is free, but generating is not. On paid plans every image and video made through MCP is charged in credits. In our test that was 0.25 credits an image and 5 credits a 5-second Seedance 2.0 Mini clip.

Can I use Higgsfield Unlimited through Claude Code?

Not in our test. The server refused use_unlim in Claude Code and named Claude chat, Claude Cowork and ChatGPT as the apps where its unlimited generations work. Plan Unlimited applies only on higgsfield.ai.

Claude, the AI assistant, ran the calls and wrote this page. The figures come from Higgsfield's own ledger, and each vendor claim was checked against the pages linked above. For which video model to pick, see our image-to-video test.