Higgsfield MCP server
11 operations1 webhook
Generative media API with image and video models from Higgsfield, Kling, Seedance, Wan, MiniMax and others; find models, price and run generations, follow or cancel requests, upload input files and read usage.
Try Higgsfield with your agent
Connect Higgsfield, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Higgsfield on my account, then run one read-only example and show me the result.
Higgsfield tools and triggers
Tools are what your agent can do in Higgsfield through Corsair's MCP server. Triggers are the Higgsfield events a routine can start from.
Generations
- EstimateRead-only
What a generation with these inputs would cost, in US dollars and credits. Free; nothing runs.
generations.estimate
- RunWrite
Generate and wait up to waitSeconds (default 10, at most 15) for the output; spends account balance when it completes. Answers like requests.status: queued or in_progress is a job to follow with requests.status, and video usually takes longer than the wait. Outputs expire after 7 days by default.
generations.run
- SubmitWrite
Queue a generation (image, video…) and get a request id back at once; spends account balance when it completes. Follow it with requests.status until it is completed, failed, nsfw or canceled, or pass webhookUrl. Outputs expire after 7 days by default. Repeating with the returned idempotency_key is never charged twice.
generations.submit
Requests
- CancelWrite
Cancel a request that is still queued and refund it. Once it has started it cannot be canceled, and this errors.
requests.cancel
- DeleteDestructive
Delete a finished request's files, prompt and parameters now. Billing records stay. A request still running gets a 409.
requests.delete
- StatusRead-only
Where a request stands, with its output URLs once completed. Output URLs stop working at expires_at, 7 days after it finished by default.
requests.status
Files
- Create Upload UrlWrite
Get a presigned URL to PUT an input file to yourself, and the public URL it will have. For most uses files.upload does both steps.
files.createUploadUrl
- UploadWrite
Upload an image, audio or video file from base64 and get the public URL to pass as a model input. A file already at a public https URL needs no upload: pass that URL to the model.
files.upload
Models
- GetRead-only
One model by its path, with its input fields (input_schema). Read this before a generation: every model takes its own fields.
models.get
- ListRead-only
Find Higgsfield models by text, output type or operation; includeSchema adds their input fields
models.list
Usage
- GetRead-only
Completed generations and their estimated cost by model and time bucket. For monitoring: it can lag and is not a billing record.
usage.get
Connect Higgsfield to Claude, ChatGPT or Cursor
- 1
Connect Higgsfield in Corsair
Add your Higgsfield API key once in Corsair. Corsair stores the credential encrypted and makes the Higgsfield API calls for your agent, so it never goes into a prompt or a config file. Connect Higgsfield
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Higgsfield. On a ChatGPT personal plan, connect Higgsfield here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Higgsfield's read and write operations run right away and its 1 destructive operation waits for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/higgsfield, add the Higgsfield plugin, and connect with an API key. Then call methods like corsair.higgsfield.api.files.createUploadUrl() from your app. Corsair verifies webhooks, and keeps each tenant isolated.
Yes. Higgsfield requires an API key from your Higgsfield account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Higgsfield, GitHub, Notion, Stripe, and the rest. Trigger Higgsfield from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for generative media API with image and video models from Higgsfield, Kling, Seedance, Wan, MiniMax and others; find models, price and run generations, follow or cancel requests, upload input files and read usage. Common builds include sync jobs, admin tooling, and agents that call Higgsfield APIs from your backend. Webhook handlers react to Higgsfield events and fan out to Slack, email, or other plugins in the same tenant.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Higgsfield API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/higgsfield in the open repo. When Higgsfield ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Higgsfield data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Higgsfield data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Higgsfield on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 1 destructive Higgsfield operation. You can change a link's mode at hub.corsair.dev/me.