MCP Snapshot Server

A Model Context Protocol server for interacting with Snapshot.org. This server provides MCP-compliant tools for querying Snapshot spaces, proposals, and users.

Installation

npm install mcp-snapshot-server

Usage with Claude Desktop

In your Claude Desktop config file (located at ~/Library/Application Support/Claude/claude_desktop_config.json on Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
    "mcpServers": {
        "snapshot": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/snapshot-server/build/index.js"
            ]
        }
    }
}

Available Tools

getSpaces

Get a list of Snapshot spaces

limit: Number of spaces to fetch (optional)
skip: Number of spaces to skip (optional)

getRankedSpaces

Get a ranked list of Snapshot spaces with detailed information

first: Number of spaces to fetch (default: 18)
skip: Number of spaces to skip (default: 0)
category: Category to filter by (default: 'all')
search: Search term to filter spaces (optional)

getProposals

Get proposals for a specific space

spaceId: ID of the space
state: Filter by proposal state (active, closed, pending, all)
limit: Number of proposals to fetch

getProposal

Get details of a specific proposal

proposalId: ID of the proposal

getUser

Get information about a Snapshot user

address: Ethereum address of the user

Development

Clone the repository:

git clone https://github.com/crazyrabbitLTC/mcp-snapshot-server.git

Install dependencies:

npm install

Build the project:

npm run build