Flux Cloud

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/runonflux-flux-cloud-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

12 read · 0 write · 3 delete

Secrets

2 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (15)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• flux_build_specBuild a Flux app specification from a simple descriptionread-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.

• flux_cancel_appCancel an app (stop it and stop paying)can change or delete data

  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.

• flux_control_appRestart, redeploy or remove app instancescan change or delete data

  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.

• flux_deploy_appDeploy (register or update) an app and pay for itcan change or delete data

  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.

• flux_generate_keysGenerate a new Flux ID and payment key pairread-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.

• flux_get_appGet a deployed app: spec, status, instances, URLsread-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.

• flux_get_app_logsRead container logs from a running instanceread-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.

• flux_get_app_statsGet live resource usage of a running instanceread-only

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

• flux_get_identityShow the configured Flux identity and balanceread-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.

• flux_get_network_infoNetwork overviewread-only

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

• flux_get_pricingGet the Flux Cloud rate cardread-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.

• flux_list_my_appsList apps owned by the configured Flux IDread-only

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

• flux_quote_appQuote the price of an app in USD and FLUXread-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.

• flux_validate_specValidate a specification locally and on the networkread-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.

• flux_wait_for_appWait for a deployment to be accepted and its instances to runread-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.

Signals

Stars

0

Forks

0

Open issues

0

Last commit

Oct 16, 2026 (14 days ago)

Last release

Oct 16, 2026 (14 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.RunOnFlux/flux-cloud-mcp

Version

0.2.8

Auth

Auth not stated, API key

Packages

npm @runonflux/flux-cloud-mcp

License

MIT

Repository

github.com/RunOnFlux/flux-cloud-mcp

Website

runonflux.com

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql