MCP.so
Sign In

Flux

@asrvd

Repository

About Flux

mcp server on steroids for AO

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

12

spawn a new AO process

send a message to an existing AO process

install a package in an existing AO process

load the token blueprint in an existing AO process

create a new sqlite based handler in an existing AO process

run a lua script in an existing AO process

load a blueprint in an existing AO process

load a local blueprint in an existing AO process

load an official blueprint in an existing AO process

list all available handlers in an existing AO process

create a new handler in an existing AO process

run a handler using its name in an existing AO process

Overview

What is Flux?

Flux is an MCP server that enables AI-based AO tool calling using natural language. It integrates with existing developer tools and editors such as Cursor, Windsurf, and Claude by exposing AO code execution and blueprint creation through standard MCP tool calls.

How to use Flux?

Install Flux either locally (by running node with a local script) or remotely (by connecting to a hosted SSE endpoint). In Cursor, add Flux as a new MCP tool via Settings > Cursor Settings > MCP, then paste the appropriate JSON configuration. After loading, the Flux MCP tools are available in Cursor Agents. The README recommends adding the AO docs (llms.txt) as context and applying custom Cursor rules to improve response accuracy.

Key features of Flux

  • Run AO code using natural language
  • Create and run custom AO blueprints entirely with natural language
  • Integrates with Cursor, Windsurf, Claude, and any MCP‑compatible tool
  • Test code pushed to an AO process
  • Create and test complex handlers

Use cases of Flux

  • Automate AO process interactions from an AI‑powered editor
  • Build and iterate on AO blueprints without writing Lua manually
  • Test AO handlers and code changes inside your development environment
  • Combine AO ecosystem tools with existing MCP‑supported editors

FAQ from Flux

What runtime does Flux require?

Flux requires the latest stable version of Node.js. It uses the MCP TypeScript SDK and is built with TypeScript and Node.js.

What transports does Flux support?

Flux supports both local (stdio) and remote (SSE) transports. The remote endpoint is hosted at https://flux-2esw.onrender.com/sse.

Which tools and editors work with Flux?

Flux works with any tool that supports MCP tool calling, including Cursor, Windsurf, and Claude. The README notes that it has been tested most extensively on Cursor.

Are there any special configuration rules for Cursor?

Yes. The README provides custom Cursor rules that advise always using Send instead of msg.reply, ensuring handlers reply with data, avoiding unnecessary tags, and leveraging Handlers.utils when creating handlers.

Where does the code execution happen?

Code is executed on AO processes. Flux pushes code to a process and can test that code, but does not run a local AO environment.

Frequently asked questions

What runtime does Flux require?

Flux requires the latest stable version of Node.js. It uses the MCP TypeScript SDK and is built with TypeScript and Node.js.

What transports does Flux support?

Flux supports both local (stdio) and remote (SSE) transports. The remote endpoint is hosted at `https://flux-2esw.onrender.com/sse`.

Which tools and editors work with Flux?

Flux works with any tool that supports MCP tool calling, including Cursor, Windsurf, and Claude. The README notes that it has been tested most extensively on Cursor.

Are there any special configuration rules for Cursor?

Yes. The README provides custom Cursor rules that advise always using `Send` instead of `msg.reply`, ensuring handlers reply with data, avoiding unnecessary tags, and leveraging `Handlers.utils` when creating handlers.

Where does the code execution happen?

Code is executed on AO processes. Flux pushes code to a process and can test that code, but does not run a local AO environment.

Comments

Basic information

Category

Other

Transports

stdio

Author

asrvd

More Other MCP servers

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K