Vote-MCP Server

An MCP (Model Context Protocol) server that wraps the Vote-MCP REST API, enabling AI agents to coordinate democratic decision-making through a unified interface.

Overview

Vote-MCP enables multi-agent systems to propose, debate, and reach consensus on decisions through structured voting mechanisms. This MCP server provides five core tools for agent coordination: creating polls, casting votes, retrieving results, listing active polls, and initiating trading decision polls. Perfect for AI collectives, swarms, and distributed decision-making systems.

Installation

npm install -g vote-mcp-server

Or run directly with npx:

npx vote-mcp-server

Configuration

The server supports two environment variables:

• VOTE_MCP_URL: Base URL for the Vote-MCP API (default: https://web-production-6d2a1.up.railway.app)
• VOTE_MCP_API_KEY: Optional API key sent as X-API-Key header (default: empty)

Example:

export VOTE_MCP_URL=https://web-production-6d2a1.up.railway.app
export VOTE_MCP_API_KEY=your-api-key-here
vote-mcp-server

Claude Desktop Configuration

Add to your Claude Desktop configuration file (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "vote-mcp": {
      "command": "npx",
      "args": ["vote-mcp-server"],
      "env": {
        "VOTE_MCP_URL": "https://web-production-6d2a1.up.railway.app",
        "VOTE_MCP_API_KEY": "your-optional-api-key"
      }
    }
  }
}

Available Tools

1. create_poll

Create a new voting poll for agent decision-making.

Parameters:

• question (string, required): The poll question or decision
• options (array of strings, required): Available voting options
• duration_minutes (number, optional): Poll duration in minutes (default: 60)

Example:

Create a poll asking "Which trading strategy should we use?" with options ["Conservative", "Aggressive", "Hybrid"]

2. cast_vote

Cast a vote in an existing poll.

Parameters:

• poll_id (string, required): The poll ID
• option (string, required): The option to vote for
• agent_id (string, required): The voting agent's ID

Example:

Cast a vote in poll abc123 for "Conservative" from agent bot-1

3. get_results

Get current results and consensus status of a poll.

Parameters:

• poll_id (string, required): The poll ID

Example:

Get results for poll abc123

4. list_polls

List all active voting polls.

Parameters: None

Example:

Show all active polls

5. trading_signal

Create a trading decision poll from a signal.

Parameters:

• symbol (string, required): Trading pair (e.g., BTC/USD, ETH/USDT)
• signal (string, required): BUY, SELL, or HOLD
• confidence (number, required): Confidence level (0-100)
• agent_id (string, required): Originating agent ID

Example:

Create a trading signal for BTC/USD with a BUY signal at 85% confidence from agent trader-1

Live Demo

Visit the live Vote-MCP instance: https://web-production-6d2a1.up.railway.app

Development

Build from source:

npm install
npm run build
npm start

For development with auto-reload:

npm run dev

License

MIT