MCP Snapshot Server

A MCP server for Snapshot

typescript

0

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks 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": {
    "crazyrabbitltc-mcp-snapshot-server": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/snapshot-server/build/index.js"
      ]
    }
  }
}

You can run the MCP Snapshot Server to query Snapshot.org data such as spaces, proposals, and users through the Model Context Protocol. This server exposes MCP endpoints that you can access from an MCP client to perform common Snapshot queries and operations in a standardized way.

How to use

Connect your MCP client to the Snapshot MCP server to fetch data about spaces, proposals, and users. You can request a list of spaces, retrieve ranked spaces with filters, pull proposals for a specific space, obtain details about a single proposal, or look up Snapshot users by their Ethereum address. Use the MCP client’s standard request flow to call the server's endpoints and handle responses in your application.

How to install

Prerequisites: you need Node.js installed on your system. Recommended LTS versions are supported. Ensure you have npm available to install dependencies.

Install the MCP Snapshot Server package from the npm registry.

Install the package globally or in your project and install dependencies.

Build the project if you are planning to run a built index.js file from the build output.

Optionally, configure the MCP client to run your local server using the provided CLI-like execution pattern shown in the configuration example.

The exact commands you will use are:

npm install mcp-snapshot-server

npm run build

Available tools

getSpaces

Fetch a list of Snapshot spaces with optional limits for pagination.

getRankedSpaces

Retrieve a ranked list of spaces with detailed information and optional filters such as category and search term.

getProposals

Get proposals for a specific space with optional state and limit filters.

getProposal

Obtain details for a specific proposal by its ID.

getUser

Retrieve information about a Snapshot user by their Ethereum address.