Higgsfield MCP & CLI
AI Video Verified- Entry paid tier Entry annual tier MCP remote auth
- $9/mo $9/mo OAuth
- Basic 120 cr (2 job concurrency) $108/yr flat for image MCP tests mcp.higgsfield.ai/mcp remote URL
- Recommended Plus Recommended annual CLI integration
- $49/mo $29/mo CLI skill
- $39 mo 1 intro, 1,000 cr (skips Unlim) Annual Plus (skips web Unlimited) npm i -g @higgsfield/cli
- Real unit cost
- 0 Unlim
- MCP always deducts paid credits
Higgsfield MCP connects Claude Desktop, Claude web, Claude Code, Cursor, and other MCP-compatible agents directly to 30+ bundled image, video, and audio engines through the hosted endpoint https://mcp.higgsfield.ai/mcp with zero manual API key management. Before running batch agent workflows, note one critical billing rule from higgsfield.ai/pricing checked on 2026-11-13: promotional Unlimited models and Free Generations do not apply on MCP/CLI, Canvas, or Supercomputer, so every agent render draws from paid subscription credits.
Check our testing methodology for how Oqerune verifies vendor billing disclosures and exclusion clauses.
How to connect Higgsfield MCP to Claude or CLI agents
Higgsfield supports two lightweight developer paths depending on whether you automate inside chat UIs or terminal coding environments. Chat-based setups use the official hosted connector, while coding agents can invoke the CLI package to reduce schema token overhead.
| Integration path | Best client environment | Setup command or URL | Auth method | Credit and Unlimited rule |
|---|---|---|---|---|
| Hosted MCP Connector | Claude Desktop, Claude web (Customize -> Connectors), Manus | https://mcp.higgsfield.ai/mcp |
Account browser / OAuth login (no manual keys) | Always spends account credits; excludes web Unlimited windows |
| Higgsfield CLI and Skills | Claude Code, Cursor, terminal agents | npm i -g @higgsfield/cli then npx skills add higgsfield-ai/skills |
higgsfield auth login |
Always spends account credits; polls status until media URL returns |
| Web Studio + Cinema Studio / Supercomputer | Browser workspace on higgsfield.ai | Direct web dashboard | Standard account session | Cinema Studio honors web plan Unlimited promos; Supercomputer excludes Unlimited |
Why Unlimited plans burn credits inside MCP, CLI, and Supercomputer
Many developers subscribe expecting the advertised “7-day or 14-day Seedance 2.5 Unlimited” or “60-day 2K image Unlimited” perks to fuel overnight Claude automation loops. Explicit fine print on higgsfield.ai/pricing (checked 2026-11-13) states that Unlimited models and Free Generations operate exclusively inside standard higgsfield.ai web flows and are excluded from MCP/CLI, Canvas, and Supercomputer.
Practically, a single automated Claude loop requesting 5 Seedance 2.5 1080p shots at ~83 credits each burns ~415 credits, exhausting over three months of the $9 Basic plan (120 credits) in a single chat session. Always double-check whether an exploratory job belongs in the web queue before turning Claude loose via MCP.
Developer sizing rule (2026-11-13): Free ($0, 0 monthly credits) cannot sustain MCP runs, and Basic ($9, 120 cr) covers only ~1 Seedance 2.5 1080p clip or ~60 Nano Banana Pro stills. Pick Plus ($39 intro / $29 annual, 1,000 cr) for prototype agents or Ultra 3K ($79 intro / $65 annual, 3,000 cr) for weekly MCP batches.
Which models can Claude call through Higgsfield MCP?
Once authenticated, Claude gains direct schema access to 30+ multi-provider video, image, and pipeline tools without juggling five separate vendor API billing portals. Supported families documented across Higgsfield’s live studio and MCP catalog include Seedance 2.5 and 2.0, Kling 3.0 and 4.0, Google Veo 3.1, Sora 2, MiniMax Hailuo, Nano Banana Pro, Seedream 5.0 and 5.5, Soul V2, FLUX.2 Pro, GPT Image, and Cinema Studio workflows.
Keep concurrency caps in mind when scripting multi-asset prompts. Basic caps at 2 concurrent video jobs (4 image jobs), Plus scales to 6 video jobs (8 image jobs), and Ultra handles 8 concurrent video, image, and lipsync jobs, meaning heavy parallel agent fan-outs queue faster on Plus or Ultra.

Pairing automated Claude MCP agents with direct video or real-time speech APIs? Check per-second API numbers in our Seedance 2.0 API guide and Cartesia Sonic 3.6 credit guide.
MCP vs web Cinema Studio vs standalone APIs
If your main goal is pure deterministic pay-as-you-go software billing at pennies per frame, metered still APIs covered in our AI image generator guide ($0.009/image on FLUX.3 Klein API) or standalone video setups in our AI video generator comparison avoid 30-day credit expiration altogether.
Where Higgsfield MCP earns its keep is cross-model creative orchestration: one agent session inside Claude can draft product stills in Seedream or Nano Banana Pro, keep persona identity steady using Soul workflows, and animate final ads with Kling or Seedance without touching manual web UIs. First-time builders can test connectivity using our Higgsfield Free tier guide and compare alternatives inside Higgsfield vs Runway vs Kling.
Higgsfield Open API pricing (open.higgsfield.ai) vs Fal.ai per-second rates
Outside of web credit subscriptions, developer teams can bill jobs purely per second or per image on the self-serve Higgsfield Open API (open.higgsfield.ai/pricing) with zero monthly seat fees. New workspaces that verify a business email and attach a payment card receive $15 in free launch balance plus 20 concurrent requests on their first API key.
Across overlapping models, official published rates on open.higgsfield.ai undercut Fal.ai by 15% to 40% per second, and queued jobs canceled via cancel_url before processing begins incur $0 charge.
| Model (Category) | Specs | Higgsfield Open API | Fal.ai benchmark | Savings vs Fal.ai |
|---|---|---|---|---|
| Seedance 2.5 (T2V / I2V) | 1080p, 5s to 10s | $0.118 / s | $0.150 / s | 21.3% lower |
| Seedance 2.5 (Ref / Edit / Extend) | 1080p, 5s to 10s | $0.139 / s | $0.190 / s | 26.8% lower |
| Seedance 2.0 (T2V / I2V) | 720p, 5s to 10s | $0.080 / s | $0.105 / s | 23.8% lower |
| Kling 3.0 Standard | 720p, 5s to 10s | $0.071 / s | $0.110 / s | 35.5% lower |
| Kling 3.0 Turbo | 720p, 5s to 10s | $0.084 / s | $0.140 / s | 40.0% lower |
| Kling 3.0 Pro | 1080p, 5s to 10s | $0.096 / s | $0.140 / s | 31.4% lower |
| Kling 3.0 4K | 4K, 5s to 10s | $0.315 / s | $0.500 / s | 37.0% lower |
| Kling 4.0 / Kling 4.0 Flash | 1080p, 5s to 10s | $0.126 / s ($0.094 Flash) | n/a direct match | Edit mode $0.063 / s |
| Cinema Studio 4.0 | 720p, 4s to 30s | from $0.123 / s | Higgsfield exclusive | Camera rig control |
| Genjutsu / Genjutsu Light | 1080p / 720p, 5s to 10s | $0.154 / s ($0.074 Light) | Higgsfield exclusive | Motion Transfer / Swap |
| MiniMax H3 | 1080p, 6s | $0.130 / s | $0.170 / s | 23.5% lower |
| Happy Horse 1.0 & 1.1 | 1080p, 5s to 10s | $0.140 / s | $0.200 / s (1.1) | 30.0% lower |
| PixVerse 6 | 1080p, 5s to 8s | $0.098 / s promo ($0.115 reg) | $0.115 / s | 15.0% lower |
| Wan 3.0 / Wan 3.0 Prime | 720p, 5s | $0.038 / s ($0.051 Prime) | Economy budget tier | Fast preview stills/video |
| Soul 2 / Marketing Studio 2.5 | 1080p / 2K images | $0.003 / $0.013 per img | API pay-per-image | Zero subscription |
Concurrency scales automatically with rolling 28-day deposits: accounts start at 2 concurrent jobs ($0 deposited), unlock 10 concurrent at $25+ deposited, 20 concurrent at $100+ (or immediately during the verified business email launch bonus), and 40 concurrent at $1,000+ deposited over the trailing 28 days. Compare monthly Studio credit bundles against Open API second-by-second in our interactive Higgsfield cost calculator.
Note that Canvas, Supercomputer, Popcorn, and Cinema Studio presets inside automated MCP pipelines always count against monthly credits, just like Motion Control and Face Swap loops. Before upgrading, verify Month 1 vs renewal rates in our Higgsfield promo code & billing guide or compare raw API rivals in Higgsfield AI alternatives.
Frequently asked questions about Higgsfield MCP
What is the official Higgsfield MCP server URL?
The hosted MCP connector endpoint is https://mcp.higgsfield.ai/mcp, added inside Claude Desktop or claude.ai under Customize -> Connectors, alongside the terminal package @higgsfield/cli.
Do I need separate API keys from OpenAI, Kling, or Google to use Higgsfield MCP?
No. Authenticating with your Higgsfield account links one subscription balance across bundled models such as Seedance, Kling, Veo, Sora, Soul, and Nano Banana Pro.
Can I run unlimited generations through Higgsfield MCP or Supercomputer?
No. Fine print on higgsfield.ai/pricing confirms that Unlimited models and Free Generations are excluded from MCP/CLI, Canvas, and Supercomputer, so automated agent calls deduct paid credits.
Does Basic ($9/mo) work with Higgsfield MCP workflows?
Basic gives 120 credits/mo and 2 video / 4 image concurrent jobs, enough for light still tests (~60 Nano Banana Pro images) or ~1 high-res Seedance clip, though steady video automation calls for Plus (1,000 credits) or Ultra (3,000+ credits).
Do unused Higgsfield MCP credits roll over to next month?
Not on individual plans (Free, Basic, Plus, Ultra). Monthly credits expire every 30 days on your billing cycle, while Month 1 rollover applies only to Business Team and Scale seat pools.
Should I pay for Higgsfield MCP or Cinema Studio separately?
Both Cinema Studio and MCP access tie into your active Higgsfield plan wallet, with web Cinema Studio honoring eligible promo queues while MCP and Supercomputer pull strictly from paid credit balances.
To estimate how your monthly clip volume and draft retries compare across video and image tiers, run your numbers in our AI Cost Calculator.