@voteship/mcp-server

MCP (Model Context Protocol) server for VoteShip — manage feature requests, votes, roadmaps, and AI workflows from any MCP-compatible client.

Installation

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "voteship": {
      "command": "npx",
      "args": ["@voteship/mcp-server"],
      "env": {
        "VOTESHIP_API_KEY": "sk_..."
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "mcpServers": {
    "voteship": {
      "command": "npx",
      "args": ["@voteship/mcp-server"],
      "env": {
        "VOTESHIP_API_KEY": "sk_..."
      }
    }
  }
}

Find your API key in VoteShip → Settings → Share & Embed.

Tools (22)

| Tool | Description | |------|-------------| | list_posts | List feature requests with optional filters | | get_post | Get a single post with votes, comments, tags | | create_post | Create a new feature request | | update_post | Update a post's title, description, status, or tags | | delete_post | Delete a feature request | | search_similar | Find similar posts using AI semantic search | | add_vote | Vote on a feature request | | get_voters | List who voted on a post | | add_comment | Add a comment to a post | | get_comments | List comments on a post | | list_tags | List all available tags | | create_tag | Create a new tag | | list_users | List board users | | get_roadmap | Get the product roadmap grouped by status | | get_analytics | Get analytics summary for a time period | | list_releases | List published changelog releases | | create_release | Create a changelog release | | submit_feedback | Submit unstructured text as a feature request (AI processes it) | | triage_inbox | AI-powered triage of unreviewed posts | | get_summary | AI-generated summary of recent feedback | | plan_sprint | AI-suggested sprint based on votes and themes | | configure_webhook | Set up a webhook for real-time events |

Resources (5)

| URI | Description | |-----|-------------| | voteship://project/overview | Project info and summary stats | | voteship://project/board | Full board state with all posts | | voteship://project/roadmap | Public roadmap view | | voteship://project/changelog | Published releases | | voteship://project/analytics | Analytics snapshot |

Prompts (4)

| Name | Description | |------|-------------| | triage_inbox | Review and categorize unprocessed feature requests | | sprint_planning | Suggest what to build next based on data | | generate_changelog | Draft release notes from recently completed posts | | feedback_summary | Summarize feedback trends and highlights |

Example Usage

In Claude Code:

> Triage my VoteShip inbox and suggest what to build this sprint

The agent will:

1. Fetch unreviewed posts and analyze them
2. Flag duplicates and suggest statuses
3. Recommend a sprint plan based on votes and themes
4. Generate changelog drafts for completed features

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | VOTESHIP_API_KEY | Yes | Your VoteShip API secret key (sk_...) | | VOTESHIP_API_URL | No | Custom API URL (default: https://app.voteship.app) |

License

MIT