DAO Proposals MCP

1# DAO Proposals MCP
2 
3An 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](https://snapshot.box/).
4 
5![GitHub License](https://img.shields.io/github/license/kukapay/dao-proposals-mcp) 
6![Python Version](https://img.shields.io/badge/python-3.10%2B-blue)
7![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
8 
9## Features
10 
11- **Tools**:
12  - `list_spaces`: Fetches a list of up to 10 recent Snapshot spaces, including their IDs, names, and descriptions.
13  - `list_proposals`: Retrieves up to 10 recent proposals for a given Snapshot space, including proposal IDs, titles, states, creation dates, and end dates.
14  - `get_proposal_details`: Fetches detailed information about a specific proposal, including its title, body, state, choices, scores, and vote counts.
15- **Prompt**:
16  - `summarize_proposals`: Generates a prompt to summarize recent proposals for a specified Snapshot space, leveraging the `list_proposals` tool.
17 
18## Prerequisites
19 
20- Python 3.10+
21- [uv](https://docs.astral.sh/uv/) (recommended) or pip for dependency management
22 
23## Installation
24 
251. Clone the repository:
26   ```bash
27   git clone https://github.com/kukapay/dao-proposals-mcp.git
28   cd dao-proposals-mcp
29   ```
30 
312. Install dependencies:
32   ```bash
33   uv sync
34   ```
35 
363. **Installing to Claude Desktop**:
37 
38    Install the server as a Claude Desktop application:
39    ```bash
40    uv run mcp install main.py --name "DAO Proposals"
41    ```
42 
43    Configuration file as a reference:
44 
45    ```json
46    {
47       "mcpServers": {
48           "DAO Proposals": {
49               "command": "uv",
50               "args": [ "--directory", "/path/to/dao-proposals-mcp", "run", "main.py" ]
51           }
52       }
53    }
54    ```
55    Replace `/path/to/dao-proposals-mcp` with your actual installation path.
56   
57## Usage
58 
59### Example Interactions
60 
611. **List Available Spaces**:
62   - **Prompt**:
63     ```plaintext
64     Can you show me a list of the most recent Snapshot spaces?
65     ```
66   - **Output**:
67     ```plaintext
68     Space ID: ens.eth
69     Name: ENS
70     About: Ethereum Name Service (ENS) is a decentralized naming system...
71     ---
72     Space ID: aave.eth
73     Name: Aave
74     About: Aave is a decentralized lending protocol...
75     ---
76     ```
77 
782. **List Proposals for a Space**:
79   - **Prompt**:
80     ```plaintext
81     Please list the recent proposals for the ENS DAO (space ID: ens.eth).
82     ```
83   - **Output**:
84     ```plaintext
85     Proposal ID: 0x123...
86     Title: Proposal to Update ENS Governance
87     State: Active
88     Created: 2025-07-01 12:00:00
89     End: 2025-07-08 12:00:00
90     ---
91     ```
92 
933. **Get Proposal Details**:
94   - **Prompt**:
95     ```plaintext
96     Can you give me detailed information about the proposal with ID 0x123...?
97     ```
98   - **Output**:
99     ```plaintext
100     Proposal ID: 0x123...
101     Title: Proposal to Update ENS Governance
102     State: Active
103     Created: 2025-07-01 12:00:00
104     End: 2025-07-08 12:00:00
105     Choices: Yes, No
106     Scores: [1500, 500]
107     Votes: 2000
108     ------
109     This proposal aims to update the governance structure of ENS...
110     ```
111 
1124. **Summarize Proposals**:
113   - **Prompt**:
114     ```plaintext
115     Summarize the recent proposals for the DAO with space ID 'ens.eth'.
116     ```
117   - **Output**:
118     ```plaintext
119     I'll use the list_proposals tool to fetch the proposals for ens.eth and provide a concise summary of their key points.
120     ```
121 
122## License
123 
124This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
125 
126