Flux Cloud

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Flux Cloud": {
      "url": "https://mcp.runonflux.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (15)

• flux_get_identity read-only

  Returns 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.

  Parameters:

  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_generate_keys read-only

  Creates 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.

  Parameters:

  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• flux_get_pricing read-only

  Returns 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.

  Parameters:

  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_build_spec read-only

  Turns 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.

  Parameters:

  • name (required) — string — Unique app name: letters, digits, inner hyphens. Not starting with "flux" or "zel".
  • components (required) — array
  • nodes — array
  • owner — string — Flux ID that will own the app. Defaults to the configured or passed key.
  • months — number — Term in network months (88000 blocks each). Default 1.
  • contacts — array
  • staticip — boolean
  • instances — integer — Copies on distinct nodes. Default 3.
  • description — string
  • geolocation — array
  • expireBlocks — integer — Exact term in blocks; overrides months.
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• flux_validate_spec read-only

  Runs 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.

  Parameters:

  • spec (required) — object
  • network — boolean — Also verify on a FluxOS node.
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_quote_app read-only

  Returns 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.

  Parameters:

  • spec (required) — object
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_deploy_app destructive

  Validates 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.

  Parameters:

  • spec (required) — object
  • confirm — boolean — Set true to actually sign, broadcast and pay.
  • enterprise — object — Make the app private: these components and contacts are encrypted so only the nodes running the app can read them. When set, spec.compose should be [] and spec.enterprise "".
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• flux_wait_for_app read-only

  Polls 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.

  Parameters:

  • name (required) — string
  • txid — string — Payment txid from flux_deploy_app, to report confirmations.
  • previousHash — string — For updates: the hash of the previous spec, so acceptance means a new hash.
  • timeoutSeconds — integer
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_get_app read-only

  Looks 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.

  Parameters:

  • name (required) — string
  • ports — array — Ports to probe on instances; needed for private apps whose ports are encrypted.
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_list_my_apps read-only

  Lists every app registered by the owner (or a given Flux ID) with expiry and instance counts.

  Parameters:

  • owner — string — Flux ID to list; defaults to the configured one.
  • nameContains — string — Only apps whose name contains this text.
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_get_app_logs read-only

  Fetches 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.

  Parameters:

  • name (required) — string
  • lines — integer
  • nodeIp — string — ip[:port] of the instance; defaults to the first running one.
  • component — string — Component name for multi-component apps.
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_get_app_stats read-only

  CPU, memory and network stats of the containers of an app on one node. Requires the owner key.

  Parameters:

  • name (required) — string
  • nodeIp — string
  • component — string — Component name for multi-component apps.
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• flux_control_app destructive

  restart: 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.

  Parameters:

  • name (required) — string
  • action (required) — string
  • hard — boolean — For redeploy: also delete the app data.
  • scope — string
  • nodeIp — string — Required for scope=node; also the node the global command is sent through.
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• flux_cancel_app destructive

  Ends 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.

  Parameters:

  • name (required) — string
  • confirm — boolean
  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• flux_get_network_info read-only

  Node counts by tier, current block height, FLUX/USD rate and the deployment payment address.

  Parameters:

  • fluxIdPrivateKey — string — WIF private key of the Flux ID that owns the app. Use a dedicated key from flux_generate_keys, never a main wallet key.
  • paymentPrivateKey — string — WIF private key of the Flux address that pays. Fund it with only what you intend to spend.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.