@voteship/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,114 @@
+# @voteship/mcp-server
+
+MCP (Model Context Protocol) server for [VoteShip](https://voteship.app) — manage feature requests, votes, roadmaps, and AI workflows from any MCP-compatible client.
+
+## Installation
+
+### Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "voteship": {
+      "command": "npx",
+      "args": ["@voteship/mcp-server"],
+      "env": {
+        "VOTESHIP_API_KEY": "sk_..."
+      }
+    }
+  }
+}
+```
+
+### Cursor / Windsurf
+
+Add to your MCP settings:
+
+```json
+{
+  "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

package/dist/auth.d.ts

@@ -0,0 +1,5 @@
+/**
+ * API key configuration — reads from VOTESHIP_API_KEY environment variable.
+ */
+export declare function getApiKey(): string;
+export declare function getBaseUrl(): string;

package/dist/auth.js

@@ -0,0 +1,17 @@
+/**
+ * API key configuration — reads from VOTESHIP_API_KEY environment variable.
+ */
+export function getApiKey() {
+    const key = process.env.VOTESHIP_API_KEY;
+    if (!key) {
+        console.error("VOTESHIP_API_KEY environment variable is required.\n" +
+            "Set it in your MCP config:\n" +
+            '  "env": { "VOTESHIP_API_KEY": "sk_..." }\n' +
+            "Find your API key in VoteShip → Settings → Share & Embed");
+        process.exit(1);
+    }
+    return key;
+}
+export function getBaseUrl() {
+    return process.env.VOTESHIP_API_URL || "https://app.voteship.app";
+}

package/dist/client.d.ts

@@ -0,0 +1,85 @@
+/**
+ * HTTP client wrapping the VoteShip REST API v1.
+ */
+export declare class VoteShipClient {
+    private apiKey;
+    private baseUrl;
+    constructor();
+    private request;
+    listPosts(params?: {
+        status?: string;
+        sort?: string;
+        limit?: number;
+        page?: number;
+    }): Promise<unknown>;
+    getPost(postId: string): Promise<unknown>;
+    createPost(data: {
+        title: string;
+        description?: string;
+        status?: string;
+        tagIds?: string[];
+    }): Promise<unknown>;
+    updatePost(postId: string, data: {
+        title?: string;
+        description?: string;
+        status?: string;
+        tagIds?: string[];
+    }): Promise<unknown>;
+    deletePost(postId: string): Promise<unknown>;
+    searchSimilar(params: {
+        query: string;
+        threshold?: number;
+        limit?: number;
+    }): Promise<unknown>;
+    addVote(postId: string, data?: {
+        boardUserId?: string;
+        anonymousId?: string;
+    }): Promise<unknown>;
+    getVoters(postId: string): Promise<unknown>;
+    addComment(postId: string, data: {
+        body: string;
+        authorName?: string;
+    }): Promise<unknown>;
+    getComments(postId: string): Promise<unknown>;
+    listTags(): Promise<unknown>;
+    createTag(data: {
+        label: string;
+        theme?: string;
+    }): Promise<unknown>;
+    listUsers(params?: {
+        limit?: number;
+        page?: number;
+    }): Promise<unknown>;
+    getRoadmap(): Promise<unknown>;
+    listReleases(params?: {
+        limit?: number;
+    }): Promise<unknown>;
+    createRelease(data: {
+        title: string;
+        content: string;
+        isDraft?: boolean;
+    }): Promise<unknown>;
+    getAnalytics(params?: {
+        period?: string;
+    }): Promise<unknown>;
+    submitFeedback(data: {
+        text: string;
+        source?: string;
+        source_url?: string;
+    }): Promise<unknown>;
+    triageInbox(params?: {
+        limit?: number;
+    }): Promise<unknown>;
+    getSummary(params?: {
+        period?: string;
+    }): Promise<unknown>;
+    planSprint(params?: {
+        capacity?: number;
+        strategy?: string;
+    }): Promise<unknown>;
+    configureWebhook(data: {
+        url: string;
+        events: string[];
+        description?: string;
+    }): Promise<unknown>;
+}

package/dist/client.js

@@ -0,0 +1,136 @@
+import { getApiKey, getBaseUrl } from "./auth.js";
+/**
+ * HTTP client wrapping the VoteShip REST API v1.
+ */
+export class VoteShipClient {
+    apiKey;
+    baseUrl;
+    constructor() {
+        this.apiKey = getApiKey();
+        this.baseUrl = `${getBaseUrl()}/api/v1`;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const data = await response.json();
+        if (!response.ok) {
+            const errorMsg = data.message || data.error || `HTTP ${response.status}`;
+            throw new Error(errorMsg);
+        }
+        return data;
+    }
+    // --- Posts ---
+    async listPosts(params) {
+        const query = new URLSearchParams();
+        if (params?.status)
+            query.set("status", params.status);
+        if (params?.sort)
+            query.set("sort", params.sort);
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        if (params?.page)
+            query.set("page", String(params.page));
+        const qs = query.toString();
+        return this.request("GET", `/posts${qs ? `?${qs}` : ""}`);
+    }
+    async getPost(postId) {
+        return this.request("GET", `/posts/${postId}`);
+    }
+    async createPost(data) {
+        return this.request("POST", "/posts", data);
+    }
+    async updatePost(postId, data) {
+        return this.request("PATCH", `/posts/${postId}`, data);
+    }
+    async deletePost(postId) {
+        return this.request("DELETE", `/posts/${postId}`);
+    }
+    // --- Similar / Search ---
+    async searchSimilar(params) {
+        const query = new URLSearchParams({ query: params.query });
+        if (params.threshold)
+            query.set("threshold", String(params.threshold));
+        if (params.limit)
+            query.set("limit", String(params.limit));
+        return this.request("GET", `/posts/similar?${query}`);
+    }
+    // --- Votes ---
+    async addVote(postId, data) {
+        return this.request("POST", `/posts/${postId}/votes`, data);
+    }
+    async getVoters(postId) {
+        return this.request("GET", `/posts/${postId}/votes`);
+    }
+    // --- Comments ---
+    async addComment(postId, data) {
+        return this.request("POST", `/posts/${postId}/comments`, data);
+    }
+    async getComments(postId) {
+        return this.request("GET", `/posts/${postId}/comments`);
+    }
+    // --- Tags ---
+    async listTags() {
+        return this.request("GET", "/tags");
+    }
+    async createTag(data) {
+        return this.request("POST", "/tags", data);
+    }
+    // --- Users ---
+    async listUsers(params) {
+        const query = new URLSearchParams();
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        if (params?.page)
+            query.set("page", String(params.page));
+        const qs = query.toString();
+        return this.request("GET", `/users${qs ? `?${qs}` : ""}`);
+    }
+    // --- Roadmap ---
+    async getRoadmap() {
+        return this.request("GET", "/roadmap");
+    }
+    // --- Releases ---
+    async listReleases(params) {
+        const query = new URLSearchParams();
+        if (params?.limit)
+            query.set("limit", String(params.limit));
+        const qs = query.toString();
+        return this.request("GET", `/releases${qs ? `?${qs}` : ""}`);
+    }
+    async createRelease(data) {
+        return this.request("POST", "/releases", data);
+    }
+    // --- Analytics ---
+    async getAnalytics(params) {
+        const query = new URLSearchParams();
+        if (params?.period)
+            query.set("period", params.period);
+        const qs = query.toString();
+        return this.request("GET", `/analytics/summary${qs ? `?${qs}` : ""}`);
+    }
+    // --- AI Workflows ---
+    async submitFeedback(data) {
+        return this.request("POST", "/posts/from-text", data);
+    }
+    async triageInbox(params) {
+        return this.request("POST", "/ai/triage", params);
+    }
+    async getSummary(params) {
+        return this.request("POST", "/ai/summary", params);
+    }
+    async planSprint(params) {
+        return this.request("POST", "/ai/sprint-plan", params);
+    }
+    // --- Webhooks ---
+    async configureWebhook(data) {
+        return this.request("POST", "/integrations/webhooks", data);
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { VoteShipClient } from "./client.js";
+// Tools
+import { registerPostTools } from "./tools/posts.js";
+import { registerSearchTools } from "./tools/search.js";
+import { registerVoteTools } from "./tools/votes.js";
+import { registerCommentTools } from "./tools/comments.js";
+import { registerTagTools } from "./tools/tags.js";
+import { registerUserTools } from "./tools/users.js";
+import { registerRoadmapTools } from "./tools/roadmap.js";
+import { registerReleaseTools } from "./tools/releases.js";
+import { registerAnalyticsTools } from "./tools/analytics.js";
+import { registerAiTools } from "./tools/ai.js";
+import { registerWebhookTools } from "./tools/webhooks.js";
+// Resources
+import { registerProjectResources } from "./resources/project.js";
+import { registerRoadmapResources } from "./resources/roadmap.js";
+import { registerChangelogResources } from "./resources/changelog.js";
+import { registerAnalyticsResources } from "./resources/analytics.js";
+// Prompts
+import { registerTriagePrompt } from "./prompts/triage.js";
+import { registerSprintPrompt } from "./prompts/sprint.js";
+import { registerChangelogPrompt } from "./prompts/changelog.js";
+import { registerSummaryPrompt } from "./prompts/summary.js";
+async function main() {
+    const server = new McpServer({
+        name: "VoteShip",
+        version: "0.1.0",
+    });
+    const client = new VoteShipClient();
+    // Register all tools (22 total)
+    registerPostTools(server, client);
+    registerSearchTools(server, client);
+    registerVoteTools(server, client);
+    registerCommentTools(server, client);
+    registerTagTools(server, client);
+    registerUserTools(server, client);
+    registerRoadmapTools(server, client);
+    registerReleaseTools(server, client);
+    registerAnalyticsTools(server, client);
+    registerAiTools(server, client);
+    registerWebhookTools(server, client);
+    // Register all resources (5 total)
+    registerProjectResources(server, client);
+    registerRoadmapResources(server, client);
+    registerChangelogResources(server, client);
+    registerAnalyticsResources(server, client);
+    // Register all prompts (4 total)
+    registerTriagePrompt(server);
+    registerSprintPrompt(server);
+    registerChangelogPrompt(server);
+    registerSummaryPrompt(server);
+    // Start the server on stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Failed to start VoteShip MCP server:", error);
+    process.exit(1);
+});

package/dist/prompts/changelog.d.ts

@@ -0,0 +1 @@
+export declare function registerChangelogPrompt(server: any): void;

package/dist/prompts/changelog.js

@@ -0,0 +1,32 @@
+export function registerChangelogPrompt(server) {
+    server.prompt("generate_changelog", "Draft release notes from recently completed feature requests", [
+        {
+            name: "period",
+            description: "Time period to look back: week, month, or quarter (default: month)",
+            required: false,
+        },
+    ], async (params) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `You are a product marketer writing changelog entries for VoteShip. Follow this workflow:
+
+1. Use \`list_posts\` with status=COMPLETE to find recently completed features
+2. Use \`list_releases\` to see the most recent published release (to avoid duplicates)
+3. Draft a professional, user-facing changelog entry that:
+   - Groups features into logical categories
+   - Uses clear, non-technical language
+   - Highlights the user benefit of each feature
+   - Mentions vote counts to show community impact
+4. Use \`create_release\` to publish the changelog with is_draft=true so it can be reviewed
+
+Period to cover: ${params.period || "month"}
+
+Start by calling \`list_posts\` with status=COMPLETE.`,
+                },
+            },
+        ],
+    }));
+}

package/dist/prompts/sprint.d.ts

@@ -0,0 +1 @@
+export declare function registerSprintPrompt(server: any): void;

package/dist/prompts/sprint.js

@@ -0,0 +1,36 @@
+export function registerSprintPrompt(server) {
+    server.prompt("sprint_planning", "Suggest what to build next based on votes, themes, and prioritization strategy", [
+        {
+            name: "capacity",
+            description: "Number of features for the sprint (default: 5)",
+            required: false,
+        },
+        {
+            name: "strategy",
+            description: "Prioritization: balanced, revenue, popular, or quick-wins (default: balanced)",
+            required: false,
+        },
+    ], async (params) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `You are a product manager planning the next sprint using VoteShip data. Follow this workflow:
+
+1. Use \`get_roadmap\` to see what's currently planned and in progress
+2. Use \`plan_sprint\` with capacity=${params.capacity || "5"} and strategy="${params.strategy || "balanced"}" to get AI recommendations
+3. Review the suggestions — each has effort/impact estimates and reasoning
+4. Use \`get_analytics\` to check recent trends and validate the plan
+5. Present the final sprint plan with:
+   - Selected features with their vote counts and tags
+   - Reasoning for each selection
+   - Any features that were close but didn't make the cut
+   - Suggested order of implementation
+
+Start by calling \`get_roadmap\` to understand the current state.`,
+                },
+            },
+        ],
+    }));
+}

package/dist/prompts/summary.d.ts

@@ -0,0 +1 @@
+export declare function registerSummaryPrompt(server: any): void;

package/dist/prompts/summary.js

@@ -0,0 +1,31 @@
+export function registerSummaryPrompt(server) {
+    server.prompt("feedback_summary", "Summarize feedback trends, highlights, and actionable insights for a time period", [
+        {
+            name: "period",
+            description: "Time period: week, month, or quarter (default: week)",
+            required: false,
+        },
+    ], async (params) => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `You are a product analyst summarizing feedback from VoteShip. Follow this workflow:
+
+1. Use \`get_summary\` with period="${params.period || "week"}" to get an AI-generated summary with stats
+2. Use \`get_analytics\` with period="${params.period || "week"}" to get detailed metrics
+3. Use \`get_roadmap\` to see how current plans align with feedback
+4. Present a comprehensive report covering:
+   - Key metrics (new posts, votes, comments, page views)
+   - Top trending features and themes
+   - Notable patterns or shifts in user sentiment
+   - Recommended actions for the product team
+   - Features that may need reprioritization based on new data
+
+Start by calling \`get_summary\`.`,
+                },
+            },
+        ],
+    }));
+}

package/dist/prompts/triage.d.ts

@@ -0,0 +1 @@
+export declare function registerTriagePrompt(server: any): void;

package/dist/prompts/triage.js

@@ -0,0 +1,23 @@
+export function registerTriagePrompt(server) {
+    server.prompt("triage_inbox", "Review and categorize unprocessed feature requests — detect duplicates, suggest statuses and tags, flag spam", async () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `You are a product manager triaging VoteShip feature requests. Follow this workflow:
+
+1. First, use the \`triage_inbox\` tool to get AI-powered recommendations for pending posts
+2. Review the recommendations — they include suggested status, tags, priority, and duplicate detection
+3. For each recommendation:
+   - If the suggestion looks correct, use \`update_post\` to apply the status and tags
+   - If a duplicate is detected (similarity > 0.85), consider merging or closing the duplicate
+   - If the post looks like spam, update status to CLOSED
+4. After processing, use \`get_summary\` to generate a summary of what was triaged
+
+Start by calling the \`triage_inbox\` tool now.`,
+                },
+            },
+        ],
+    }));
+}

package/dist/resources/analytics.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerAnalyticsResources(server: any, client: VoteShipClient): void;

package/dist/resources/analytics.js

@@ -0,0 +1,14 @@
+export function registerAnalyticsResources(server, client) {
+    server.resource("project-analytics", "voteship://project/analytics", "Analytics snapshot — daily stats, top posts, and trending tags for the past week", async () => {
+        const result = await client.getAnalytics({ period: "week" });
+        return {
+            contents: [
+                {
+                    uri: "voteship://project/analytics",
+                    mimeType: "application/json",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}

package/dist/resources/changelog.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerChangelogResources(server: any, client: VoteShipClient): void;

package/dist/resources/changelog.js

@@ -0,0 +1,14 @@
+export function registerChangelogResources(server, client) {
+    server.resource("project-changelog", "voteship://project/changelog", "Published changelog releases — recent product updates and shipped features", async () => {
+        const result = await client.listReleases({ limit: 20 });
+        return {
+            contents: [
+                {
+                    uri: "voteship://project/changelog",
+                    mimeType: "application/json",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}

package/dist/resources/project.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerProjectResources(server: any, client: VoteShipClient): void;

package/dist/resources/project.js

@@ -0,0 +1,35 @@
+export function registerProjectResources(server, client) {
+    server.resource("project-overview", "voteship://project/overview", "Project summary with key stats — post counts, vote counts, and configuration", async () => {
+        const [postsData, tagsData, usersData] = await Promise.all([
+            client.listPosts({ limit: 1 }),
+            client.listTags(),
+            client.listUsers({ limit: 1 }),
+        ]);
+        const summary = {
+            total_posts: postsData.pagination?.total ?? 0,
+            total_users: usersData.pagination?.total ?? 0,
+            tags: (tagsData.data ?? []).map((t) => t.label),
+        };
+        return {
+            contents: [
+                {
+                    uri: "voteship://project/overview",
+                    mimeType: "application/json",
+                    text: JSON.stringify(summary, null, 2),
+                },
+            ],
+        };
+    });
+    server.resource("project-board", "voteship://project/board", "Full board state — all posts grouped by status with tags and vote counts", async () => {
+        const result = await client.listPosts({ limit: 100 });
+        return {
+            contents: [
+                {
+                    uri: "voteship://project/board",
+                    mimeType: "application/json",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}

package/dist/resources/roadmap.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerRoadmapResources(server: any, client: VoteShipClient): void;

package/dist/resources/roadmap.js

@@ -0,0 +1,14 @@
+export function registerRoadmapResources(server, client) {
+    server.resource("project-roadmap", "voteship://project/roadmap", "Public roadmap — approved, in-progress, and completed features sorted by votes", async () => {
+        const result = await client.getRoadmap();
+        return {
+            contents: [
+                {
+                    uri: "voteship://project/roadmap",
+                    mimeType: "application/json",
+                    text: JSON.stringify(result, null, 2),
+                },
+            ],
+        };
+    });
+}

package/dist/tools/ai.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerAiTools(server: any, client: VoteShipClient): void;

package/dist/tools/ai.js

@@ -0,0 +1,29 @@
+export function registerAiTools(server, client) {
+    server.tool("submit_feedback", "Submit unstructured text as a feature request. AI extracts the title, description, checks for duplicates, and auto-categorizes with tags. Great for processing Slack messages, emails, or support tickets.", {
+        text: { type: "string", description: "Raw text describing a feature request, e.g. 'Multiple customers asked for PDF export'" },
+        source: { type: "string", description: "Where the feedback came from: slack, email, support, intercom, etc." },
+        source_url: { type: "string", description: "URL to the original message (e.g. Slack permalink)" },
+    }, async (params) => {
+        const result = await client.submitFeedback(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("triage_inbox", "AI-powered triage of unreviewed feature requests. Analyzes pending posts, detects duplicates, suggests status/tags, and provides priority recommendations. Requires Growth plan.", {
+        limit: { type: "number", description: "Maximum posts to triage (default: 20, max: 50)" },
+    }, async (params) => {
+        const result = await client.triageInbox(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("get_summary", "Generate an AI-powered natural language summary of recent feedback trends, highlights, and recommended actions. Requires Growth plan.", {
+        period: { type: "string", description: "Time period: week, month, or quarter (default: week)" },
+    }, async (params) => {
+        const result = await client.getSummary(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("plan_sprint", "AI-suggested sprint plan based on approved feature requests, votes, tags, and the selected prioritization strategy. Requires Growth plan.", {
+        capacity: { type: "number", description: "Number of features to include in the sprint (default: 5, max: 20)" },
+        strategy: { type: "string", description: "Prioritization strategy: balanced, revenue, popular, or quick-wins (default: balanced)" },
+    }, async (params) => {
+        const result = await client.planSprint(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/analytics.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerAnalyticsTools(server: any, client: VoteShipClient): void;

package/dist/tools/analytics.js

@@ -0,0 +1,8 @@
+export function registerAnalyticsTools(server, client) {
+    server.tool("get_analytics", "Get analytics summary — new posts, votes, comments, page views, top posts, and trending tags for a given time period", {
+        period: { type: "string", description: "Time period: week, month, or quarter (default: week)" },
+    }, async (params) => {
+        const result = await client.getAnalytics(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/comments.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerCommentTools(server: any, client: VoteShipClient): void;

package/dist/tools/comments.js

@@ -0,0 +1,19 @@
+export function registerCommentTools(server, client) {
+    server.tool("add_comment", "Add a comment to a feature request post", {
+        post_id: { type: "string", description: "The post ID to comment on" },
+        body: { type: "string", description: "Comment text content" },
+        author_name: { type: "string", description: "Display name for the comment author" },
+    }, async (params) => {
+        const result = await client.addComment(params.post_id, {
+            body: params.body,
+            authorName: params.author_name,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("get_comments", "List all comments on a feature request post", {
+        post_id: { type: "string", description: "The post ID to get comments for" },
+    }, async (params) => {
+        const result = await client.getComments(params.post_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/posts.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerPostTools(server: any, client: VoteShipClient): void;

package/dist/tools/posts.js

@@ -0,0 +1,54 @@
+export function registerPostTools(server, client) {
+    server.tool("list_posts", "List feature requests with optional filters for status, sorting, and pagination", {
+        status: { type: "string", description: "Filter by status: PENDING, APPROVED, IN_PROGRESS, COMPLETE, CLOSED" },
+        sort: { type: "string", description: "Sort order: votes (default) or date" },
+        limit: { type: "number", description: "Results per page (default: 50, max: 100)" },
+        page: { type: "number", description: "Page number (default: 1)" },
+    }, async (params) => {
+        const result = await client.listPosts(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("get_post", "Get a single feature request post with its votes, comments, and tags", {
+        post_id: { type: "string", description: "The post ID to retrieve" },
+    }, async (params) => {
+        const result = await client.getPost(params.post_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("create_post", "Create a new feature request post. Title is required. Status defaults to PENDING if not provided.", {
+        title: { type: "string", description: "Feature request title (max 200 chars)" },
+        description: { type: "string", description: "Detailed description of the feature request" },
+        status: { type: "string", description: "Initial status: PENDING, APPROVED, IN_PROGRESS, COMPLETE, CLOSED" },
+        tag_ids: { type: "string", description: "Comma-separated tag IDs to attach" },
+    }, async (params) => {
+        const tagIds = params.tag_ids ? params.tag_ids.split(",").map((s) => s.trim()) : undefined;
+        const result = await client.createPost({
+            title: params.title,
+            description: params.description,
+            status: params.status,
+            tagIds,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("update_post", "Update an existing post's title, description, status, or tags. Only include fields you want to change.", {
+        post_id: { type: "string", description: "The post ID to update" },
+        title: { type: "string", description: "New title (max 200 chars)" },
+        description: { type: "string", description: "New description" },
+        status: { type: "string", description: "New status: PENDING, APPROVED, IN_PROGRESS, COMPLETE, CLOSED" },
+        tag_ids: { type: "string", description: "Comma-separated tag IDs (replaces all existing tags)" },
+    }, async (params) => {
+        const tagIds = params.tag_ids ? params.tag_ids.split(",").map((s) => s.trim()) : undefined;
+        const result = await client.updatePost(params.post_id, {
+            title: params.title,
+            description: params.description,
+            status: params.status,
+            tagIds,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("delete_post", "Permanently delete a feature request and all its associated votes and comments", {
+        post_id: { type: "string", description: "The post ID to delete" },
+    }, async (params) => {
+        const result = await client.deletePost(params.post_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/releases.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerReleaseTools(server: any, client: VoteShipClient): void;

package/dist/tools/releases.js

@@ -0,0 +1,20 @@
+export function registerReleaseTools(server, client) {
+    server.tool("list_releases", "List published changelog releases", {
+        limit: { type: "number", description: "Number of releases to return (default: 20)" },
+    }, async (params) => {
+        const result = await client.listReleases(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("create_release", "Create a new changelog release. Publishes immediately unless is_draft is true.", {
+        title: { type: "string", description: "Release title, e.g. 'January 2026 Update'" },
+        content: { type: "string", description: "Release notes content (HTML supported)" },
+        is_draft: { type: "boolean", description: "Save as draft (true) or publish immediately (false, default)" },
+    }, async (params) => {
+        const result = await client.createRelease({
+            title: params.title,
+            content: params.content,
+            isDraft: params.is_draft,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/roadmap.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerRoadmapTools(server: any, client: VoteShipClient): void;

package/dist/tools/roadmap.js

@@ -0,0 +1,6 @@
+export function registerRoadmapTools(server, client) {
+    server.tool("get_roadmap", "Get the product roadmap — feature requests grouped by status (Approved, In Progress, Complete), sorted by vote count", {}, async () => {
+        const result = await client.getRoadmap();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/search.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerSearchTools(server: any, client: VoteShipClient): void;

package/dist/tools/search.js

@@ -0,0 +1,10 @@
+export function registerSearchTools(server, client) {
+    server.tool("search_similar", "Find similar feature requests using AI semantic search (pgvector). Useful for checking if a request already exists before creating a new one.", {
+        query: { type: "string", description: "Natural language search query, e.g. 'export data as PDF'" },
+        threshold: { type: "number", description: "Minimum similarity score 0-1 (default: 0.7)" },
+        limit: { type: "number", description: "Maximum results to return (default: 5, max: 20)" },
+    }, async (params) => {
+        const result = await client.searchSimilar(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/tags.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerTagTools(server: any, client: VoteShipClient): void;

package/dist/tools/tags.js

@@ -0,0 +1,13 @@
+export function registerTagTools(server, client) {
+    server.tool("list_tags", "List all available tags for categorizing feature requests", {}, async () => {
+        const result = await client.listTags();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("create_tag", "Create a new tag for categorizing feature requests", {
+        label: { type: "string", description: "Tag name, e.g. 'Mobile', 'Performance', 'UI'" },
+        theme: { type: "string", description: "Hex color for the tag, e.g. '#6366f1'" },
+    }, async (params) => {
+        const result = await client.createTag(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/users.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerUserTools(server: any, client: VoteShipClient): void;

package/dist/tools/users.js

@@ -0,0 +1,9 @@
+export function registerUserTools(server, client) {
+    server.tool("list_users", "List board users who have submitted feedback or voted on feature requests", {
+        limit: { type: "number", description: "Results per page (default: 50, max: 100)" },
+        page: { type: "number", description: "Page number (default: 1)" },
+    }, async (params) => {
+        const result = await client.listUsers(params);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/votes.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerVoteTools(server: any, client: VoteShipClient): void;

package/dist/tools/votes.js

@@ -0,0 +1,19 @@
+export function registerVoteTools(server, client) {
+    server.tool("add_vote", "Add a vote to a feature request. Optionally specify a board user ID or anonymous ID.", {
+        post_id: { type: "string", description: "The post ID to vote on" },
+        board_user_id: { type: "string", description: "Board user ID (for identified users)" },
+        anonymous_id: { type: "string", description: "Anonymous ID (for unidentified users)" },
+    }, async (params) => {
+        const result = await client.addVote(params.post_id, {
+            boardUserId: params.board_user_id,
+            anonymousId: params.anonymous_id,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("get_voters", "List all users who voted on a specific feature request", {
+        post_id: { type: "string", description: "The post ID to get voters for" },
+    }, async (params) => {
+        const result = await client.getVoters(params.post_id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/webhooks.d.ts

@@ -0,0 +1,2 @@
+import type { VoteShipClient } from "../client.js";
+export declare function registerWebhookTools(server: any, client: VoteShipClient): void;

package/dist/tools/webhooks.js

@@ -0,0 +1,15 @@
+export function registerWebhookTools(server, client) {
+    server.tool("configure_webhook", "Create a new webhook endpoint to receive real-time notifications. Events: post.created, post.updated, post.deleted, post.status_changed, vote.created, vote.removed, comment.created, comment.deleted, tag.created, tag.deleted, release.published, or * for all.", {
+        url: { type: "string", description: "The HTTPS URL to receive webhook POST requests" },
+        events: { type: "string", description: "Comma-separated event types to subscribe to, e.g. 'post.created,vote.created' or '*' for all" },
+        description: { type: "string", description: "Human-readable description of this webhook" },
+    }, async (params) => {
+        const events = params.events.split(",").map((e) => e.trim());
+        const result = await client.configureWebhook({
+            url: params.url,
+            events,
+            description: params.description,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@voteship/mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for VoteShip — manage feature requests, votes, roadmaps, and AI workflows from any MCP client",
+  "type": "module",
+  "bin": {
+    "voteship-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "voteship",
+    "feature-requests",
+    "ai-agent"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/voteship/voteship"
+  }
+}