home / mcp / mcp-sns-server mcp server

mcp-sns-server MCP Server

mcp server for sns

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "baolongt-sns-mcp-server": {
      "command": "/path/to/mcp-sns-server/build/index.js",
      "args": [],
      "env": {
        "SEED_PHRASE": "YOUR_SEED_PHRASE"
      }
    }
  }
}

You are building an MCP Server that interfaces with SNS DAOs on the Internet Computer. This server provides practical tools to query proposals, inspect votable neurons, retrieve system parameters, manage your wallet, and cast votes on proposals, enabling you to interact with SNS governance from an MCP-enabled client.

How to use

You can interact with the SNS MCP server using an MCP client to perform common governance tasks. Use the provided tools to list proposals for a specific DAO, check which neurons you can vote with, view configuration parameters, inspect your wallet, and cast votes on proposals. The server is designed to be run locally or connected via an MCP-enabled application, making it simpler to automate governance workflows and integrate SNS decisions into your tools.

How to install

Prerequisites: ensure you have Node.js installed on your system and a suitable shell environment.

cp .env.example .env
npm install
npm run build
npm run watch

Additional sections

Configuration notes and development workflow details are included below. You will set a seed phrase in the environment to enable wallet interactions, and you can run the server in development mode to auto-rebuild on changes.

Example MCP server configuration for Claude Desktop clients (as shown in the setup guide) demonstrates how to register the server so clients can locate and start it. Use the following JSON snippet to configure Claude Desktop to run your MCP server locally.

{
  "mcpServers": {
    "mcp-sns-server": {
      "command": "/path/to/mcp-sns-server/build/index.js"
    }
  }
}

Available tools

list_proposals

List all proposals for a specific DAO. Requires the DAO name and returns the proposals.

list_votable_neurons

List all votable neurons for a user in a DAO. Requires DAO name and your principal ID.

get_system_parameters

List all configuration parameters for a DAO. Requires the DAO name.

wallet

Get the user’s wallet information. Returns the current wallet principal ID.

vote_proposal

Vote on a proposal. Requires DAO name, principal ID, neuron ID, proposal ID, and a vote preference (yes, no, or unspecified).