Skip to main content
Glama
RunOnFlux

Flux Cloud MCP server

Official
by RunOnFlux

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FLUX_API_URLNoLoad-balanced FluxOS API for reads and quoteshttps://api.runonflux.io
FLUX_NODE_URLNoPin one FluxOS node for registrationsauto
FLUX_RATES_URLNoFLUX market ratehttps://viprates.runonflux.io
FLUX_STATS_URLNoUSD rate cardhttps://stats.runonflux.io
FLUX_EXPLORER_URLSNoInsight explorers for UTXOs and broadcastexplorer.runonflux.io,flux-explorer.sspwallet.io
FLUX_ID_PRIVATE_KEYNoWIF of the Flux ID (owner)
FLUX_PAYMENT_PRIVATE_KEYNoWIF of the paying address

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
flux_get_identityA

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_keysA

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_pricingA

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_specB

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_validate_specA

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_quote_appA

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_deploy_appA

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_wait_for_appA

Polls the network for up to timeoutSeconds (default 300, max 600). Returns payment confirmations, whether the spec was accepted, and the running instances with URLs. Safe to call repeatedly until done=true.

flux_get_appB

Looks up any app on the network by name and returns its published specification, expiry, running instances and URLs.

flux_list_my_appsB

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

flux_get_app_logsA

Fetches the last N log lines of an app (or one component of it) from one of the nodes running it. Requires the owner key.

flux_get_app_statsB

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

flux_control_appA

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_cancel_appA

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_get_network_infoB

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

Prompts

Interactive templates invoked by user choice

NameDescription
deploy_on_fluxWalks through describing, pricing, confirming and deploying an app.

Resources

Contextual data attached and managed by the client

NameDescription
guide-overviewHow identity, deployment, pricing and reachability work.
guide-spec-formatField-by-field reference for the app specification.
guide-pricingThe USD rate card, discounts and how FLUX amounts are derived.
guide-gotchasFailure modes that are easy to hit and how this server avoids them.