Flux Cloud MCP Server
by runonfluxio.github.RunOnFlux/flux-cloud-mcpv0.2.7
Deploy, pay for and manage apps on Flux Cloud, the decentralized cloud. Prices in USD.
context tax
queued
security
queued
cold start
queued
freshness
Active27d ago
Install Flux Cloud MCP server
Install in Claude Code
claude mcp add flux-cloud -e FLUX_ID_PRIVATE_KEY='<flux-id-private-key>' -e FLUX_PAYMENT_PRIVATE_KEY='<flux-payment-private-key>' -- npx -y @runonflux/flux-cloud-mcpInstall in Cursor
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<flux-id-private-key>",
"FLUX_PAYMENT_PRIVATE_KEY": "<flux-payment-private-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<flux-id-private-key>",
"FLUX_PAYMENT_PRIVATE_KEY": "<flux-payment-private-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"flux-cloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<flux-id-private-key>",
"FLUX_PAYMENT_PRIVATE_KEY": "<flux-payment-private-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<flux-id-private-key>",
"FLUX_PAYMENT_PRIVATE_KEY": "<flux-payment-private-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| FLUX_ID_PRIVATE_KEY | — | yes | WIF private key of the Flux ID that owns your apps. Optional; read-only tools work without it. flux_generate_keys creates one. |
| FLUX_PAYMENT_PRIVATE_KEY | — | yes | WIF private key of the Flux address that pays deployment fees. Optional; fund it with only what you intend to spend. |
Remote endpoints
- streamable-http
https://mcp.runonflux.com/mcp
Freshness
Active — last maintenance signal 27d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-09-13 · 27d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-13 · 27d ago · official registry · v0.2.7
FAQ
›How do I install the Flux Cloud MCP server in Claude Code?
Run: claude mcp add flux-cloud -e FLUX_ID_PRIVATE_KEY='<flux-id-private-key>' -e FLUX_PAYMENT_PRIVATE_KEY='<flux-payment-private-key>' -- npx -y @runonflux/flux-cloud-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Flux Cloud require an API key?
Yes. It expects FLUX_ID_PRIVATE_KEY, FLUX_PAYMENT_PRIVATE_KEY, of which 2 are secrets.
›Can I use Flux Cloud as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Flux Cloud in the official MCP registry?
Yes, as io.github.RunOnFlux/flux-cloud-mcp.