For AI agents
Your agent gets the whole product, not a demo.
The Flux Cloud MCP server exposes quoting, deploying, paying, watching, logs, updates and cancelling to any MCP host. Prices are the same USD prices this app charges, converted to FLUX with the 5 % bonus.
Two keys, no account
A Flux ID owns the apps and signs; a payment address holds FLUX. The server can generate both. Or use an agent token from your account with a daily limit.
Quotes from the network
Every price comes from the network's own formula, including the $0.99 minimum and term discounts. The agent sees what you would see.
Plan first, spend on confirm
Deploy and cancel run as a plan by default. Only an explicit confirm signs, broadcasts and pays.
Hosted server
No install: point the MCP host at the hosted endpoint and sign in with a token.
{
"mcpServers": {
"flux-cloud": { "url": "https://mcp.runonflux.com/mcp" }
}
}Claude Code
One command registers the server for every project.
claude mcp add flux-cloud -s user \ -e FLUX_ID_PRIVATE_KEY=<wif> -e FLUX_PAYMENT_PRIVATE_KEY=<wif> \ -- npx -y @runonflux/flux-cloud-mcp
Claude Desktop, Cursor, Windsurf, OpenCode
Standard MCP JSON. Keys are optional; without them every read-only tool still works.
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": ["-y", "@runonflux/flux-cloud-mcp"],
"env": {
"FLUX_ID_PRIVATE_KEY": "<wif of the Flux ID>",
"FLUX_PAYMENT_PRIVATE_KEY": "<wif of the payment address>"
}
}
}
}Tools
| flux_get_identity | Flux ID, payment address, balance in FLUX and USD | |
| flux_generate_keys | New Flux ID and payment key pair with setup instructions | |
| flux_get_pricing | USD rate card, FLUX rate, discounts, reference sizes | |
| flux_build_spec | Simple description to a full spec | |
| flux_validate_spec | Local rules plus verification on a node | |
| flux_quote_app | USD price and FLUX to pay, for a registration or an update | |
| flux_deploy_app | Plan, or with confirm: sign, broadcast and pay | spends |
| flux_wait_for_app | Poll until accepted and instances run; returns URLs | |
| flux_get_app | Any app's spec, expiry, instances, URLs | |
| flux_list_my_apps | Apps owned by the Flux ID with instance counts and days left | |
| flux_get_app_logs | Container logs from a running instance, owner only | |
| flux_get_app_stats | Live CPU, memory and network of an instance | |
| flux_control_app | Restart, redeploy or remove instances, per node or globally | |
| flux_cancel_app | End an app early by shortening its term | spends |
| flux_get_network_info | Node counts, height, FLUX rate, deployment address |