MCP server for Flux Cloud: let AI agents quote, deploy, pay for and manage apps on the decentralized cloud
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add flux-cloud --env FLUX_ID_PRIVATE_KEY='<FLUX_ID_PRIVATE_KEY>' --env FLUX_PAYMENT_PRIVATE_KEY='<FLUX_PAYMENT_PRIVATE_KEY>' -- npx -y @runonflux/flux-cloud-mcp~/.codex/config.toml
[mcp_servers.flux-cloud]
command = "npx"
args = ["-y", "@runonflux/flux-cloud-mcp"]
env = { FLUX_ID_PRIVATE_KEY = "<FLUX_ID_PRIVATE_KEY>", FLUX_PAYMENT_PRIVATE_KEY = "<FLUX_PAYMENT_PRIVATE_KEY>" }
# codex mcp add flux-cloud --env FLUX_ID_PRIVATE_KEY='<FLUX_ID_PRIVATE_KEY>' --env FLUX_PAYMENT_PRIVATE_KEY='<FLUX_PAYMENT_PRIVATE_KEY>' -- npx -y @runonflux/flux-cloud-mcp~/.cursor/mcp.json
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<FLUX_ID_PRIVATE_KEY>",
"FLUX_PAYMENT_PRIVATE_KEY": "<FLUX_PAYMENT_PRIVATE_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"flux-cloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<FLUX_ID_PRIVATE_KEY>",
"FLUX_PAYMENT_PRIVATE_KEY": "<FLUX_PAYMENT_PRIVATE_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<FLUX_ID_PRIVATE_KEY>",
"FLUX_PAYMENT_PRIVATE_KEY": "<FLUX_PAYMENT_PRIVATE_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<FLUX_ID_PRIVATE_KEY>",
"FLUX_PAYMENT_PRIVATE_KEY": "<FLUX_PAYMENT_PRIVATE_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": [
"-y",
"@runonflux/flux-cloud-mcp"
],
"env": {
"FLUX_ID_PRIVATE_KEY": "<FLUX_ID_PRIVATE_KEY>",
"FLUX_PAYMENT_PRIVATE_KEY": "<FLUX_PAYMENT_PRIVATE_KEY>"
}
}
}
}Remote
claude mcp add --transport http flux-cloud https://mcp.runonflux.com/mcp~/.codex/config.toml
[mcp_servers.flux-cloud]
url = "https://mcp.runonflux.com/mcp"
# codex mcp add flux-cloud --url https://mcp.runonflux.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"flux-cloud": {
"url": "https://mcp.runonflux.com/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"flux-cloud": {
"type": "http",
"url": "https://mcp.runonflux.com/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"flux-cloud": {
"httpUrl": "https://mcp.runonflux.com/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"flux-cloud": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.runonflux.com/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"flux-cloud": {
"url": "https://mcp.runonflux.com/mcp"
}
}
}Environment variables
FLUX_ID_PRIVATE_KEYFLUX_PAYMENT_PRIVATE_KEY
Replace the placeholders with your own credentials and keep them out of version control.