kukapay/dao-proposals-mcp

DAO Proposals MCP

An MCP server that aggregates live governance proposals from major DAOs enabling AI agents to track, analyze, and act on decentralized decision-making in real time, powered by Snapshot.

Features

• Tools:
  • list_spaces: Fetches a list of up to 10 recent Snapshot spaces, including their IDs, names, and descriptions.
  • list_proposals: Retrieves up to 10 recent proposals for a given Snapshot space, including proposal IDs, titles, states, creation dates, and end dates.
  • get_proposal_details: Fetches detailed information about a specific proposal, including its title, body, state, choices, scores, and vote counts.
• Prompt:
  • summarize_proposals: Generates a prompt to summarize recent proposals for a specified Snapshot space, leveraging the list_proposals tool.

Prerequisites

• Python 3.10+
• uv (recommended) or pip for dependency management

Installation

1. Clone the repository:

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

2. Install dependencies:

   uv sync
   

3. Installing to Claude Desktop:

   Install the server as a Claude Desktop application:

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

   Configuration file as a reference:

   {
      "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.