Advertise
MCP.so
Sign In

Flux MCP Server

@asrvd

Repository

Basic information

Category

Other

Transports

stdio

Author

asrvd

About Flux MCP Server

mcp server on steroids for AO

Flux MCP Server config

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

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

Flux MCP Server 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

Frequently asked questions

1

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.

2

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`.

3

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.

4

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.

5

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

More Other MCP servers

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

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

ICSS

chokcoco

不止于 CSS

20.7K
Advertise