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

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K
Advertise