DAO Proposals

An MCP server that aggregates live governance proposals from major DAOs.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "kukapay-dao-proposals-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/dao-proposals-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

DAO Proposals MCP aggregates live governance proposals from major DAOs so you can track, analyze, and act on decentralized decisions in real time. It connects Snapshot data to your AI workflows, enabling rapid insight and automated responses to proposals as they evolve.

How to use

You interact with the DAO Proposals MCP using a compatible MCP client. The server exposes tools to fetch spaces and proposals, retrieve detailed proposal information, and generate summaries for quick briefing. Your practical workflows include listing spaces to discover governance domains, pulling recent proposals for a space, drilling into a specific proposal, and generating concise summaries to inform AI agents or human reviewers.

Typical usage pattern you will perform is to first fetch available spaces, then drill into a space to see recent proposals, and finally request detailed data for a selected proposal. You can also request a summary of recent proposals for a given space to orient AI agents with key points and potential actions.

How to install

Prerequisites you need before installing are Python version 3.10 or newer and the uv runtime (recommended) or pip for dependency management.

Step 1: Clone the project repository.

git clone https://github.com/kukapay/dao-proposals-mcp.git
cd dao-proposals-mcp

Step 2: Synchronize dependencies using uv.

uv sync

Step 3: Install the MCP server as a Claude Desktop application so you can run it locally within Claude’s environment.

uv run mcp install main.py --name "DAO Proposals"

Step 4: Use the provided MCP configuration example to reference the local installation path. Replace the path with where you installed the project.

{
  "mcpServers": {
    "DAO Proposals": {
      "command": "uv",
      "args": [ "--directory", "/path/to/dao-proposals-mcp", "run", "main.py" ]
    }
  }
}

Replace /path/to/dao-proposals-mcp with your actual installation path.

## Additional notes

The installation flow described includes installing to Claude Desktop and then referencing the local path in your MCP client so you can run the server as part of your automated workflows. Ensure the command and directory path precisely reflect where you placed the repository.

## Available tools

### list\_spaces

Fetches a list of up to 10 recent Snapshot spaces, including IDs, names, and descriptions.

### list\_proposals

Retrieves up to 10 recent proposals for a given Snapshot space, including IDs, titles, states, creation dates, and end dates.

### get\_proposal\_details

Fetches detailed information about a specific proposal, including title, body, state, choices, scores, and vote counts.

### summarize\_proposals

Generates a prompt to summarize recent proposals for a specified Snapshot space using the list\_proposals tool.