MCP Snapshot Server

🚀 MCP Snapshot Server

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

🚀 Quick Start

📦 Installation

npm install mcp-snapshot-server

💻 Usage Examples

Basic Usage in Claude Desktop

In your Claude desktop configuration 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 retrieve (optional).
• skip: Number of spaces to skip (optional).

getRankedSpaces

Get a ranked list of snapshot spaces and their details.

• first: Number of spaces to retrieve (default: 18).
• skip: Number of spaces to skip (default: 0).
• category: Filter by category (default: 'all').
• search: Filter spaces by search term (optional).

getProposals

Get a list of proposals for a specific space.

• spaceId: Space ID.
• state: Filter by proposal state (active, closed, pending, all).
• limit: Number of proposals to retrieve.

getProposal

Get detailed information about a specific proposal.

• proposalId: Proposal ID.

getUser

Get information about a specific user.

• address: Ethereum address.

🔨 Development

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build the project:

npm run build

📄 License

MIT © Dennison Bertram