MCP
Claude, Codex and Cursor
Give Claude, Codex, Cursor or any MCP client Flux search, Lineage and fetch, with a skill that teaches it when to use each.
The Flux MCP server gives an assistant four tools. The Claude Code plugin and the Codex skill also teach the assistant when to use each tool and how to report what comes back.
search: ranked web results, with the passages that answer the query from the pages Flux reads.lineage: the passages of a document or link that answer your questions, with people, places, organisations and dates written in.fetch: one web page whole, as markdown.account: the balance. Free.
You need a Flux API key, which you can create at app.fluxsearch.io/keys. Every client except Claude Desktop also needs Node.js 18 or newer.
Install
Claude Code
Run these in Claude Code. It asks for your API key and stores it in your system's credential store.
/plugin marketplace add Flux-Search/flux-MCP/plugin install flux@flux-searchStart a new session afterwards: MCP servers load when a session begins.
Claude Desktop
Download flux.mcpb from the latest release and open it. Claude Desktop asks for your key and runs the server itself, so Node.js is not needed.
Codex
codex mcp add flux --env FLUX_API_KEY=user_sk_... -- npx -y github:Flux-Search/flux-MCP$key = Read-Host "Flux API key"codex mcp add flux --env "FLUX_API_KEY=$key" -- npx -y github:Flux-Search/flux-MCPRemove-Variable keyThen add the skill:
npx skills add https://github.com/Flux-Search/flux-MCP/tree/main/codex --skill flux-codex --agent codex --globalCodex lists the server as Auth unsupported. That is expected: the key is passed as an environment variable, not through OAuth.
Cursor and other MCP clients
Any client that starts a server from a command works the same way. For Cursor, add this to ~/.cursor/mcp.json:
{ "mcpServers": { "flux": { "command": "npx", "args": ["-y", "github:Flux-Search/flux-MCP"], "env": { "FLUX_API_KEY": "user_sk_..." } } }}Try it
Ask in plain language:
- Search for the latest UK inflation figure and tell me where it comes from.
- Read https://en.wikipedia.org/wiki/Seagrass and tell me why seagrass stores carbon.
- Use lineage on this report and list everyone it mentions, then paste the text.
- What is my Flux balance?
Each answer ends with what it cost. Lineage is charged once per question, so asking three questions about one document costs three passes. The repository has example documents, every tool argument and a troubleshooting table.