Futarchy

You can run the Futarchy MCP Server to expose Futarchy-backed data and actions to MCP clients like Cursor. This server lets you access DAOs, proposals, and proposals sentiment through a set of MCP endpoints, and it can be integrated with Cursor via a dedicated MCP server configuration.

How to use

Use the MCP client tools to interact with Futarchy-backed data. Retrieve all DAOs, fetch a specific DAO by ID, list proposals for a DAO, and create new proposals for a DAO. A specialized sentiment analysis tool is available to summarize community sentiment about proposals. These tools are exposed through MCP endpoints and can be invoked from Cursor or other MCP clients.

How to install

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

Clone the project repository and enter the project directory.

git clone <repository-url>
cd futarchy-mcp

How to install continued

Install dependencies for the MCP server.

npm install

Configure RPC URL

Open the main server file and set your Solana RPC endpoint. Replace the placeholder with your chosen RPC URL.

const connection = new Connection('YOUR_RPC_URL_HERE');

Start the development server

Run the development server to start serving MCP endpoints.

npm run dev

MCP server for Cursor configuration

The project includes an MCP server configuration you can load into Cursor so you can call Futarchy endpoints from Cursor chat.

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

Using the MCP server in Cursor

From Cursor you can invoke the exposed endpoints using the following tools: getDaos, getDao, getProposals, getProposal, createProposal, and the sentiment analysis tool getProposalSentiment. These tools let you fetch data or propose new content directly from chat.

Additional notes

If you want to build and run the MCP server locally for Cursor integration, you can use the provided setup steps or manual steps to install dependencies, build, and configure the MCP environment. A dedicated configuration file can be placed at your Cursor setup path (for example ~/.cursor/mcp.json) to register the futarchy-routes MCP server.

Available tools

getDaos

Fetches the list of all DAOs available in the Futarchy MCP backend.

getDao

Retrieves a specific DAO by its ID.

getProposals

Retrieves all proposals for a given DAO by its ID.

getProposal

Fetches a single proposal by its ID.

createProposal

Creates a new proposal for a specified DAO with the provided details.

getProposalSentiment

Performs sentiment analysis on data related to a specific proposal and returns a structured sentiment report.