Higgsfield MCP: Full Setup + Don't-Burn-Credits System

Paul Written by Paul Last updated: Jun 15, 2026 MCP

Here's the pattern almost everyone hits. You wire Higgsfield into Claude, the first image lands in 15 seconds, it looks good, and you keep going. Another image. A video. A re-render because the first video was silent. Forty minutes later you check your balance and you've burned a third of your monthly credits on stuff you'll never use.

Higgsfield's MCP connector is the fastest creative pipeline I've used inside an LLM chat. It's also the easiest way to torch credits if you generate first and think second. This guide is the full setup plus the system I run to stop that: every model family the connector exposes, the one permission setting that saves money while you learn, and a draft-pass-first habit backed by real credit math from a live session.

If you just want the connect-and-test version, the quick path is its own walkthrough.

For the fast version, read how to connect Higgsfield to Claude. This post is the deeper one: it assumes you're connected and asking how to actually run it without bleeding credits.

TL;DR

  • Higgsfield shipped its MCP connector on 30 April 2026. It lets Claude generate images and video in-chat across 30+ models (Soul, Nano Banana, Seedance, Kling, Veo, Hailuo, Wan, Cinema Studio, Marketing Studio).
  • Claude Code one-liner: claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp (browser OAuth, no API keys).
  • Set tool calls to confirm-first, not auto-confirm, while you learn. Every generation costs credits; the confirm prompt is your brake.
  • Real math: on Higgsfield Plus, 5 images plus 2 videos cost about 53 credits (787.75 down to 734.98). Roughly 7-8 credits a still, more for video. Budget a session before you start.
  • Draft-pass-first is the whole system: low-res or short clip first, full render only once the composition is right. Let Claude check your balance and pick a cheaper model mid-chat.

What the connector actually is

It's a bridge. Higgsfield runs the models on their side. The MCP connector exposes those models to Claude as tools, so you describe what you want in plain language and Claude calls the right generation tool, polls the job, and drops the result back into the chat. No API keys in your config, no SDK. Auth is browser OAuth, one time.

That's the part that makes it dangerous for your balance. There's no upload step, no render queue you babysit, no separate app. You type a sentence and a paid job fires. The friction that normally makes you pause is gone, which is exactly why you need a system.

The model landscape: 30+ models, what each is for

You don't pick models by name in practice. You describe the output and Claude maps it to a model. But knowing the families helps you steer, and steering toward cheaper models is half the credit game. Ask Claude to list available models any time and it'll pull the current set; here's the shape of it as of June 2026.

Image models

  • Nano Banana (nano_banana_2): the workhorse. Fast, cheap, renders legible text in-image. I used it for a product ad, an infographic, and a photoreal dog. Default to this unless you need something it can't do.
  • Soul (text2image_soul_v2): portrait and creator-style realism. Stronger on faces and skin than the workhorse. Use it for UGC-style people shots, 9:16.
  • Z-Image (z_image): fast and cheap, leans illustrative and stylized. Good for icons, hero art, anything where photoreal isn't the point. The robot image at the top of this post came from it.

Video models

First, the finding that trips people up: Higgsfield video is image-to-video. There is no text-only video path. You generate a still first, then animate it. Claude handles the chain for you, but it means a video is always at least two jobs, which is two charges.

  • Veo (veo3_1, the veo-3-1-fast variant): talking-head and dialogue clips with generated audio. I used it for a 4-second creator clip with synced speech.
  • Seedance (seedance_2_0): motion-heavy real-world clips with audio. My 5-second dog-running shot came from it.
  • Kling, Hailuo, Wan (e.g. wan2_6): the rest of the animation field. Wan handled a silent animated-robot clip cleanly. Kling and Hailuo cover stylized and cinematic motion. Different models, different cost and look; ask Claude to compare two before you commit.

Studio modes

  • Cinema Studio: longer-form, more controlled cinematic sequences.
  • Marketing Studio: ad and campaign-oriented templates and outputs.

You won't touch the studios for a first session. They're there when you graduate from one-off assets to repeatable campaign output. For learning the connector, stay on the single image and video models where the cost per job is small and the feedback loop is tight.

The setting that saves money: confirm-first, not auto-confirm

When the connector calls a generation tool, Claude asks for permission. You can approve once, approve for the session, or set the tool to always allow. Auto-confirm (always allow) feels efficient. It isn't, not while you're learning.

Every generation is a paid job. The confirm prompt is the only thing standing between a half-formed prompt and a charge. Keep it on confirm-first. You'll catch the cases where Claude is about to fire a 4-second video when you meant a still, or render at 4k when 1k was fine. The two seconds it takes to read the prompt and approve is the cheapest insurance there is.

Flip individual safe tools to always-allow once you trust them. Balance checks, model lists, listing your past generations, none of those cost credits, so let them run free. The brake belongs on the tools that spend: image, video, audio, upscale.

One quirk: the always-allow prompt fires per tool, not once for the whole connector. So you'll approve the balance tool, then the image tool, then video separately. That's fine. Approve the read-only ones, leave the spenders on manual.

The don't-burn-credits system

This is the part the viral tutorials wave at and never actually give you. Here it is as a workflow I ran in a live session, with the real numbers.

1. Budget the session before you generate

Open with a balance check. Ask Claude what your balance is and it'll call the read-only balance tool. I started a session at 787.75 credits on Higgsfield Plus. Then decide what the session is worth. If you're prototyping, cap it. "I want to spend no more than 60 credits exploring three ad concepts" is a real instruction Claude can work within, checking the balance as it goes.

PortableText [components.type] is missing "image"

2. Draft-pass first, full render last

Never render the final thing first. Generate a low-resolution still or a short clip to lock the composition, the framing, the subject. Only when that draft is right do you spend on the full-resolution or longer version. A 1k image costs a fraction of a 4k one. A 4-second clip costs a fraction of a 10-second one. You iterate on the cheap pass and pay for quality once.

In practice that means telling Claude the plan up front: "Draft this at 1k first, I'll tell you when to go full." It'll hold the cheap pass until you approve the expensive one. This single habit is the difference between a controlled session and an afternoon gone.

3. Let Claude pick the cheaper model

Mid-chat, ask. "Is there a cheaper model that gets me close to this?" Claude can compare and recommend. For a stylized image, Z-Image instead of a photoreal model. For a quick motion test, the fast Veo variant instead of the full one. The model you reach for by default is rarely the cheapest one that does the job.

4. Pick the resolution and duration that fits the use

  • 1k over 2k over 4k unless the asset is going somewhere that needs the pixels. Most social and web placements don't.
  • Shortest duration that tells the story. A 4-second clip reads as motion just fine; 10 seconds is four jobs' worth of credits if you're iterating.
  • Right aspect ratio the first time. Re-rendering because you generated 16:9 and needed 9:16 is a full charge for a framing mistake.

What it actually cost

Real numbers from one sitting on Higgsfield Plus. I started at 787.75 credits. After 5 images and 2 videos I was at 734.98. That's about 53 credits for 7 assets, so roughly 7-8 credits per still image, and a bit more for the short video clips at these durations and resolutions.

Run that math forward and the budgeting gets concrete. If a still is ~7-8 credits, an exploration session of a dozen draft images is under 100 credits. Where it gets expensive is video iteration: every video is the image job plus the animation job, and if you re-roll for a silent-audio failure you pay again. Budget video generously, stills lightly.

Troubleshooting the real errors

External image URLs throw a hosting error

If you hand Claude an external image URL to animate or reference, the import can fail with a hosting or egress error. The fix is to keep the image inside the flow: generate it through the connector, or upload it through the connector's upload step, then animate that. Pasting a raw third-party URL is the least reliable path. Generate or upload, then reference the result.

A video comes back silent

Generated audio sometimes fails and you get a silent clip on a model that should have sound. There's no clever fix: re-run it. Annoying because the re-run is a fresh charge, which is one more reason to confirm the rest of the composition on a cheap pass before you add the audio-bearing full render.

Always-allow prompts keep firing

If you're getting a permission prompt on every single call, the connector is set to ask each time. That's the safe default and I'd keep it for the spending tools. If the read-only tools (balance, model list, generation history) are nagging you, set those specific tools to always-allow in the connector settings. Per-tool, not all-or-nothing.

Claude Code path

On Claude Code the setup is one command. No connector UI, no pasted URL.

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

It opens a browser OAuth flow, you sign in to Higgsfield, approve, done. After that the generation tools show up in Claude Code the same as in the desktop and web apps, and the same confirm-first discipline applies. The --scope user flag makes it available across your projects rather than just the current repo.

Where this leaves you

The connector is genuinely fast and the output is good enough to ship. The risk is entirely on the credit side, and it's a behavior problem, not a tool problem. Budget the session, draft cheap, render expensive once, and keep the confirm prompt on the tools that spend. Do that and a month of credits goes a long way.

Once the setup's solid, the next reads are the hands-on guides: creating images with Claude + Higgsfield and creating videos with Claude + Higgsfield. For the verdict on whether Higgsfield is worth the subscription at all, see the full Higgsfield review.

Vibetoolstack reviews tools we'd recommend to readers building toward $10k/mo of independent income. Where an affiliate program exists and we participate, the link is marked. Where not, links are editorial. The verdict above doesn't depend on affiliate status.

Frequently asked questions

How do I add the Higgsfield MCP to Claude Code?
Run: claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp. It opens a browser OAuth flow, you sign in to Higgsfield and approve, and the generation tools appear. No API keys needed. The --scope user flag makes it available across all your projects.
Should I use auto-confirm or confirm-first for tool calls?
Confirm-first while you learn. Every image, video, and audio generation is a paid job, and the confirm prompt is your only chance to catch a mistake before it costs credits. You can set read-only tools like balance checks to always-allow, but keep the brake on anything that spends.
How many credits does a Higgsfield generation cost?
In a live session on Higgsfield Plus, 5 images plus 2 short videos cost about 53 credits (balance went from 787.75 to 734.98). That works out to roughly 7-8 credits per still image, with short video clips costing somewhat more. Confirm live, since pricing and model costs change.
How do I stop burning through Higgsfield credits?
Budget the session up front, draft at low resolution or short duration first, then render the full version only once the composition is right. Let Claude check your balance mid-chat and recommend a cheaper model. Pick 1k over 4k and the shortest duration that works.
Why does generating video need an image first?
Higgsfield video is image-to-video. There is no text-only video path, so you generate a still, then animate it. Claude chains the two steps for you, but it means every video is at least two jobs, which is two charges. Budget video more generously than stills.
Why did my external image URL throw an error?
Importing a raw external image URL can fail with a hosting or egress error. Keep the image inside the flow instead: generate it through the connector, or upload it through the connector's upload step, then animate or reference that result rather than a third-party link.