@voteship/mcp-server 0.1.0 → 0.1.1

package/dist/client.js

@@ -114,7 +114,7 @@ export class VoteShipClient {
         if (params?.period)
             query.set("period", params.period);
         const qs = query.toString();
-        return this.request("GET", `/analytics/summary${qs ? `?${qs}` : ""}`);
+        return this.request("GET", `/analytics${qs ? `?${qs}` : ""}`);
     }
     // --- AI Workflows ---
     async submitFeedback(data) {

package/dist/prompts/changelog.js

@@ -1,11 +1,8 @@
+import { z } from "zod";
 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) => ({
+    server.prompt("generate_changelog", "Draft release notes from recently completed feature requests", {
+        period: z.string().describe("Time period to look back: week, month, or quarter (default: month)").optional(),
+    }, async (params) => ({
         messages: [
             {
                 role: "user",

package/dist/prompts/sprint.js

@@ -1,16 +1,9 @@
+import { z } from "zod";
 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) => ({
+    server.prompt("sprint_planning", "Suggest what to build next based on votes, themes, and prioritization strategy", {
+        capacity: z.string().describe("Number of features for the sprint (default: 5)").optional(),
+        strategy: z.string().describe("Prioritization: balanced, revenue, popular, or quick-wins (default: balanced)").optional(),
+    }, async (params) => ({
         messages: [
             {
                 role: "user",

package/dist/prompts/summary.js

@@ -1,11 +1,8 @@
+import { z } from "zod";
 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) => ({
+    server.prompt("feedback_summary", "Summarize feedback trends, highlights, and actionable insights for a time period", {
+        period: z.string().describe("Time period: week, month, or quarter (default: week)").optional(),
+    }, async (params) => ({
         messages: [
             {
                 role: "user",

package/dist/resources/analytics.js

@@ -1,5 +1,5 @@
 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 () => {
+    server.resource("project-analytics", "voteship://project/analytics", { description: "Analytics snapshot — daily stats, top posts, and trending tags for the past week" }, async () => {
         const result = await client.getAnalytics({ period: "week" });
         return {
             contents: [

package/dist/resources/changelog.js

@@ -1,5 +1,5 @@
 export function registerChangelogResources(server, client) {
-    server.resource("project-changelog", "voteship://project/changelog", "Published changelog releases — recent product updates and shipped features", async () => {
+    server.resource("project-changelog", "voteship://project/changelog", { description: "Published changelog releases — recent product updates and shipped features" }, async () => {
         const result = await client.listReleases({ limit: 20 });
         return {
             contents: [

package/dist/resources/project.js

@@ -1,5 +1,5 @@
 export function registerProjectResources(server, client) {
-    server.resource("project-overview", "voteship://project/overview", "Project summary with key stats — post counts, vote counts, and configuration", async () => {
+    server.resource("project-overview", "voteship://project/overview", { description: "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(),
@@ -20,7 +20,7 @@ export function registerProjectResources(server, client) {
             ],
         };
     });
-    server.resource("project-board", "voteship://project/board", "Full board state — all posts grouped by status with tags and vote counts", async () => {
+    server.resource("project-board", "voteship://project/board", { description: "Full board state — all posts grouped by status with tags and vote counts" }, async () => {
         const result = await client.listPosts({ limit: 100 });
         return {
             contents: [

package/dist/resources/roadmap.js

@@ -1,5 +1,5 @@
 export function registerRoadmapResources(server, client) {
-    server.resource("project-roadmap", "voteship://project/roadmap", "Public roadmap — approved, in-progress, and completed features sorted by votes", async () => {
+    server.resource("project-roadmap", "voteship://project/roadmap", { description: "Public roadmap — approved, in-progress, and completed features sorted by votes" }, async () => {
         const result = await client.getRoadmap();
         return {
             contents: [

package/dist/tools/ai.js

@@ -1,27 +1,28 @@
+import { z } from "zod";
 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)" },
+        text: z.string().describe("Raw text describing a feature request, e.g. 'Multiple customers asked for PDF export'"),
+        source: z.string().describe("Where the feedback came from: slack, email, support, intercom, etc.").optional(),
+        source_url: z.string().describe("URL to the original message (e.g. Slack permalink)").optional(),
     }, 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)" },
+        limit: z.number().describe("Maximum posts to triage (default: 20, max: 50)").optional(),
     }, 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)" },
+        period: z.string().describe("Time period: week, month, or quarter (default: week)").optional(),
     }, 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)" },
+        capacity: z.number().describe("Number of features to include in the sprint (default: 5, max: 20)").optional(),
+        strategy: z.string().describe("Prioritization strategy: balanced, revenue, popular, or quick-wins (default: balanced)").optional(),
     }, async (params) => {
         const result = await client.planSprint(params);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/analytics.js

@@ -1,6 +1,7 @@
+import { z } from "zod";
 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)" },
+        period: z.string().describe("Time period: week, month, or quarter (default: week)").optional(),
     }, async (params) => {
         const result = await client.getAnalytics(params);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/comments.js

@@ -1,8 +1,9 @@
+import { z } from "zod";
 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" },
+        post_id: z.string().describe("The post ID to comment on"),
+        body: z.string().describe("Comment text content"),
+        author_name: z.string().describe("Display name for the comment author").optional(),
     }, async (params) => {
         const result = await client.addComment(params.post_id, {
             body: params.body,
@@ -11,7 +12,7 @@ export function registerCommentTools(server, client) {
         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" },
+        post_id: z.string().describe("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.js

@@ -1,24 +1,25 @@
+import { z } from "zod";
 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)" },
+        status: z.string().describe("Filter by status: PENDING, APPROVED, IN_PROGRESS, COMPLETE, CLOSED").optional(),
+        sort: z.string().describe("Sort order: votes (default) or date").optional(),
+        limit: z.number().describe("Results per page (default: 50, max: 100)").optional(),
+        page: z.number().describe("Page number (default: 1)").optional(),
     }, 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" },
+        post_id: z.string().describe("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" },
+        title: z.string().describe("Feature request title (max 200 chars)"),
+        description: z.string().describe("Detailed description of the feature request").optional(),
+        status: z.string().describe("Initial status: PENDING, APPROVED, IN_PROGRESS, COMPLETE, CLOSED").optional(),
+        tag_ids: z.string().describe("Comma-separated tag IDs to attach").optional(),
     }, async (params) => {
         const tagIds = params.tag_ids ? params.tag_ids.split(",").map((s) => s.trim()) : undefined;
         const result = await client.createPost({
@@ -30,11 +31,11 @@ export function registerPostTools(server, client) {
         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)" },
+        post_id: z.string().describe("The post ID to update"),
+        title: z.string().describe("New title (max 200 chars)").optional(),
+        description: z.string().describe("New description").optional(),
+        status: z.string().describe("New status: PENDING, APPROVED, IN_PROGRESS, COMPLETE, CLOSED").optional(),
+        tag_ids: z.string().describe("Comma-separated tag IDs (replaces all existing tags)").optional(),
     }, async (params) => {
         const tagIds = params.tag_ids ? params.tag_ids.split(",").map((s) => s.trim()) : undefined;
         const result = await client.updatePost(params.post_id, {
@@ -46,7 +47,7 @@ export function registerPostTools(server, client) {
         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" },
+        post_id: z.string().describe("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.js

@@ -1,14 +1,15 @@
+import { z } from "zod";
 export function registerReleaseTools(server, client) {
     server.tool("list_releases", "List published changelog releases", {
-        limit: { type: "number", description: "Number of releases to return (default: 20)" },
+        limit: z.number().describe("Number of releases to return (default: 20)").optional(),
     }, 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)" },
+        title: z.string().describe("Release title, e.g. 'January 2026 Update'"),
+        content: z.string().describe("Release notes content (HTML supported)"),
+        is_draft: z.boolean().describe("Save as draft (true) or publish immediately (false, default)").optional(),
     }, async (params) => {
         const result = await client.createRelease({
             title: params.title,

package/dist/tools/search.js

@@ -1,8 +1,9 @@
+import { z } from "zod";
 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)" },
+        query: z.string().describe("Natural language search query, e.g. 'export data as PDF'"),
+        threshold: z.number().describe("Minimum similarity score 0-1 (default: 0.7)").optional(),
+        limit: z.number().describe("Maximum results to return (default: 5, max: 20)").optional(),
     }, async (params) => {
         const result = await client.searchSimilar(params);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/tags.js

@@ -1,11 +1,12 @@
+import { z } from "zod";
 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'" },
+        label: z.string().describe("Tag name, e.g. 'Mobile', 'Performance', 'UI'"),
+        theme: z.string().describe("Hex color for the tag, e.g. '#6366f1'").optional(),
     }, async (params) => {
         const result = await client.createTag(params);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/users.js

@@ -1,7 +1,8 @@
+import { z } from "zod";
 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)" },
+        limit: z.number().describe("Results per page (default: 50, max: 100)").optional(),
+        page: z.number().describe("Page number (default: 1)").optional(),
     }, async (params) => {
         const result = await client.listUsers(params);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

package/dist/tools/votes.js

@@ -1,17 +1,20 @@
+import { z } from "zod";
 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)" },
+    server.tool("add_vote", "Add a vote to a feature request. You must provide either a board_user_id or anonymous_id to identify the voter.", {
+        post_id: z.string().describe("The post ID to vote on"),
+        board_user_id: z.string().describe("Board user ID (for identified users)").optional(),
+        anonymous_id: z.string().describe("Anonymous ID (for unidentified users, e.g. a fingerprint or UUID)").optional(),
     }, async (params) => {
-        const result = await client.addVote(params.post_id, {
-            boardUserId: params.board_user_id,
-            anonymousId: params.anonymous_id,
-        });
+        const data = {};
+        if (params.board_user_id)
+            data.boardUserId = params.board_user_id;
+        if (params.anonymous_id)
+            data.anonymousId = params.anonymous_id;
+        const result = await client.addVote(params.post_id, data);
         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" },
+        post_id: z.string().describe("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.js

@@ -1,8 +1,9 @@
+import { z } from "zod";
 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" },
+        url: z.string().describe("The HTTPS URL to receive webhook POST requests"),
+        events: z.string().describe("Comma-separated event types to subscribe to, e.g. 'post.created,vote.created' or '*' for all"),
+        description: z.string().describe("Human-readable description of this webhook").optional(),
     }, async (params) => {
         const events = params.events.split(",").map((e) => e.trim());
         const result = await client.configureWebhook({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voteship/mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server for VoteShip — manage feature requests, votes, roadmaps, and AI workflows from any MCP client",
   "type": "module",
   "bin": {
@@ -17,7 +17,8 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1"
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",