@aioproductoscom/mcp 0.15.2 → 0.15.4

package/dist/client.js

@@ -48,6 +48,18 @@ export class PlatformClient {
     createTask(body) {
         return this.req("/api/pm/tasks", { method: "POST", body: JSON.stringify(body) });
     }
+    createFeature(body) {
+        return this.req("/api/me/features", { method: "POST", body: JSON.stringify(body) });
+    }
+    createObjective(body) {
+        return this.req("/api/me/objectives", { method: "POST", body: JSON.stringify(body) });
+    }
+    createSprint(body) {
+        return this.req("/api/me/sprints", { method: "POST", body: JSON.stringify(body) });
+    }
+    createPage(body) {
+        return this.req("/api/me/pages", { method: "POST", body: JSON.stringify(body) });
+    }
     updateTask(id, body) {
         return this.req(`/api/pm/tasks/${encodeURIComponent(id)}`, { method: "PATCH", body: JSON.stringify(body) });
     }

package/dist/index.js

@@ -23,7 +23,7 @@ function text(data) {
 function promptMsg(body) {
     return { messages: [{ role: "user", content: { type: "text", text: body } }] };
 }
-const server = new McpServer({ name: "AIOProductOS", version: "0.15.2" }, {
+const server = new McpServer({ name: "AIOProductOS", version: "0.15.4" }, {
     instructions: "You manage product work on AIOProductOS for the connected member — board, insights, features, and " +
         "analytics all hang off one spine. Call get_pm_playbook first for how to operate: ground in " +
         "get_product_brain, keep work tied to the spine (insight→feature→task→outcome), and prioritize on " +
@@ -49,6 +49,41 @@ server.tool("create_task", "Create a task and return the created task. A write
     insight_id: z.string().optional().describe("Link to an insight (optional)."),
     assignee_member_ids: z.array(z.string()).optional().describe("Member ids to assign, from pm_meta (optional)."),
 }, async (a) => text(await client.createTask(a)));
+server.tool("create_feature", "Create a feature on the product spine and return it (id, key, name, status). The key is generated from the name; status starts 'active'. product_id defaults to the org's primary product when omitted — pass one from whoami for a multi-product org. Only name is required; create the feature before linking tasks to it with create_task.", {
+    name: z.string().describe("Feature name (the only required field), e.g. 'SAML SSO'."),
+    description: z.string().optional().describe("What the feature is / why it matters (optional)."),
+    product_id: z.string().optional().describe("Product to create it under, from whoami (optional; the org's primary product when omitted)."),
+}, async (a) => text(await client.createFeature(a)));
+server.tool("create_objective", "Create an objective (OKR), optionally with key results, and return it. period is free text (e.g. 'Q3 2026'); product_id and parent_id (a parent objective) are optional and verified in-org. Each key result takes name + optional unit / start_value / target_value. Only name is required.", {
+    name: z.string().describe("Objective name (the only required field), e.g. 'Reach $50k MRR'."),
+    description: z.string().optional().describe("Context for the objective (optional)."),
+    period: z.string().optional().describe("Free-text period, e.g. 'Q3 2026' (optional)."),
+    product_id: z.string().optional().describe("Product to scope it to, from whoami (optional)."),
+    parent_id: z.string().optional().describe("Parent objective id to nest under (optional)."),
+    key_results: z
+        .array(z.object({
+        name: z.string().describe("Key result name, e.g. 'MRR'."),
+        unit: z.string().optional().describe("Unit, e.g. 'USD' or '%' (optional)."),
+        start_value: z.number().optional().describe("Starting value (optional; default 0)."),
+        target_value: z.number().optional().describe("Target value (optional)."),
+    }))
+        .optional()
+        .describe("Key results to attach (optional; up to 10)."),
+}, async (a) => text(await client.createObjective(a)));
+server.tool("create_sprint", "Create a sprint and return it (id, name, goal, state, dates). state is 'future' (default) or 'active'; start_date / end_date are optional ISO 8601. Only name is required. Schedule tasks into it by passing the returned sprint id as sprint_id on create_task / update_task.", {
+    name: z.string().describe("Sprint name (the only required field), e.g. 'Sprint 12'."),
+    goal: z.string().optional().describe("The sprint goal (optional)."),
+    state: z.enum(["future", "active"]).optional().describe("Lifecycle state (optional; default 'future')."),
+    start_date: z.string().optional().describe("Start, ISO 8601 e.g. '2026-07-15T00:00:00Z' (optional)."),
+    end_date: z.string().optional().describe("End, ISO 8601 (optional)."),
+}, async (a) => text(await client.createSprint(a)));
+server.tool("create_page", "Create a Page (in-product doc / PRD on the spine) and return it (id, title). `body` is plain text — blank-line-separated blocks become paragraphs; omit it for a blank page. title defaults to 'Untitled'. product_id / parent_id (a parent page) are optional and verified in-org.", {
+    title: z.string().optional().describe("Page title (optional; 'Untitled' when omitted)."),
+    body: z.string().optional().describe("Page content as plain text; blank lines separate paragraphs (optional)."),
+    icon: z.string().optional().describe("An emoji icon for the page (optional)."),
+    product_id: z.string().optional().describe("Product to scope it to, from whoami (optional)."),
+    parent_id: z.string().optional().describe("Parent page id to nest under (optional)."),
+}, async (a) => text(await client.createPage(a)));
 server.tool("update_task", "Update one or more of a task's fields and return the updated task; fields you omit are left unchanged (idempotent — re-sending the same values is a no-op), and passing null clears a nullable field. Resolve ids first — the task via list_tasks/get_task, and status/feature/insight/member ids via pm_meta — never guess them. Only id is required.", {
     id: z.string().describe("Task id, from list_tasks or get_task."),
     title: z.string().optional().describe("New title (optional)."),
@@ -64,7 +99,7 @@ server.tool("comment_on_task", "Add a comment to a task, authored as the connect
     body: z.string().describe("Comment body."),
 }, async (a) => text(await client.comment(a.id, a.body)));
 server.tool("get_product_brain", "Read a grounded, read-only snapshot of the org's product so YOU can reason about it on your own model: revenue + top paying accounts, web + product analytics, features, recent verbatim customer signals, and open work. Optional product_id; omit for the primary product. Returns the brain text plus the list of products you can ask about.", { product_id: z.string().optional().describe("Product id, from whoami (optional; primary by default).") }, async (a) => text(await client.brain(a.product_id)));
-server.tool("get_customer_360", "Everything about ONE customer, resolved by id, email, domain, or company name: profile, subscription + MRR, how many users sit under the account, and their verbatim feedback. Read-only; returns the matched account, or an empty result when nothing matches. The money + people + voice join on one record — use it before answering anything about a specific account.", { query: z.string().describe("Account id, email, domain, or company name.") }, async (a) => text(await client.customer360(a.query)));
+server.tool("get_customer_360", "Everything about ONE customer, resolved by id, email, domain, or company name: profile, subscription + MRR, how many users sit under the account, and their verbatim feedback (newest first). Read-only; returns the single best-matching account, or an empty result when nothing matches. The money + people + voice join on one record — use it before answering anything about a specific account.", { query: z.string().describe("The account to resolve — an account id (exact), a user's email (exact), a company domain like 'acme.com', or a company name (partial match). Pass one value; the strongest match wins.") }, async (a) => text(await client.customer360(a.query)));
 server.tool("analyze_nps", "NPS for the product — standard score AND revenue-weighted NPS (each respondent weighted by their account MRR), plus the detractor accounts ranked by what they're worth, with verbatims. The revenue weighting is the spine join no standalone survey tool can compute: it surfaces when your biggest customers are the unhappy ones even if the headline score looks fine. Optional product_id (primary by default) and window_days (default 90).", {
     product_id: z.string().optional().describe("Product id, from whoami (optional; primary by default)."),
     window_days: z.number().optional().describe("Window in days (default 90)."),
@@ -113,9 +148,9 @@ server.tool("reschedule_booking", "Move a booking to a new start time and return
     start: z.string().describe("New start time, ISO 8601 (e.g. 2026-06-20T15:00:00Z); must be an open slot."),
 }, async (a) => text(await client.schedulingAction({ action: "reschedule", booking_id: a.booking_id, start: a.start })));
 server.tool("list_channels", "List the team Comms channels you (this token's member) belong to — id, name, kind, topic. Read-only; returns your channels, empty when you belong to none (an admin adds you in AIOProductOS → Comms). These are the channels you can read_channel and post_to_channel into.", {}, async () => text(await client.listChannels()));
-server.tool("read_channel", "Read recent messages in a Comms channel you belong to (oldest→newest), so you can catch up before replying. Read-only; returns the messages, empty when the channel is silent. Resolve the channel_id first with list_channels — never guess it.", {
+server.tool("read_channel", "Read recent messages in a Comms channel you belong to, oldest→newest, so you can catch up before replying. Read-only; returns each message with its author, body, and timestamp — empty when the channel is silent. Resolve the channel_id first with list_channels — never guess it. Pass limit to cap how many of the most-recent messages come back; the server applies a default when it's omitted.", {
     channel_id: z.string().describe("Channel id, from list_channels."),
-    limit: z.number().optional().describe("Max messages to return (optional)."),
+    limit: z.number().int().positive().optional().describe("Maximum number of most-recent messages to return (optional; the server applies a sensible default when omitted)."),
 }, async (a) => text(await client.readChannel(a.channel_id, a.limit)));
 server.tool("post_to_channel", "Post a message into a team Comms channel you belong to and return the posted message. It goes out as you (this token's member) and appears live for your teammates — use it to tell the team what you did, share a link, or ask a question. Resolve the channel_id first with list_channels; only works for channels you're a member of.", {
     channel_id: z.string().describe("Channel id, from list_channels."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aioproductoscom/mcp",
-  "version": "0.15.2",
+  "version": "0.15.4",
   "mcpName": "com.aioproductos/mcp",
   "description": "AIOProductOS MCP — manage the board, read your product brain + analytics, and run the support inbox from Claude Code, Cursor, Codex, and any MCP host.",
   "type": "module",
@@ -37,11 +37,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build",
-    "start": "node dist/index.js"
-  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
     "zod": "^3.23.8"
@@ -49,5 +44,9 @@
   "devDependencies": {
     "@types/node": "^22.7.0",
     "typescript": "^5.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
   }
-}
+}