Flux for Cursor

Keep Cursor. Give it 90+ models from 12 AI labs on one key, plus page reading and images through the Flux tools server.

Get your key Set it up

Set it up

Flux Desktop can write this config for you in one click. To do it by hand:

Open Settings, then Models, and turn on "Override OpenAI Base URL".
text
```
Base URL: https://api.fluxrouter.ai/v1
OpenAI API Key: sk-YOUR-FLUX-KEY
```
Add a custom model named flux-auto, then click Verify.

This recipe comes from our earlier Cursor guide. We have not re-checked it against the newest Cursor release yet.

Check the first call

Open the chat panel with Cmd/Ctrl+L, pick flux-auto, and send "Reply with the word ready."
Open Activity in your Flux account to see the call counted against the model that answered and the key that made it.

What Cursor gets

What Cursor gets through Flux
Ability	Today	How it reaches Cursor
Every major model	Live	Automatic, through the base URL.
Read a web page	Live	Add the Flux tools server (below).
Search the web	Rolling out	Switched on and being checked. Not promised yet.
Make images	Live	Add the Flux tools server (below).
Speak	Rolling out	Switched on and being checked. Not promised yet.
Transcribe audio	Not in agents yet	Live on the API for your own code. No agent reaches it yet.
Act in your apps	Shipping	Not live yet. It is on the way.
Memory	Shipping	Not live yet. It is on the way.
Second opinion	Rolling out	Switched on and being checked. Not promised yet.

Statuses come from the same record as the abilities on the homepage, so they change everywhere at once.

Add the Flux tools server

Page reading and image making reach Cursor through the Flux tools server, an MCP server on the same key. Web search joins it once it is live.

Add the Flux tools server to your global MCP config, then restart Cursor. ~/.cursor/mcp.json

~/.cursor/mcp.json

{
  "mcpServers": {
    "flux-tools": {
      "url": "https://api.fluxrouter.ai/mcp-tools/",
      "headers": {
        "Authorization": "Bearer sk-YOUR-FLUX-KEY"
      }
    }
  }
}

Format from Cursor’s own MCP docs, read on 28 September 2026.

Good to know

Only Cursor's chat and plan panel (Cmd/Ctrl+L) uses the custom endpoint. Composer, agent mode, inline edit, apply and tab autocomplete stay on Cursor's own backend.
flux-auto bills at the Standard rate, or the Fast rate when it sends your request to the Fast lane and a Fast model answers. Never more than Standard. Pin a model and you pay that model’s rate instead.
Flux can pick a different model from one request to the next. A prompt cache belongs to one model, so a switch can mean a cache miss. If a long session leans on caching, pin a model.
The Flux tools server needs a funded key. Without one, its tools return an error instead of a result.

If it won’t connect

Composer, agent mode or tab completion ignore Flux.: That is Cursor, not Flux: those features always use Cursor's own backend. Use the chat panel, or use Cline inside VS Code for a fully routed agent.
Verify fails.: The base URL must end in /v1, with nothing after it. Check the model name is exactly flux-auto.
Every request comes back 401.: The key is missing, mistyped, or an old provider key is still set and wins. Paste your Flux key again and remove any other provider key from this config.
Requests come back 402.: Your account has reached its spend ceiling. Add funds or raise the ceiling in your Flux account, then try again.

More fixes: my tool won’t connect.

Try this next

Add checkout

Add Stripe checkout to the cart page, get a second opinion on the payment logic, then open a PR and close the ticket.

Some steps in this job use abilities that are still shipping, so Cursor does part of it today.