@aioproductoscom/mcp 0.15.3 → 0.15.5

package/dist/client.js

@@ -48,6 +48,54 @@ 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) });
+    }
+    updateFeature(body) {
+        return this.req("/api/me/features", { method: "PATCH", body: JSON.stringify(body) });
+    }
+    updateObjective(body) {
+        return this.req("/api/me/objectives", { method: "PATCH", body: JSON.stringify(body) });
+    }
+    updateKeyResult(body) {
+        return this.req("/api/me/key-results", { method: "PATCH", body: JSON.stringify(body) });
+    }
+    updateSprint(body) {
+        return this.req("/api/me/sprints", { method: "PATCH", body: JSON.stringify(body) });
+    }
+    updatePage(body) {
+        return this.req("/api/me/pages", { method: "PATCH", body: JSON.stringify(body) });
+    }
+    createRelease(body) {
+        return this.req("/api/me/releases", { method: "POST", body: JSON.stringify(body) });
+    }
+    updateRelease(body) {
+        return this.req("/api/me/releases", { method: "PATCH", body: JSON.stringify(body) });
+    }
+    createExperiment(body) {
+        return this.req("/api/me/experiments", { method: "POST", body: JSON.stringify(body) });
+    }
+    updateExperiment(body) {
+        return this.req("/api/me/experiments", { method: "PATCH", body: JSON.stringify(body) });
+    }
+    listDecisions(status) {
+        return this.req(`/api/me/decisions${status ? `?status=${encodeURIComponent(status)}` : ""}`);
+    }
+    createDecision(body) {
+        return this.req("/api/me/decisions", { method: "POST", body: JSON.stringify(body) });
+    }
+    updateDecision(body) {
+        return this.req("/api/me/decisions", { method: "PATCH", 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.3" }, {
+const server = new McpServer({ name: "AIOProductOS", version: "0.15.5" }, {
     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,127 @@ 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_feature", "Update a feature and return it; omitted fields are unchanged. status is 'active' | 'discovered' | 'archived' (there is NO 'shipped' status — set mark_shipped:true to stamp its ship date instead). target_date is 'YYYY-MM-DD' (or null to clear). Resolve the id via list_features; only id is required.", {
+    id: z.string().describe("Feature id to update, from list_features (required)."),
+    name: z.string().optional().describe("New name (optional)."),
+    description: z.string().nullable().optional().describe("New description; null clears it (optional)."),
+    status: z.enum(["active", "discovered", "archived"]).optional().describe("Lifecycle status (optional)."),
+    target_date: z.string().nullable().optional().describe("Target ship date 'YYYY-MM-DD', or null to clear (optional)."),
+    mark_shipped: z.boolean().optional().describe("true stamps the ship date now; false clears it (optional)."),
+}, async (a) => text(await client.updateFeature(a)));
+server.tool("update_objective", "Update an objective's name / description / period and return it; omitted fields are unchanged (null clears description or period). Resolve the id via list_objectives; only id is required. To move a key result's value use update_key_result.", {
+    id: z.string().describe("Objective id, from list_objectives (required)."),
+    name: z.string().optional().describe("New name (optional)."),
+    description: z.string().nullable().optional().describe("New description; null clears it (optional)."),
+    period: z.string().nullable().optional().describe("New period, e.g. 'Q4 2026'; null clears it (optional)."),
+}, async (a) => text(await client.updateObjective(a)));
+server.tool("update_key_result", "Update a key result — most often to move current_value as progress lands — and return it; omitted fields are unchanged. Resolve the id via list_objectives (each objective carries its key_results with ids). Only id is required.", {
+    id: z.string().describe("Key result id, from list_objectives (required)."),
+    current_value: z.number().optional().describe("New current value (optional)."),
+    target_value: z.number().nullable().optional().describe("New target value; null clears it (optional)."),
+    start_value: z.number().optional().describe("New starting baseline (optional)."),
+    name: z.string().optional().describe("New name (optional)."),
+    unit: z.string().nullable().optional().describe("New unit, e.g. 'USD'; null clears it (optional)."),
+}, async (a) => text(await client.updateKeyResult(a)));
+server.tool("update_sprint", "Update a sprint and return it. state is 'future' | 'active' | 'closed' — moving to 'closed' stamps the completion time, reopening clears it. start_date / end_date are ISO 8601 (or null to clear). Resolve the id via list_sprints; only id is required.", {
+    id: z.string().describe("Sprint id, from list_sprints (required)."),
+    name: z.string().optional().describe("New name (optional)."),
+    goal: z.string().nullable().optional().describe("New goal; null clears it (optional)."),
+    state: z.enum(["future", "active", "closed"]).optional().describe("Lifecycle state; 'closed' completes it (optional)."),
+    start_date: z.string().nullable().optional().describe("Start, ISO 8601, or null (optional)."),
+    end_date: z.string().nullable().optional().describe("End, ISO 8601, or null (optional)."),
+}, async (a) => text(await client.updateSprint(a)));
+server.tool("update_page", "Update a Page — rename, set icon, replace the body, or archive/unarchive (archived:true hides it, false restores it). `body` is plain text (blank lines → paragraphs) and REPLACES the page content. Omitted fields are unchanged. Resolve the id via list_pages; only id is required.", {
+    id: z.string().describe("Page id, from list_pages (required)."),
+    title: z.string().optional().describe("New title (optional)."),
+    icon: z.string().nullable().optional().describe("New emoji icon; null clears it (optional)."),
+    body: z.string().optional().describe("New content as plain text; blank lines separate paragraphs. REPLACES existing content (optional)."),
+    archived: z.boolean().optional().describe("true archives (hides) the page; false restores it (optional)."),
+}, async (a) => text(await client.updatePage(a)));
+server.tool("create_release", "Create a release and return it (id, version, changelog, released_at). Omit released_at for an unreleased/draft entry. product_id defaults to the org's primary product. Only version is required.", {
+    version: z.string().describe("Version string (required), e.g. 'v2.4.0'."),
+    changelog: z.string().optional().describe("What shipped (optional)."),
+    released_at: z.string().optional().describe("Ship time, ISO 8601 (optional; omit for a draft)."),
+    product_id: z.string().optional().describe("Product, from whoami (optional; the primary product when omitted)."),
+}, async (a) => text(await client.createRelease(a)));
+server.tool("update_release", "Update a release and return it; omitted fields unchanged. Set released_at to ship it (or null to move it back to draft). Resolve the id via list_releases; only id is required.", {
+    id: z.string().describe("Release id, from list_releases (required)."),
+    version: z.string().optional().describe("New version (optional)."),
+    changelog: z.string().nullable().optional().describe("New changelog; null clears it (optional)."),
+    released_at: z.string().nullable().optional().describe("Ship time ISO 8601, or null for draft (optional)."),
+}, async (a) => text(await client.updateRelease(a)));
+server.tool("create_experiment", "Create a PM experiment (a Build-Measure-Learn hypothesis) and return it. state is 'hypothesis' (default) | 'build' | 'measure' | 'learn'. Only title is required. This is the PM hypothesis tracker list_experiments reads, not the analytics A/B engine.", {
+    title: z.string().describe("Experiment title / the hypothesis in a line (required)."),
+    hypothesis: z.string().optional().describe("The full hypothesis (optional)."),
+    metric: z.string().optional().describe("The metric it moves, e.g. 'activation rate' (optional)."),
+    target: z.string().optional().describe("Target change, e.g. '+5pp' (optional)."),
+    state: z.enum(["hypothesis", "build", "measure", "learn"]).optional().describe("Build-Measure-Learn stage (optional; default 'hypothesis')."),
+    product_id: z.string().optional().describe("Product, from whoami (optional)."),
+}, async (a) => text(await client.createExperiment(a)));
+server.tool("update_experiment", "Update a PM experiment — advance its state and record the outcome — and return it. state ∈ hypothesis|build|measure|learn; verdict ∈ validated|invalidated; decision ∈ pivot|persevere. Resolve the id via list_experiments; only id is required.", {
+    id: z.string().describe("Experiment id, from list_experiments (required)."),
+    title: z.string().optional().describe("New title (optional)."),
+    hypothesis: z.string().nullable().optional().describe("New hypothesis; null clears it (optional)."),
+    metric: z.string().nullable().optional().describe("New metric; null clears it (optional)."),
+    target: z.string().nullable().optional().describe("New target; null clears it (optional)."),
+    state: z.enum(["hypothesis", "build", "measure", "learn"]).optional().describe("Build-Measure-Learn stage (optional)."),
+    verdict: z.enum(["validated", "invalidated"]).nullable().optional().describe("Outcome (optional)."),
+    decision: z.enum(["pivot", "persevere"]).nullable().optional().describe("What you'll do next (optional)."),
+    result: z.string().nullable().optional().describe("Free-text result / what you learned; null clears it (optional)."),
+}, async (a) => text(await client.updateExperiment(a)));
+server.tool("list_decisions", "List the org's logged decisions — title, rationale, status, and any linked feature/release/objective — newest first. Read-only; returns an empty list when none. Optional status filter (decided | proposed | revisit). Resolve a decision id here before update_decision.", {
+    status: z.enum(["decided", "proposed", "revisit"]).optional().describe("Filter by status (optional)."),
+}, async (a) => text(await client.listDecisions(a.status)));
+server.tool("create_decision", "Log a decision and return it. status is 'decided' (default) | 'proposed' | 'revisit'; a 'decided' one stamps the decision time. Optionally weld it to a feature / release / objective via link_type + link_id (verified in-org). Only title is required.", {
+    title: z.string().describe("The decision in a line (required)."),
+    rationale: z.string().optional().describe("Why — the reasoning (optional)."),
+    status: z.enum(["decided", "proposed", "revisit"]).optional().describe("Decision status (optional; default 'decided')."),
+    link_type: z.enum(["feature", "release", "objective"]).optional().describe("What it's linked to (optional; pair with link_id)."),
+    link_id: z.string().optional().describe("Id of the linked feature/release/objective, from list_features / list_releases / list_objectives (optional)."),
+}, async (a) => text(await client.createDecision(a)));
+server.tool("update_decision", "Update a decision and return it; omitted fields unchanged. Moving status to 'decided' re-stamps the decision time. Re-link via link_type + link_id (verified in-org), or clear with nulls. Resolve the id via list_decisions; only id is required.", {
+    id: z.string().describe("Decision id, from list_decisions (required)."),
+    title: z.string().optional().describe("New title (optional)."),
+    rationale: z.string().nullable().optional().describe("New rationale; null clears it (optional)."),
+    status: z.enum(["decided", "proposed", "revisit"]).optional().describe("New status (optional)."),
+    link_type: z.enum(["feature", "release", "objective"]).nullable().optional().describe("New link target (optional)."),
+    link_id: z.string().nullable().optional().describe("New linked id, or null to unlink (optional)."),
+}, async (a) => text(await client.updateDecision(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)."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aioproductoscom/mcp",
-  "version": "0.15.3",
+  "version": "0.15.5",
   "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",