home / mcp / flux mcp server

Flux MCP Server

Provides AI-based AO tool calling and integration with MCP-enabled editors for running, testing, and managing AO code and handlers.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "asrvd-flux": {
      "url": "https://flux-2esw.onrender.com/sse"
    }
  }
}

Flux is an AI-powered MCP server that enables natural-language driven AO tool calling and seamless integration with your existing AI development tools. It lets you run AO code, create custom AO blueprints, test code in-process, and manage complex handlers, all through MCP-enabled clients like Cursor, Windsurf, Claude, and any tool that supports MCP tool calling.

How to use

You access Flux through an MCP client and load Flux as an MCP server so you can issue natural-language prompts that translate into AO actions. Once loaded, Flux exposes its tools to your MCP client, enabling you to run AO code, create new AO blueprints, and test outcomes directly from your editor or IDE.

Practical usage patterns include: writing AO-based handlers that respond to specific intents, testing AO code paths within your current workflow, and chaining Flux tooling with other MCP-enabled services. Start by loading Flux in your MCP client, then issue natural-language requests such as asking Flux to generate and execute an AO blueprint or to run a code snippet in a controlled AO process. Flux supports testing the code it pushes to a process, helping you iterate quickly.

How to install

Prerequisites you need before installing Flux: ensure you have a recent stable version of Node.js installed.

Two installation options exist. Choose the one that matches your preferred setup: local (all components run locally) or remote (Flux runs remotely). Follow the steps exactly as shown to enable Flux in your MCP client.

Local Setup steps

1) Open your MCP client (for example Cursor) and access the MCP configuration area.

2) Add a new MCP tool and paste the following configuration snippet to load Flux locally.

"mcpServers": {
    "flux": {
        "command": "npx",
        "args": ["-y", "flux-ao@latest"],
    }
}

Remote Setup steps

If you prefer Flux to run remotely, use the remote configuration in your MCP client.

3) In your MCP client, add a new MCP tool and paste this snippet to point to the remote Flux server.

"mcpServers": {
    "flux": {
        "url": "https://flux-2esw.onrender.com/sse",
    }
}

Starting Flux in your environment

After adding Flux as an MCP server, restart or reload your MCP client to ensure Flux tools appear in your toolset. If you encounter any delays, reloading the MCP configuration or restarting the client may be necessary.

Available tools

run_ao

Run AO code using natural language through Flux's MCP integration.

create_blueprints

Create and run custom AO code or blueprints entirely via natural language.

test_code

Test and validate code pushed to a Flux-managed process.

create_handlers

Create and test complex AO handlers within your MCP workflow.

integration

Integrate Flux with existing AI dev tools that support MCP tool calling.