Cloud Services
runonflux.com
MCP server for Flux decentralized cloud that manages identity and keys, retrieves pricing, and builds/validates app deployment specifications.
ENDPOINT 1
https://mcp.runonflux.com/mcp
MCP server metadata
- Name
- flux-cloud
- Version
- 0.2.2
Deploy and manage apps on Flux Cloud, the decentralized cloud. Read the flux://guide/overview resource first. All prices are Flux Cloud USD prices (converted to FLUX for payment). Always show the user the USD quote from flux_quote_app and get their agreement before calling flux_deploy_app with confirm=true, which spends FLUX. This is the hosted server: it stores no keys. Read-only tools need none. Tools that sign or pay take fluxIdPrivateKey and paymentPrivateKey as arguments, used only for that call. NEVER ask the user for the keys of a wallet they use elsewhere: call flux_generate_keys to create a dedicated pair, tell the user to fund the payment address with only the amount needed, and reuse that pair in later calls. Remind the user to save the keys.
Known tools 15
flux_get_identityReturns the Flux ID (app owner address), the payment address and its spendable FLUX balance with its USD value.
Potential side effectsflux_generate_keysCreates two fresh private keys (WIF): one for the Flux ID that will own apps, one for the address that pays.
Inferred read-onlyflux_get_pricingReturns the current USD rate card, the live FLUX/USD rate, the pay-in-FLUX discount and instant USD estimates for a few reference sizes.
Potential side effectsflux_build_specTurns images, ports, resources and a term into a complete, correctly formatted v8 specification, with public ports auto-picked and data replication enabled.
Inferred read-onlyflux_validate_specRuns the local rule checks, then asks a FluxOS node to verify the specification exactly as it would at registration (image reachable, architecture, ports, name availability).
Inferred read-onlyflux_quote_appReturns the Flux Cloud price for registering the given specification, or for updating it if an app of that name already exists (the unused part of the current term is credited).
Inferred read-onlyflux_deploy_appValidates the specification on a node, quotes it, and with confirm=true signs it with the Flux ID, broadcasts it and pays the quoted FLUX from the payment address.
Potential side effectsflux_wait_for_appPolls the network for up to timeoutSeconds (default 45 to fit hosts with a 60 s tool timeout, max 600).
Inferred read-onlyflux_get_appLooks up any app on the network by name and returns its published specification, expiry, running instances and URLs.
Inferred read-onlyflux_list_my_appsLists every app registered by the owner (or a given Flux ID) with expiry and instance counts.
Inferred read-onlyflux_get_app_logsFetches the last N log lines of an app (or one component of it) from one of the nodes running it.
Inferred read-onlyflux_get_app_statsCPU, memory and network stats of the containers of an app on one node.
Inferred read-onlyflux_cancel_appEnds an app early by updating its term so it expires within about an hour.
Inferred read-onlyflux_get_network_infoNode counts by tier, current block height, FLUX/USD rate and the deployment payment address.
Potential side effectsCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.flux-cloud]
url = "https://mcp.runonflux.com/mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"flux-cloud": {
"type": "http",
"url": "https://mcp.runonflux.com/mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: flux-cloud
Remote MCP URL: https://mcp.runonflux.com/mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"flux-cloud": {
"url": "https://mcp.runonflux.com/mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"flux-cloud": {
"type": "http",
"url": "https://mcp.runonflux.com/mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "flux-cloud",
"transport": "streamable-http",
"url": "https://mcp.runonflux.com/mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.