shipnoted-mcp 0.2.0 → 0.3.0

package/README.md

@@ -10,4 +10,4 @@ claude mcp add shipnoted \
   -- npx -y shipnoted-mcp
 ```
 
-Tools: `list_releases`, `draft_release`, `publish_release`, `top_feedback`, `set_feedback_status`. Needs a Pro or Team plan (API keys).
+Tools: `project_info`, `top_feedback`, `search_feedback`, `segments`, `get_request`, `themes`, `loop_status`, `list_releases`, `draft_release`, `set_feedback_status`, `file_request`, `publish_release`, `publish_draft`, `update_release`, `comment_on_request`. Read-only tools are marked `readOnlyHint`, and the ones customers can see have `destructiveHint`, so clients can ask before running them. Needs a Pro or Team plan (API keys). Give the key only the scopes the agent needs (a Read only key makes every write tool fail). Docs: https://shipnoted.com/docs/mcp

package/index.mjs

@@ -106,17 +106,66 @@ const TOOLS = [
       return `Moved ${id} to ${status}.`
     },
   },
+  {
+    name: "project_info",
+    description: "Which project this is: name, public address, the widget script tag, and counts of releases, requests and subscribers. A good first call to check the connection.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    run: async () => {
+      const { project: p } = await call("GET", "/project")
+      return `${p.name} (${p.slug}), ${p.live ? "live" : "offline"}\n${p.url}\n${p.counts.releases} releases, ${p.counts.requests} requests, ${p.counts.subscribers} subscribers\nWidget: ${p.widget}`
+    },
+  },
+  {
+    name: "search_feedback",
+    description: "Search requests by words or by customer group, for example everything the beta customers asked for. Returns the reference, votes, revenue and status of each.",
+    inputSchema: { type: "object", properties: { q: { type: "string" }, segment: { type: "string", description: 'A group such as "plan:Pro", "company:Acme" or "beta:true". See the segments tool.' }, status: { type: "string", enum: ["open", "planned", "progress", "shipped", "declined"] }, sort: { type: "string", enum: ["top", "revenue", "new"] } }, additionalProperties: false },
+    run: async ({ q, segment, status, sort }) => {
+      const p = new URLSearchParams()
+      for (const [k, v] of Object.entries({ q, segment, status, sort })) if (v) p.set(k, String(v))
+      const r = await call("GET", `/feedback${p.size ? `?${p}` : ""}`)
+      return r.feedback.slice(0, 25).map((f) => `${(f.ref || "").padEnd(7)} ${String(f.votes).padStart(4)} votes${f.mrrCents ? `  $${(f.mrrCents / 100).toLocaleString()}/mo` : ""}  [${f.status}]  ${f.title}`).join("\n") || "Nothing matches."
+    },
+  },
+  {
+    name: "segments",
+    description: "The customer groups that have voted (plan, company, custom attributes like beta:true) with their votes and revenue. Use the segment values with search_feedback.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    run: async () => (await call("GET", "/segments")).segments.map((s) => `${s.segment}  ${s.votes} votes${s.mrrCents ? `, $${(s.mrrCents / 100).toLocaleString()}/mo` : ""}`).join("\n") || "No identified customers have voted yet.",
+  },
+  {
+    name: "file_request",
+    description: "File a new feedback request on the board, for example from a support conversation. Send a stable idempotency_key (a ticket id) so a retry never files it twice.",
+    inputSchema: { type: "object", properties: { title: { type: "string" }, body: { type: "string" }, email: { type: "string" }, name: { type: "string" }, source: { type: "string", description: "Where it came from, such as Intercom" }, idempotency_key: { type: "string" } }, required: ["title"], additionalProperties: false },
+    run: async ({ title, body, email, name, source, idempotency_key }) => {
+      const r = await call("POST", "/feedback", { title, body, email, name, source, idempotencyKey: idempotency_key })
+      return r.duplicate ? `Already filed as ${r.ref}.` : `Filed as ${r.ref}.`
+    },
+  },
+  {
+    name: "update_release",
+    description: "Edit a release (draft or published): title, version, notes, tags, or who it is for. Changes to a published release go live at once.",
+    inputSchema: { type: "object", properties: { id: { type: "string" }, title: { type: "string" }, version: { type: "string" }, body: { type: "string", description: "Markdown" }, tags: { type: "array", items: { type: "string", enum: ["new", "improved", "fixed", "breaking"] } }, audience: { type: "string", description: 'Aim it at a group, such as "plan:pro", or "" for everyone' } }, required: ["id"], additionalProperties: false },
+    run: async ({ id, ...fields }) => {
+      const r = await call("PATCH", `/releases/${encodeURIComponent(id)}`, fields)
+      return `Updated ${r.release.title} (${r.release.status}).`
+    },
+  },
 ]
 
+const READ_ONLY = new Set(["list_releases", "top_feedback", "get_request", "loop_status", "themes", "project_info", "search_feedback", "segments"])
+// Tools that change what customers see or get emailed. Clients can use this to ask before running them.
+const PUBLIC_EFFECT = new Set(["publish_release", "publish_draft", "comment_on_request", "update_release"])
+const annotate = (name) => ({ title: name.replace(/_/g, " "), readOnlyHint: READ_ONLY.has(name), destructiveHint: PUBLIC_EFFECT.has(name), idempotentHint: READ_ONLY.has(name) || name === "set_feedback_status", openWorldHint: false })
+
 const send = (msg) => process.stdout.write(JSON.stringify({ jsonrpc: "2.0", ...msg }) + "\n")
 
 async function handle(msg) {
   const { id, method, params } = msg
   if (id === undefined) return // notifications need no reply
   try {
-    if (method === "initialize") return send({ id, result: { protocolVersion: PROTOCOL, capabilities: { tools: {} }, serverInfo: { name: "shipnoted", version: "0.2.0" } } })
+    if (method === "initialize") return send({ id, result: { protocolVersion: PROTOCOL, capabilities: { tools: {} }, serverInfo: { name: "shipnoted", version: "0.3.0" } } })
     if (method === "ping") return send({ id, result: {} })
-    if (method === "tools/list") return send({ id, result: { tools: TOOLS.map(({ run, ...t }) => t) } })
+    if (method === "tools/list") return send({ id, result: { tools: TOOLS.map(({ run, ...t }) => ({ ...t, annotations: annotate(t.name) })) } })
     if (method === "tools/call") {
       const tool = TOOLS.find((t) => t.name === params?.name)
       if (!tool) return send({ id, error: { code: -32602, message: `Unknown tool: ${params?.name}` } })

package/package.json

@@ -1,10 +1,17 @@
 {
   "name": "shipnoted-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for Shipnoted: let your coding agent draft and publish release notes and read your users' feedback.",
   "type": "module",
-  "bin": { "shipnoted-mcp": "./index.mjs" },
-  "files": ["index.mjs", "README.md"],
-  "engines": { "node": ">=18" },
+  "bin": {
+    "shipnoted-mcp": "index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "license": "MIT"
 }