What is Sns Mcp Server

sns-mcp-server is a Model Context Protocol server designed for interacting with Service Nervous System (SNS) decentralized autonomous organizations (DAOs) on the Internet Computer. It is built using TypeScript and provides an interface for users to engage with DAOs effectively.

Use cases

Use cases for sns-mcp-server include managing DAO proposals, participating in governance voting, retrieving DAO configurations, and managing user wallet information. It is useful for developers building applications that require DAO interactions and for users wanting to engage with decentralized organizations.

How to use

To use sns-mcp-server, first set up your environment by copying the example environment file and adding your seed phrase. Install the necessary dependencies using ‘npm install’, then build the server with ‘npm run build’. For development, you can use ‘npm run watch’ for auto-rebuild. Configure the server in Claude Desktop by adding the server path to the configuration file.

Key features

Key features of sns-mcp-server include: listing proposals for a specific DAO, listing votable neurons for a user, retrieving system parameters for a DAO, accessing wallet information, and voting on proposals. Each feature is designed to facilitate interaction with DAOs.

Where to use

sns-mcp-server is primarily used in the realm of decentralized finance (DeFi) and governance, particularly within the Internet Computer ecosystem. It is suitable for developers and users looking to interact with DAOs and participate in decentralized governance.

mcp-sns-server MCP Server

A Model Context Protocol server for interacting with DAOs on the Internet Computer

This is a TypeScript-based MCP server that implements an interface to Service Nervous System (SNS) DAOs. It demonstrates core MCP concepts by providing tools to interact with decentralized autonomous organizations.

Demo

Setup

add your seed phrase to env file

cp .env.example .env

Features

Tools

• list_proposals - List all proposals for a specific DAO

  • Takes DAO name as parameter
  • Returns list of proposals from the specified DAO

• list_votable_neurons - List all votable neurons for a user in a DAO

  • Takes DAO name and principal ID as parameters
  • Returns neurons that can vote on proposals

• get_system_parameters - List all configuration parameters for a DAO

  • Takes DAO name as parameter
  • Returns system parameters for the specified DAO

• wallet - Get the user’s wallet information

  • Returns the principal ID of the current wallet

• vote_proposal - Vote on a proposal

  • Takes DAO name, principal ID, neuron ID, proposal ID, and vote preference
  • Allows voting yes, no, or unspecified on proposals
  • Registers vote with the DAO governance system

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

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

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.