Futarchy

This MCP server enables Cursor to interact with the Futarchy protocol on Solana. It exposes routes and an MCP pathway to manage DAOs, proposals, and sentiment-aware analysis, plus a dedicated Cursor integration so you can operate Futarchy concepts directly from chat.

How to use

You can interact with Futarchy data and actions from Cursor using a set of Tools exposed by the MCP server. Use the following tools to retrieve data and create proposals: getDaos to list all DAOs, getDao to fetch a specific DAO by ID, getProposals to list proposals for a DAO, getProposal to fetch a single proposal by ID, and createProposal to add a new proposal for a DAO. The sentiment analysis feature is available to assess community sentiment around proposals, helping you gauge reaction across Discord and Twitter feeds.

In chat, invoke a tool by its name to perform the action. For example, say you want a list of all DAOs, then request getDaos. If you need details about one DAO, request getDao with its ID. To create a proposal, provide the required fields described in the createProposal flow when you prompt the tool.

How to install

Prerequisites: Node.js and npm must be installed on your system.

# 1) Clone the project
git clone <repository-url>
cd futarchy-mcp

# 2) Install dependencies
npm install

# 3) Configure RPC URL in the server
# Edit the RPC URL in the connection initialization
# Open the file where the Solana connection is created and update it as shown below
# const connection = new Connection('YOUR_RPC_URL_HERE');

# 4) Start the development server
npm run dev

Additional sections

MCP server for Futarchy offers a Cursor-friendly way to interact with Futarchy routes. To configure the MCP server for Cursor, you can use the setup script that installs dependencies, builds the project, and configures Cursor. If you prefer manual setup, you can install dependencies, build, and then configure Cursor yourself.

Manual MCP server configuration is shown here for Cursor integration. After installing and building, you add a Cursor MCP configuration pointing to the built MCP binary.

{
  "mcpServers": {
    "futarchy-routes": {
      "type": "stdio",
      "name": "futarchy_rout",
      "command": "node",
      "args": ["<absolute-path-to-project>/dist/mcp/bin/mcp-futarchy.js"]
    }
  }
}

Notes and troubleshooting

If you run into issues starting the server, ensure your Node.js version is compatible with the project and that the dist/mcp/bin/mcp-futarchy.js file exists after building. If the Cursor integration cannot locate the MCP server, verify the path provided in the args matches your local build output.

Security: keep your MCP access paths and any API keys secure. Do not expose internal paths or credentials in public environments.

Available tools

getDaos

Fetches all DAOs available in the Futarchy system, returning identifiers and basic metadata.

getDao

Retrieves detailed information for a specific DAO by its ID.

getProposals

Returns all proposals associated with a particular DAO ID.

getProposal

Fetches detailed information for a single proposal by its ID.

createProposal

Creates a new proposal for a specified DAO with provided description and LP parameters.