Back to search
100
MCP live MCP 2025-11-25 streamable-http

Flux Cloud

io.github.runonflux/flux-cloud-mcp

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

Watch this dependency Share evidence report
Uptime
100.0%
5 direct probes · 30d
Response
530ms
last probe
Tools
15
callable
Resources
4
readable
Prompts
1
available
Primary URL
https://mcp.runonflux.com/mcp
Score: 100/100
Handshake verified by our own probe.
pass Answers the MCP handshake 50/50
The handshake and the list calls succeeded on the primary URL.
pass Lists tools, resources or prompts 30/30
15 tools, 4 resources, 1 prompts returned.
pass 3 or more catalogue items 10/10
20 items in total; 3 or more earns these points.
pass Describes itself 10/10
86 characters; more than 30 earns these points.

Tools · 15

flux_get_identity

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_generate_keys

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_PRIV…

flux_get_pricing

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_build_spec

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 erro…

flux_validate_spec

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-formatte…

flux_quote_app

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 t…

flux_deploy_app

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 …

flux_wait_for_app

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 URL…

flux_get_app

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 a…

flux_list_my_apps

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

flux_get_app_logs

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 k…

flux_get_app_stats

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

flux_control_app

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 e…

flux_cancel_app

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, re…

flux_get_network_info

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

Resources · 4

guide-overview

How identity, deployment, pricing and reachability work.

flux://guide/overview
guide-spec-format

Field-by-field reference for the app specification.

flux://guide/spec-format
guide-pricing

The USD rate card, discounts and how FLUX amounts are derived.

flux://guide/pricing
guide-gotchas

Failure modes that are easy to hit and how this server avoids them.

flux://guide/gotchas

Prompts · 1

deploy_on_flux

Walks through describing, pricing, confirming and deploying an app.

How to use

Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://mcp.runonflux.com/mcp

Cursor or Cline: add to your MCP config:

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