io.github.RunOnFlux/flux-cloud-mcp

Flux Cloud

Deploy, pay for and manage apps on Flux Cloud, the decentralized cloud. Prices in USD.

Endpointhttps://mcp.runonflux.com/mcp (streamable-http)
Registry version0.2.8
Now15 tools · grade A (95) · pin ts_bf9106a8f871f3cff53e9a3df54141d4 · protocol 2025-06-18
First / last listed2026-10-30 02:28 UTC / 2026-10-30 02:28 UTC
Grade over time2026-10-30: A (95), 15 tools

Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.

Timeline

First listing · 2026-10-30 02:28 UTC
15 tools, grade A (95)

Tools: flux_get_identity flux_generate_keys flux_get_pricing flux_build_spec flux_validate_spec flux_quote_app flux_deploy_app flux_wait_for_app flux_get_app flux_list_my_apps flux_get_app_logs flux_get_app_stats flux_control_app flux_cancel_app flux_get_network_info

Current tools (15)

flux_get_identityReturns the Flux ID (app owner address), the payment address and its spendable FLUX balance with its USD value. Explains what to configure if keys are missing. Never returns private keys.
params: fluxIdPrivateKey, paymentPrivateKey
flux_generate_keysCreates two fresh private keys (WIF): one for the Flux ID that will own apps, one for the address that pays. The response contains the secrets; store them in the MCP server environment as FLUX_ID_PRIVATE_KEY and FLUX_PAYMENT_PRIVATE_KEY, then restart the server. Nothing is stored or sent anywhere by this tool.
params: fluxIdPrivateKey, paymentPrivateKey
flux_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. Use flux_quote_app for the exact price of a specific app.
params: fluxIdPrivateKey, paymentPrivateKey
flux_build_specTurns images, ports, resources and a term into a complete, correctly formatted v8 specification, with public ports auto-picked and data replication enabled. Returns the spec plus local validation errors and warnings.
params: name*, description, components*, instances, months, expireBlocks, contacts, geolocation, nodes, staticip, owner, fluxIdPrivateKey, paymentPrivateKey
flux_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). Returns the node-formatted spec on success.
params: spec*, network, fluxIdPrivateKey, paymentPrivateKey
flux_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). Price is in USD with the FLUX amount at market rate.
params: spec*, fluxIdPrivateKey, paymentPrivateKey
flux_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. Without confirm it only returns the plan (price, balance, warnings) and spends nothing. Registers a new name or updates an existing app of the same owner. Then call flux_wait_for_app with the returned txid.
params: spec*, enterprise, confirm, fluxIdPrivateKey, paymentPrivateKey
flux_wait_for_appPolls the network for up to timeoutSeconds (default 45 to fit hosts with a 60 s tool timeout, max 600). Returns payment confirmations, whether the spec was accepted, and the running instances with URLs. Safe to call repeatedly until done=true.
params: name*, txid, previousHash, timeoutSeconds, fluxIdPrivateKey, paymentPrivateKey
flux_get_appLooks up any app on the network by name and returns its published specification, expiry, running instances, URLs and a reachability check: probes the shared domain (HTTP) and each instance port (TCP and HTTP) and explains what a 503 means, including when it is expected for non-web apps.
params: name*, ports, fluxIdPrivateKey, paymentPrivateKey
flux_list_my_appsLists every app registered by the owner (or a given Flux ID) with expiry and instance counts.
params: owner, nameContains, fluxIdPrivateKey, paymentPrivateKey
flux_get_app_logsFetches the last N log lines of an app from one of the nodes running it. Requires the owner key. The component is picked automatically when the app has one (private apps are decrypted with the owner key); otherwise the available names are listed.
params: name*, component, lines, nodeIp, fluxIdPrivateKey, paymentPrivateKey
flux_get_app_statsCPU, memory and network stats of the containers of an app on one node. Requires the owner key.
params: name*, component, nodeIp, fluxIdPrivateKey, paymentPrivateKey
flux_control_apprestart: restarts containers. redeploy: pulls the image again and recreates containers (hard=true also wipes data). remove: uninstalls from nodes; the registration stays and the network re-spawns it elsewhere, so use flux_cancel_app to stop paying. Scope is one node (nodeIp) or every node running the app (global). Requires the owner key.
params: name*, action*, scope, nodeIp, hard, fluxIdPrivateKey, paymentPrivateKey
flux_cancel_appEnds an app early by updating its term so it expires within about an hour. The network then uninstalls it everywhere. With confirm=true this signs and pays the (usually minimal) update; without it, returns the plan.
params: name*, confirm, fluxIdPrivateKey, paymentPrivateKey
flux_get_network_infoNode counts by tier, current block height, FLUX/USD rate and the deployment payment address.
params: fluxIdPrivateKey, paymentPrivateKey

Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.