sns

This MCP server provides an interface to interact with SNS (Service Nervous System) DAOs on the Internet Computer. It exposes tools for common governance and wallet operations, including listing proposals for a DAO, listing votable neurons for a user, fetching system parameters, retrieving the current wallet principal, and voting on proposals. To run it, ensure you have built the TypeScript server and start it so it accepts MCP stdio communication. Once running, you can connect via an MCP client or Claude Desktop using the configured mcp-sns-server entry to perform the supported actions through the MCP protocol. The included tools are designed to help DAOs interact programmatically with governance flows without manually querying the SNS interfaces.

Prerequisites:

• Node.js (recommended LTS) and npm installed
• A .env file or environment variable SEED_PHRASE with your seed phrase

1. Install dependencies npm install

2. Build the server npm run build

3. (Optional) Enable auto-rebuild during development npm run watch

4. Run the server node build/index.js

5. Configure your MCP client (e.g., Claude Desktop) to connect to the server using the provided mcpServers entry.

• The server reads the seed phrase from an environment variable (SEED_PHRASE) or your .env file. Ensure this is kept secure.
• Debugging MCP servers is challenging because they communicate over stdio. Consider using the MCP Inspector for debugging, available via npm script: npm run inspector.
• The CLI tools exposed by the server include: list_proposals, list_votable_neurons, get_system_parameters, wallet, vote_proposal.
• When integrating with Claude Desktop, the example config shows how to reference the built server binary via build/index.js. Adjust the path to match your deployment structure.
• Ensure the server has network access to interact with SNS canisters if your deployment requires network calls.