# Flux Cloud

> Flux Cloud is a paid MCP server for cloud and infrastructure. Quote, deploy and manage apps on the Flux decentralized cloud, priced in USD. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI, self-hosted
- **Website:** https://runonflux.com
- **Repository:** https://github.com/runonflux/flux-cloud-mcp
- **MCP Registry name:** io.github.RunOnFlux/flux-cloud-mcp
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

Flux Cloud runs apps across user-operated nodes rather than one provider's data centres, and this server lets an agent handle the whole lifecycle: quote an app in dollars, deploy it, pay for it, watch it start, read logs, update it and cancel. There is no account. Two keys form the identity: a Flux ID key that owns and signs apps without holding funds, and a separate payment key that pays deployment fees on-chain in FLUX.

Every price shown is the Flux Cloud USD price, converted to FLUX at the market rate with a 5 percent discount for paying in FLUX. Quotes come from the network, so they include a $0.99 minimum plus hardware and term discounts. Tools turn a simple description (image, ports, CPU, RAM, disk, months) into a full spec, validate it against a FluxOS node, and quote it before anything is spent. Without keys, only the read-only tools work, and flux_generate_keys creates a pair.

It runs over stdio from an npm package or as a hosted endpoint. Because it can spend FLUX, fund the payment address only with what you intend to spend.

## Features

- **USD quotes:** flux_quote_app gives the dollar price and FLUX amount for a registration or update.
- **Spec builder:** flux_build_spec turns a plain description into a full v8 app spec.
- **Spec validation:** flux_validate_spec checks local rules and verifies on a FluxOS node.
- **Key generation:** flux_generate_keys creates a Flux ID and payment key pair.
- **Keys are optional for reading:** Read-only tools work without any private keys.

## Good for

- Price an app deployment in dollars before paying
- Let an agent deploy a Docker app to the decentralized cloud
- Check balance and identity for a Flux address
- Update or cancel a running Flux app

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http flux-cloud-mcp https://mcp.runonflux.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.runonflux.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "flux-cloud-mcp": {
      "url": "https://mcp.runonflux.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "flux-cloud-mcp": {
      "type": "http",
      "url": "https://mcp.runonflux.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "flux-cloud-mcp": {
      "serverUrl": "https://mcp.runonflux.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "flux-cloud-mcp": {
      "type": "http",
      "url": "https://mcp.runonflux.com/mcp"
    }
  }
}
```

## Tools

- `flux_get_identity`: Show the Flux ID, payment address and balance in FLUX and USD.
- `flux_generate_keys`: Create a new Flux ID and payment key pair with setup instructions.
- `flux_get_pricing`: Show the USD rate card, FLUX/USD rate and discounts.
- `flux_build_spec`: Turn a simple description into a full v8 app spec.
- `flux_validate_spec`: Validate a spec with local rules and a FluxOS node.
- `flux_quote_app`: Quote the USD price and FLUX to pay for a registration or update.

## FAQ

### Do I need an account?

No. Two private keys are the whole identity, and the server can generate them.

### What currency are prices in?

Shown in USD, converted to FLUX at the live rate with a 5 percent pay-in-FLUX discount.

### Can it spend my funds?

With a payment key set, it can pay deployment fees on-chain, so fund that address with only what you intend to spend.

### What is the minimum price?

Quotes include a $0.99 minimum.

### Is Flux Cloud free?

No. Flux Cloud is a paid product.

### How do I add Flux Cloud to Claude Code?

Run this command in your terminal: claude mcp add --transport http flux-cloud-mcp https://mcp.runonflux.com/mcp

### What are the best alternatives to Flux Cloud?

The closest alternatives to Flux Cloud are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.

## Alternatives

- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [MagicWP MCP](https://ai-powered.com/mcp/magicwp-mcp): MagicWP MCP is an MCP server for cloud and infrastructure.
- [Kubana Cloud Domains](https://ai-powered.com/mcp/kubana-cloud-domains): Kubana Cloud Domains is a paid MCP server for cloud and infrastructure.
- [Kubana Cloud DNS Management](https://ai-powered.com/mcp/kubana-cloud-dns-management): Kubana Cloud DNS Management is a free MCP server for cloud and infrastructure.
- [Kubana Cloud VPS](https://ai-powered.com/mcp/kubana-cloud-vps): Kubana Cloud VPS is a paid MCP server for cloud and infrastructure.
- [AgentViva](https://ai-powered.com/mcp/agentviva): AgentViva is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/flux-cloud
