Servers Playground How we check Submit a server

AIOProductOS MCP

Working · 1.1 s

com.aioproductos/mcpv1.0.9 Domain verified

AIOProductOS: revenue, feedback, work and analytics on one customer record. 71 tools, 3 apps.

Productivity Sales & CRM

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://platform.aioproductos.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_note

Add an INTERNAL note to a support conversation — visible only to your team, never sent to the end-user — and return the result. A write. Use it to record context or hand off; resolve conversation_id via list_conversations. conversation_id and body are required. For a public reply use reply_to_conversation instead.

bodystring, required

Internal note text, teammates-only (required).

conversation_idstring, required

Conversation id to note on, from list_conversations (required).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

AIOProductOS MCP MCP server | mcptry

AIOProductOS MCP

Working · 1.1 s

com.aioproductos/mcpv1.0.9 Domain verified

AIOProductOS: revenue, feedback, work and analytics on one customer record. 71 tools, 3 apps.

Productivity Sales & CRM

Source Website Registry entry

Try it

Call this server's tools from your browser. Nothing to install.

https://platform.aioproductos.com/api/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_note

bodystring, required

Internal note text, teammates-only (required).

conversation_idstring, required

Conversation id to note on, from list_conversations (required).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (71)

add_note

Argument	Type	Description
body*	string	Internal note text, teammates-only (required).
conversation_id*	string	Conversation id to note on, from list_conversations (required).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "body": "Repro'd — linking to feat_sso.",
      "conversation_id": "conv_42"
    }
  ],
  "required": [
    "conversation_id",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Internal note text, teammates-only (required)."
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation id to note on, from list_conversations (required)."
    }
  }
}

analyze_funnel

Build a conversion funnel from the product's own events: distinct users per step, step-to-step conversion %, and drop-off, evaluated in the exact order you pass. Needs product-analytics events flowing; returns empty counts when none match. Pass `steps` as an ordered list of 2+ event names — call it with NO steps first to get the menu of available event names rather than guessing them. Optional product_id and window_days (default 30, valid 1–365). Pairs with analyze_paths to see where the drop-offs go.

read-only

Argument	Type	Description
steps	array	Ordered list of 2+ event names forming the funnel; omit to get the menu of available event names first.
product_id	string	Product id, from whoami (optional; the org's primary product when omitted).
window_days	number	Lookback window in days (optional; default 30).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "steps": [
        "signup",
        "activated",
        "subscribed"
      ]
    }
  ],
  "properties": {
    "steps": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Ordered list of 2+ event names forming the funnel; omit to get the menu of available event names first."
    },
    "product_id": {
      "type": "string",
      "description": "Product id, from whoami (optional; the org's primary product when omitted)."
    },
    "window_days": {
      "type": "number",
      "default": 30,
      "minimum": 1,
      "description": "Lookback window in days (optional; default 30)."
    }
  }
}

analyze_nps

NPS for the product: the standard −100…100 score AND revenue-weighted NPS (each respondent weighted by their account MRR), plus detractor accounts ranked by MRR-at-risk (highest first). Surfaces when your biggest customers are the unhappy ones even if the headline looks fine. Computed deterministically off survey responses inside `window_days` (default 90, valid 1–365); returns an empty result when none fall in the window. product_id optional (primary product when omitted). Quantify sentiment after get_product_brain, then dig into a detractor with get_customer_360.

read-only

Argument	Type	Description
product_id	string	Product id, from whoami (optional; the org's primary product when omitted).
window_days	number	Lookback window in days (optional; default 90, i.e. the last quarter).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "window_days": 90
    }
  ],
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id, from whoami (optional; the org's primary product when omitted)."
    },
    "window_days": {
      "type": "number",
      "default": 90,
      "minimum": 1,
      "description": "Lookback window in days (optional; default 90, i.e. the last quarter)."
    }
  }
}

analyze_nrr

Net Revenue Retention (revenue-weighted) next to logo retention (count-weighted), the expansion/contraction/churn split, and the accounts that lost the most MRR (ranked, highest loss first). The divergence is the point: '92% of logos but 78% of revenue' means a big account churned. Computed deterministically off subscription movements inside `window_days` (default 90, valid 1–365); empty when none fall in the window. Quantify revenue health, then follow the top-losing accounts into get_customer_360.

read-only

Argument	Type	Description
window_days	number	Lookback window in days (optional; default 90, i.e. the last quarter).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "window_days": 90
    }
  ],
  "properties": {
    "window_days": {
      "type": "number",
      "default": 90,
      "minimum": 1,
      "description": "Lookback window in days (optional; default 90, i.e. the last quarter)."
    }
  }
}

analyze_paths

Trace what users do AFTER a start event — the journey flow (Sankey) from the product's own events. Returns the next-step transitions ranked by user count (most common first), empty when no events match. Pass `start` to anchor on an event, or omit for the most common start (call analyze_funnel with no steps to list the event names). Optional product_id and window_days (default 30, valid 1–365).

read-only

Argument	Type	Description
start	string	Event name to anchor the flow on (optional; the most common start event when omitted — analyze_funnel with no steps lists the event names).
product_id	string	Product id, from whoami (optional; the org's primary product when omitted).
window_days	number	Lookback window in days (optional; default 30).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "start": "signup"
    }
  ],
  "properties": {
    "start": {
      "type": "string",
      "description": "Event name to anchor the flow on (optional; the most common start event when omitted — analyze_funnel with no steps lists the event names)."
    },
    "product_id": {
      "type": "string",
      "description": "Product id, from whoami (optional; the org's primary product when omitted)."
    },
    "window_days": {
      "type": "number",
      "description": "Lookback window in days (optional; default 30)."
    }
  }
}

cancel_booking

Cancel a scheduled booking (call/meeting) and return the result — the invitee is notified per the scheduling settings. A write. Resolve booking_id via list_bookings first; never guess it. To move it instead of cancelling, use reschedule_booking.

Argument	Type	Description
booking_id*	string	Booking id to cancel, from list_bookings (required).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "booking_id": "book_7"
    }
  ],
  "required": [
    "booking_id"
  ],
  "properties": {
    "booking_id": {
      "type": "string",
      "description": "Booking id to cancel, from list_bookings (required)."
    }
  }
}

capture_insight

Write a piece of customer feedback to the spine (the agent's own hand, not just reading) and return the created insight. Fires the same insight.created webhook a manual capture does — a real side-effect, so only capture genuine signal. Resolve account_id via get_customer_360 and feature_id via list_features and tie them when known; kind='opportunity' marks a prioritisable ask. Only body is required.

Argument	Type	Description
body*	string	The verbatim feedback / insight text (the only required field).
kind	string	'insight' = raw signal; 'opportunity' = a prioritisable ask (optional).
title	string	Short display title (optional).
account_id	string	Account id it's about, from get_customer_360 (optional).
feature_id	string	Feature id to link on the spine, from list_features or pm_meta (optional).
product_id	string	Product id, from whoami (optional; the org's primary product when omitted).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "body": "Two enterprise accounts asked for SAML this week.",
      "kind": "opportunity",
      "account_id": "acct_acme",
      "feature_id": "feat_sso"
    }
  ],
  "required": [
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "The verbatim feedback / insight text (the only required field)."
    },
    "kind": {
      "enum": [
        "insight",
        "opportunity"
      ],
      "type": "string",
      "description": "'insight' = raw signal; 'opportunity' = a prioritisable ask (optional)."
    },
    "title": {
      "type": "string",
      "description": "Short display title (optional)."
    },
    "account_id": {
      "type": "string",
      "description": "Account id it's about, from get_customer_360 (optional)."
    },
    "feature_id": {
      "type": "string",
      "description": "Feature id to link on the spine, from list_features or pm_meta (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product id, from whoami (optional; the org's primary product when omitted)."
    }
  }
}

comment_on_task

Add a comment to a task, authored as the connected member, and return the created comment. Use to record progress, a decision, or a handoff — the comment is visible to the whole org, so keep it work-relevant. Resolve the task id first with get_task or list_tasks; both id and body are required.

Argument	Type	Description
id*	string	Task id, from list_tasks or get_task.
body*	string	Comment text; posted as the connected member and visible to the whole org.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "task_8f3a",
      "body": "Shipped behind a flag — verifying in production."
    }
  ],
  "required": [
    "id",
    "body"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Task id, from list_tasks or get_task."
    },
    "body": {
      "type": "string",
      "description": "Comment text; posted as the connected member and visible to the whole org."
    }
  }
}

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.

Argument	Type	Description
title*	string	The decision in a line (required).
status	string	Decision status (optional; default 'decided').
link_id	string	Id of the linked feature/release/objective, from list_features / list_releases / list_objectives (optional).
link_type	string	What it's linked to (optional; pair with link_id).
rationale	string	Why — the reasoning (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "title": "Ship SSO before mobile",
      "link_id": "feat_123",
      "link_type": "feature",
      "rationale": "Enterprise deals need it"
    }
  ],
  "required": [
    "title"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "The decision in a line (required)."
    },
    "status": {
      "enum": [
        "decided",
        "proposed",
        "revisit"
      ],
      "type": "string",
      "description": "Decision status (optional; default 'decided')."
    },
    "link_id": {
      "type": "string",
      "description": "Id of the linked feature/release/objective, from list_features / list_releases / list_objectives (optional)."
    },
    "link_type": {
      "enum": [
        "feature",
        "release",
        "objective"
      ],
      "type": "string",
      "description": "What it's linked to (optional; pair with link_id)."
    },
    "rationale": {
      "type": "string",
      "description": "Why — the reasoning (optional)."
    }
  }
}

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 tracker list_experiments reads, not the analytics A/B engine.

Argument	Type	Description
state	string	Build-Measure-Learn stage (optional; default 'hypothesis').
title*	string	Experiment title / the hypothesis in a line (required).
metric	string	The metric it moves, e.g. 'activation rate' (optional).
target	string	Target change, e.g. '+5pp' (optional).
hypothesis	string	The full hypothesis (optional).
product_id	string	Product, from whoami (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "title": "Shorter onboarding lifts activation",
      "metric": "activation rate",
      "target": "+5pp"
    }
  ],
  "required": [
    "title"
  ],
  "properties": {
    "state": {
      "enum": [
        "hypothesis",
        "build",
        "measure",
        "learn"
      ],
      "type": "string",
      "description": "Build-Measure-Learn stage (optional; default 'hypothesis')."
    },
    "title": {
      "type": "string",
      "description": "Experiment title / the hypothesis in a line (required)."
    },
    "metric": {
      "type": "string",
      "description": "The metric it moves, e.g. 'activation rate' (optional)."
    },
    "target": {
      "type": "string",
      "description": "Target change, e.g. '+5pp' (optional)."
    },
    "hypothesis": {
      "type": "string",
      "description": "The full hypothesis (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product, from whoami (optional)."
    }
  }
}

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 a feature here before linking tasks to it with create_task.

Argument	Type	Description
name*	string	Feature name (the only required field), e.g. 'SAML SSO'.
product_id	string	Product to create it under, from whoami (optional; the org's primary product when omitted).
description	string	What the feature is / why it matters (optional).
objective_id	string	Objective (goal) to align this feature under directly when there's no intermediate initiative, from list_objectives (optional).
initiative_id	string	Initiative to align this feature under for line-of-sight, from list_initiatives (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "name": "SAML SSO"
    }
  ],
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Feature name (the only required field), e.g. 'SAML SSO'."
    },
    "product_id": {
      "type": "string",
      "description": "Product to create it under, from whoami (optional; the org's primary product when omitted)."
    },
    "description": {
      "type": "string",
      "description": "What the feature is / why it matters (optional)."
    },
    "objective_id": {
      "type": "string",
      "description": "Objective (goal) to align this feature under directly when there's no intermediate initiative, from list_objectives (optional)."
    },
    "initiative_id": {
      "type": "string",
      "description": "Initiative to align this feature under for line-of-sight, from list_initiatives (optional)."
    }
  }
}

create_idea

Create an idea in the backlog and return it (starts with 0 votes, status 'new'). Link the evidence it came from with insight_id (from list_insights). product_id defaults to the primary product. Only title is required. Grow it with vote_idea, then promote_idea turns the winner into a roadmap feature.

Argument	Type	Description
body	string	The idea in more detail (optional).
title*	string	Idea title (the only required field), e.g. 'Bulk-edit tasks'.
insight_id	string	Customer insight this idea came from, from list_insights (optional; welds evidence to the idea).
product_id	string	Product to scope it to, from whoami (optional; the primary product when omitted).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "body": "Several accounts asked to change status on many tasks at once.",
      "title": "Bulk-edit tasks"
    }
  ],
  "required": [
    "title"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "The idea in more detail (optional)."
    },
    "title": {
      "type": "string",
      "description": "Idea title (the only required field), e.g. 'Bulk-edit tasks'."
    },
    "insight_id": {
      "type": "string",
      "description": "Customer insight this idea came from, from list_insights (optional; welds evidence to the idea)."
    },
    "product_id": {
      "type": "string",
      "description": "Product to scope it to, from whoami (optional; the primary product when omitted)."
    }
  }
}

create_initiative

Create an initiative — a strategic effort that groups features and rolls up to a goal — and return it. Link it to a goal with objective_id (from list_objectives) to build line-of-sight. status ∈ planned|active|paused|done|abandoned (default planned); timeframe is free text ('H2 2026'). product_id defaults to the primary product. Only name is required. Then align features to it via create_feature / update_feature (initiative_id).

Argument	Type	Description
name*	string	Initiative name (the only required field), e.g. 'Win enterprise'.
status	string	Lifecycle status (optional; default 'planned').
timeframe	string	Free-text timeframe, e.g. 'Q3 2026' or 'H2 2026' (optional).
product_id	string	Product to scope it to, from whoami (optional; the primary product when omitted).
description	string	What the initiative is / why it matters (optional).
objective_id	string	Goal this rolls up to, from list_objectives (optional; builds line-of-sight).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "name": "Win enterprise",
      "timeframe": "H2 2026",
      "objective_id": "obj_123"
    }
  ],
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Initiative name (the only required field), e.g. 'Win enterprise'."
    },
    "status": {
      "enum": [
        "planned",
        "active",
        "paused",
        "done",
        "abandoned"
      ],
      "type": "string",
      "description": "Lifecycle status (optional; default 'planned')."
    },
    "timeframe": {
      "type": "string",
      "description": "Free-text timeframe, e.g. 'Q3 2026' or 'H2 2026' (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product to scope it to, from whoami (optional; the primary product when omitted)."
    },
    "description": {
      "type": "string",
      "description": "What the initiative is / why it matters (optional)."
    },
    "objective_id": {
      "type": "string",
      "description": "Goal this rolls up to, from list_objectives (optional; builds line-of-sight)."
    }
  }
}

create_objective

Create an objective, 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.

Argument	Type	Description
name*	string	Objective name (the only required field), e.g. 'Reach $50k MRR'.
period	string	Free-text period, e.g. 'Q3 2026' (optional).
parent_id	string	Parent objective id to nest under, from list_objectives (optional).
product_id	string	Product to scope it to, from whoami (optional).
description	string	Context for the objective (optional).
key_results	array	Key results to attach (optional; up to 10).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "name": "Reach $50k MRR",
      "period": "Q3 2026",
      "key_results": [
        {
          "name": "MRR",
          "unit": "USD",
          "target_value": 50000
        }
      ]
    }
  ],
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Objective name (the only required field), e.g. 'Reach $50k MRR'."
    },
    "period": {
      "type": "string",
      "description": "Free-text period, e.g. 'Q3 2026' (optional)."
    },
    "parent_id": {
      "type": "string",
      "description": "Parent objective id to nest under, from list_objectives (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product to scope it to, from whoami (optional)."
    },
    "description": {
      "type": "string",
      "description": "Context for the objective (optional)."
    },
    "key_results": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Key result name, e.g. 'MRR'."
          },
          "unit": {
            "type": "string",
            "description": "Unit, e.g. 'USD' or '%' (optional)."
          },
          "start_value": {
            "type": "number",
            "description": "Starting value (optional; default 0)."
          },
          "target_value": {
            "type": "number",
            "description": "Target value (optional)."
          }
        }
      },
      "description": "Key results to attach (optional; up to 10)."
    }
  }
}

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.

Argument	Type	Description
body	string	Page content as plain text; blank lines separate paragraphs (optional).
icon	string	An emoji icon for the page (optional).
title	string	Page title (optional; 'Untitled' when omitted).
parent_id	string	Parent page id to nest under, from list_pages (optional).
product_id	string	Product to scope it to, from whoami (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "body": "Problem\n\nUsers can't self-serve SAML today.",
      "title": "PRD: SSO"
    }
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Page content as plain text; blank lines separate paragraphs (optional)."
    },
    "icon": {
      "type": "string",
      "description": "An emoji icon for the page (optional)."
    },
    "title": {
      "type": "string",
      "description": "Page title (optional; 'Untitled' when omitted)."
    },
    "parent_id": {
      "type": "string",
      "description": "Parent page id to nest under, from list_pages (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product to scope it to, from whoami (optional)."
    }
  }
}

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.

Argument	Type	Description
version*	string	Version string (required), e.g. 'v2.4.0'.
changelog	string	What shipped (optional).
product_id	string	Product, from whoami (optional; the primary product when omitted).
released_at	string	Ship time, ISO 8601 (optional; omit for a draft).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "version": "v2.4.0",
      "changelog": "SSO + faster board",
      "released_at": "2026-07-15T00:00:00Z"
    }
  ],
  "required": [
    "version"
  ],
  "properties": {
    "version": {
      "type": "string",
      "description": "Version string (required), e.g. 'v2.4.0'."
    },
    "changelog": {
      "type": "string",
      "description": "What shipped (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product, from whoami (optional; the primary product when omitted)."
    },
    "released_at": {
      "type": "string",
      "description": "Ship time, ISO 8601 (optional; omit for a draft)."
    }
  }
}

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.

Argument	Type	Description
goal	string	The sprint goal (optional).
name*	string	Sprint name (the only required field), e.g. 'Sprint 12'.
state	string	Lifecycle state (optional; default 'future').
end_date	string	End, ISO 8601 (optional).
start_date	string	Start, ISO 8601 e.g. '2026-07-15T00:00:00Z' (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "goal": "Ship SSO",
      "name": "Sprint 12",
      "state": "active"
    }
  ],
  "required": [
    "name"
  ],
  "properties": {
    "goal": {
      "type": "string",
      "description": "The sprint goal (optional)."
    },
    "name": {
      "type": "string",
      "description": "Sprint name (the only required field), e.g. 'Sprint 12'."
    },
    "state": {
      "enum": [
        "future",
        "active"
      ],
      "type": "string",
      "description": "Lifecycle state (optional; default 'future')."
    },
    "end_date": {
      "type": "string",
      "description": "End, ISO 8601 (optional)."
    },
    "start_date": {
      "type": "string",
      "description": "Start, ISO 8601 e.g. '2026-07-15T00:00:00Z' (optional)."
    }
  }
}

create_task

Create a task and return the created task. list_id defaults to the org's first list when omitted; feature_id / insight_id link it to the spine and sprint_id schedules it into a sprint. Resolve list/status/feature/insight/member ids via pm_meta and sprint_id via list_sprints — never guess them. Only title is required.

Argument	Type	Description
title*	string	Task title (the only required field).
list_id	string	List to create the task on; resolve the id via pm_meta (optional; the org's first list when omitted).
priority	string	Priority level, urgent highest (optional).
sprint_id	string	Schedule into a sprint (optional; resolve the id via list_sprints).
status_id	string	Initial status; resolve the id via pm_meta (optional).
feature_id	string	Feature id to link on the spine, from pm_meta or list_features (optional).
insight_id	string	Insight id to link on the spine, from list_insights (optional).
description	string	Task body / details (optional).

delete_task

PERMANENTLY delete a task and return the deleted id. Irreversible — there is no undo. Cascades: the task's comments, assignees, tags, attachments, time entries, outcomes, events, relations, and its SUBTASKS are deleted with it; experiment/insight/meeting links to it are cleared. Resolve the id via list_tasks and confirm intent first — prefer update_task (e.g. move it to a done/archived status) when you only want it off the active board.

destructive

Argument	Type	Description
id*	string	Task id to permanently delete, from list_tasks (required).
confirm*	string	Safety gate — must be exactly "DELETE". Required so a bare task id can never trigger a permanent, cascading delete. Confirm with the human FIRST, in plain language naming the task, then pass it.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "task_123"
    }
  ],
  "required": [
    "id",
    "confirm"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Task id to permanently delete, from list_tasks (required)."
    },
    "confirm": {
      "enum": [
        "DELETE"
      ],
      "type": "string",
      "description": "Safety gate — must be exactly \"DELETE\". Required so a bare task id can never trigger a permanent, cascading delete. Confirm with the human FIRST, in plain language naming the task, then pass it."
    }
  }
}

get_codebase_map

The auto-generated codebase brain map for one product: a plain-language summary, the module/node/edge counts, when the map was last generated, and the labels of the modules it found. Read-only; returns the latest generated map, empty when none has been generated for the product yet. Use it to ground 'where in the code does X live?' questions and to see how the codebase splits into modules before discussing architecture or scoping engineering work. Optional product_id, from whoami; omit for the org's primary product.

read-only

Argument	Type	Description
product_id	string	Product id, from whoami (optional; the org's primary product when omitted).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id, from whoami (optional; the org's primary product when omitted)."
    }
  }
}

get_conversation

Read one support conversation: the visitor plus the full message thread, oldest first. Read-only. Resolve the conversation_id first with list_conversations — never guess it.

read-only

Argument	Type	Description
conversation_id*	string	Conversation id, from list_conversations.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "conversation_id": "conv_42"
    }
  ],
  "required": [
    "conversation_id"
  ],
  "properties": {
    "conversation_id": {
      "type": "string",
      "description": "Conversation id, from list_conversations."
    }
  }
}

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 query. The money + people + voice join on one record — call it before answering anything about a specific account.

read-only

Argument	Type	Description
query*	string	The account to resolve: an account id, a user's email, a company domain (e.g. 'acme.com'), or a company name.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "query": "acme.com"
    }
  ],
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "The account to resolve: an account id, a user's email, a company domain (e.g. 'acme.com'), or a company name."
    }
  }
}

get_device_candidates

Clusters of ≥2 end_users seen on the same device: 'anon_bridge' (high confidence — an anonymous visitor later identified) or 'device_shared' (low confidence — review only). Read-only; returns the candidate clusters, empty when none are found. Use it to find merge targets, then act with merge_end_users.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_page

Read one Page (doc / PRD) by id and return its full content. Read-only. Resolve the id first with list_pages — never guess it.

read-only

Argument	Type	Description
id*	string	Page id, from list_pages.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "page_12"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Page id, from list_pages."
    }
  }
}

get_pm_playbook

How to operate as a product manager on AIOProductOS. No arguments and no side effects — returns the same operating guide as plain text every call (deterministic): how to ground in the product brain, keep work welded to the spine (insight→feature→task→outcome), prioritise on evidence (affected accounts + MRR + reach), and what 'done' means. Call it FIRST, before planning or prioritising, to load the house rules the other tools assume.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_product_brain

A grounded snapshot of the org's product so YOU can reason about it. Returns one JSON object with: revenue + top paying accounts (ranked by MRR), web + product analytics headline metrics, the feature list, recent verbatim customer signals (newest first), and open-work counts — each block empty when that source isn't flowing yet. The time-windowed sections (revenue, cost, web + product analytics, feature usage) honour `window` (7 | 30 | 90 days, default 30). Single call, no pagination. Start here to ground, then go deeper with the dedicated list_* reads and the analytics tools. Optional product_id (the org's primary product when omitted).

read-only

Argument	Type	Description
window	number	Time window in days for the revenue, cost, and analytics sections (optional; 7, 30, or 90; default 30).
product_id	string	Product id, from whoami (optional; the org's primary product when omitted).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "window": {
      "enum": [
        7,
        30,
        90
      ],
      "type": "number",
      "default": 30,
      "description": "Time window in days for the revenue, cost, and analytics sections (optional; 7, 30, or 90; default 30)."
    },
    "product_id": {
      "type": "string",
      "description": "Product id, from whoami (optional; the org's primary product when omitted)."
    }
  }
}

get_retention

Weekly cohort retention for the product: users grouped by first-seen week (one row per cohort, newest last), with the share still active each subsequent week — a lower-triangular grid. Needs product-analytics events flowing; returns empty cohorts when the product has none. window_days default 56 = 8 weekly cohorts (min 7; roughly one extra cohort per added 7 days). product_id optional (primary product when omitted).

read-only

Argument	Type	Description
product_id	string	Product id, from whoami (optional; the org's primary product when omitted).
window_days	number	Lookback window in days (optional; default 56 = 8 weekly cohorts).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "window_days": 56
    }
  ],
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id, from whoami (optional; the org's primary product when omitted)."
    },
    "window_days": {
      "type": "number",
      "default": 56,
      "minimum": 7,
      "description": "Lookback window in days (optional; default 56 = 8 weekly cohorts)."
    }
  }
}

get_roadmap_drift

Planned vs shipped features over a window: a drift score (0-100, 100 = perfect alignment), counts (planned / shipped / on-time / slipped / unplanned / orphaned), median slip days, and the top slipped + unplanned ships. Deterministic, no LLM cost. window = week | month | quarter (default quarter); optional product_id. Read-only; returns the drift report, zeroed when nothing was planned or shipped in the window. Use it in planning reviews to check delivery against the roadmap, then open the slipped features with list_features.

read-only

Argument	Type	Description
window	string	Lookback window to compare planned vs shipped over (optional; default quarter).
product_id	string	Product id, from whoami (optional; spans all the org's products when omitted).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "window": "quarter"
    }
  ],
  "properties": {
    "window": {
      "enum": [
        "week",
        "month",
        "quarter"
      ],
      "type": "string",
      "default": "quarter",
      "description": "Lookback window to compare planned vs shipped over (optional; default quarter)."
    },
    "product_id": {
      "type": "string",
      "description": "Product id, from whoami (optional; spans all the org's products when omitted)."
    }
  }
}

get_task

Get one task by id and return it with its full comments and assignees. Read-only. Resolve the id first with list_tasks — never guess it; pair with update_task or comment_on_task to act on what you read.

read-only

Argument	Type	Description
id*	string	Task id, from list_tasks.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "task_8f3a"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Task id, from list_tasks."
    }
  }
}

get_weekly_signal_memo

The Weekly Product Signal Memo — the last 7 days of customer signal clustered into themes (insights grouped by feature, ranked by the revenue behind them) with verbatim quotes, week-over-week deltas (new / repeated / stronger / weaker), concluded experiments, and shipped releases. Deterministic — every count is off real rows, no fabricated quotes. Optional `week` (ISO 'YYYY-Www') for a past week; `generate=1` rebuilds + persists the current week now. Read-only apart from that rebuild; returns the persisted memo, empty when the requested week has none. Open a weekly review with it, then drill into a theme with list_insights.

read-only

Argument	Type	Description
week	string	ISO week to fetch, format 'YYYY-Www' e.g. '2026-W27' (optional; the latest persisted week when omitted).
generate	string	Pass '1' to rebuild and persist the current week's memo now instead of reading the stored one (optional).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "week": {
      "type": "string",
      "description": "ISO week to fetch, format 'YYYY-Www' e.g. '2026-W27' (optional; the latest persisted week when omitted)."
    },
    "generate": {
      "type": "string",
      "description": "Pass '1' to rebuild and persist the current week's memo now instead of reading the stored one (optional)."
    }
  }
}

list_artifact_versions

Version history of an artifact's AI reviews (F5): every review run is a version with its score, model, cost, who/what generated it, and whether it's the current one. Read-only; returns the version list, empty when the artifact has never been reviewed. Use it to see how a feature/experiment/page's review changed over time and to pick the version_id to pass to revert_to_version. Takes the same target_id/target_type you'd pass to review_artifact.

read-only

Argument	Type	Description
target_id*	string	Id of the reviewed feature/experiment/page — the same id passed to review_artifact.
target_type*	string	What kind of artifact target_id is: a feature (spec), an experiment (plan), or a page (doc/PRD).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "target_id": "feat_8f3a",
      "target_type": "feature"
    }
  ],
  "required": [
    "target_id",
    "target_type"
  ],
  "properties": {
    "target_id": {
      "type": "string",
      "description": "Id of the reviewed feature/experiment/page — the same id passed to review_artifact."
    },
    "target_type": {
      "enum": [
        "feature",
        "experiment",
        "page"
      ],
      "type": "string",
      "description": "What kind of artifact target_id is: a feature (spec), an experiment (plan), or a page (doc/PRD)."
    }
  }
}

list_bookings

Upcoming confirmed bookings on the org's scheduling. Read-only; returns the bookings, empty when none are scheduled. Pass include='all' for full history.

read-only

Argument	Type	Description
include	string	Pass 'all' for history (optional).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "include": {
      "enum": [
        "all"
      ],
      "type": "string",
      "description": "Pass 'all' for history (optional)."
    }
  }
}

list_channels

List the team Comms channels the connected member belongs to (membership-scoped). Read-only; returns the member's channels, empty when they belong to none. Call read_channel with a channel_id to read one.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

list_conversations

List support-chat conversations in the inbox (open + snoozed by default; pass status='all' to include closed). Read-only; returns the matching conversations, empty when the inbox is clear. Optional product_id to scope to one product; open a full thread with get_conversation.

read-only

Argument	Type	Description
status	string	Pass 'all' to include closed (optional).
product_id	string	Product id to scope to, from whoami (optional; spans all products when omitted).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "all"
      ],
      "type": "string",
      "description": "Pass 'all' to include closed (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product id to scope to, from whoami (optional; spans all products when omitted)."
    }
  }
}

list_decisions

List the org's logged decisions — title, rationale, status, and any linked feature/release/objective — newest first. Returns an empty list when none. Optional status filter (decided | proposed | revisit). Resolve a decision id here before update_decision.

read-only

Argument	Type	Description
status	string	Filter by status (optional).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "decided",
        "proposed",
        "revisit"
      ],
      "type": "string",
      "description": "Filter by status (optional)."
    }
  }
}

list_experiments

List product experiments. Returns an array where each experiment carries its hypothesis, the metric it moves, the target, its current state, and — once concluded — the verdict and the decision that came out. Read-only; empty when none match. Use it to see what's being tested before proposing new work, and cite a concluded verdict as evidence when you create_task or review_artifact. Optional product_id (from whoami) and state filter.

read-only

Argument	Type	Description
state	string	Only experiments in this state, e.g. 'running' (optional).
product_id	string	Product id to scope to, from whoami (optional; spans all products when omitted).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "state": "running"
    }
  ],
  "properties": {
    "state": {
      "type": "string",
      "description": "Only experiments in this state, e.g. 'running' (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product id to scope to, from whoami (optional; spans all products when omitted)."
    }
  }
}

list_features

The product's feature catalogue with description, status, and when each was last touched — richer than pm_meta (which is just id+name for resolution). Read-only; returns the matching features, empty when none. Optional product_id and free-text q over name+key; use a feature id from here to link a task or insight on the spine.

read-only

Argument	Type	Description
q	string	Free-text search over feature name + key (optional).
product_id	string	Product id to scope to, from whoami (optional; spans all products when omitted).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Free-text search over feature name + key (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Product id to scope to, from whoami (optional; spans all products when omitted)."
    }
  }
}

list_ideas

List the org's ideas — the native, votable idea backlog — ranked by vote count (highest first). Each returns its title, status, vote count, author, and the feature it was promoted to (if any). status ∈ new|under_review|planned|promoted|declined (optional filter). Read-only; empty when none. Ideas are distinct from insights: an idea is a proposal a team votes on; an insight is a piece of customer evidence. Resolve an idea id here before update_idea / vote_idea / promote_idea.

read-only

Argument	Type	Description
status	string	Filter by status (optional).
product_id	string	Only ideas for this product, from whoami (optional).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "status": {
      "enum": [
        "new",
        "under_review",
        "planned",
        "promoted",
        "declined"
      ],
      "type": "string",
      "description": "Filter by status (optional)."
    },
    "product_id": {
      "type": "string",
      "description": "Only ideas for this product, from whoami (optional)."
    }
  }
}

list_identity_merges

List the org's end-user merge history. Returns an array of merge events, newest first, where each carries its event id, kind (merge or unmerge), the target and source end-user ids, the reason, who ran it, when, and — for merges — whether it has already been reverted. Read-only; empty when no merges have ever run. Use it to audit identity changes and to find the event id to pass to unmerge_end_users (only un-reverted merges can be undone).

read-only

Argument	Type	Description
limit	number	Max events to return (optional; default 50, max 200).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Max events to return (optional; default 50, max 200)."
    }
  }
}

list_initiatives

List the org's initiatives — the strategic layer between goals and features (goal → initiative → feature → epic → release). Each returns its name, status, timeframe, the objective it rolls up to (if any), and its linked-feature count. Read-only; empty when none. Resolve an initiative id here before create_feature / update_feature (initiative_id) or update_initiative.

read-only

Argument	Type	Description
product_id	string	Only initiatives for this product, from whoami (optional; all products when omitted).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Only initiatives for this product, from whoami (optional; all products when omitted)."
    }
  }
}

list_insights

Search the captured insight backlog (voice of customer) — the read twin of capture_insight. Read-only; returns the matching insights newest first, empty when nothing matches. Filters: status, kind (insight|opportunity), feature_id, account_id, product_id, and free-text q over title+body; limit default 50, max 200. Use it to survey the evidence behind a feature or account before prioritising — resolve feature_id via list_features and account_id via get_customer_360.

read-only

Argument	Type	Description
q	string	Free-text search over title + body (optional).
kind	string	'insight' = raw signal; 'opportunity' = a prioritisable ask (optional).
limit	number	Max rows to return (optional; default 50, max 200).
status	string	Only insights in this workflow status (optional).
account_id	string	Only insights about this account; resolve the id via get_customer_360 (optional).
feature_id	string	Only insights linked to this feature; resolve the id via list_features or pm_meta (optional).
product_id	string	Product id to scope to, from whoami (optional; spans all products when omitted).

list_objectives

List the org's OKRs. Returns an array of objectives, each with its key results and live progress (0..1 between start and target), so you can prioritise toward what the team is actually trying to move. Read-only; empty when none are set. Read it before prioritising — tie proposed tasks to the objective they move, and cite the live progress when arguing priority. Optional product_id, from whoami.

read-only

Argument	Type	Description
product_id	string	Product id to scope to, from whoami (optional; spans all products when omitted).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id to scope to, from whoami (optional; spans all products when omitted)."
    }
  }
}

list_pages

List the in-product docs / PRDs (Pages) on the spine. Returns an array of pages with title + id only — no content, so it stays cheap to scan. Read-only; empty when none exist. Use it to find the page id, then read the full content with get_page; pair with review_artifact (target_type 'page') to critique a draft PRD. Optional product_id, from whoami.

read-only

Argument	Type	Description
product_id	string	Product id to scope to, from whoami (optional; spans all products when omitted).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id to scope to, from whoami (optional; spans all products when omitted)."
    }
  }
}

list_releases

List shipped releases. Returns an array, newest first, where each release carries its version, changelog, and ship date. Read-only; empty when nothing has shipped. Use it to answer 'what did we ship recently?', to ground a changelog or launch summary in real ship dates, and to see what went out before reading get_roadmap_drift. Optional product_id, from whoami.

read-only

Argument	Type	Description
product_id	string	Product id to scope to, from whoami (optional; spans all products when omitted).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id to scope to, from whoami (optional; spans all products when omitted)."
    }
  }
}

list_sprints

Sprints — name, goal, state, and window, newest first. Read-only; returns the matching sprints, empty when none exist. See the delivery cadence (active + recent), and resolve a sprint_id here before scheduling a task via create_task / update_task. Optional state filter (e.g. 'active').

read-only

Argument	Type	Description
state	string	Filter by state, e.g. 'active' (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "state": "active"
    }
  ],
  "properties": {
    "state": {
      "type": "string",
      "description": "Filter by state, e.g. 'active' (optional)."
    }
  }
}

list_tasks

List the org's board tasks and return the matches with their status, priority, assignees, and any linked feature/insight/sprint. Optionally narrow by status_id or list_id — resolve either via pm_meta. Read-only; returns an empty list when nothing matches. Use it to find a task id before get_task, update_task, or comment_on_task.

read-only

Argument	Type	Description
list_id	string	Only tasks on this list; resolve the id via pm_meta (optional).
status_id	string	Only tasks in this status; resolve the id via pm_meta (optional).

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "list_id": {
      "type": "string",
      "description": "Only tasks on this list; resolve the id via pm_meta (optional)."
    },
    "status_id": {
      "type": "string",
      "description": "Only tasks in this status; resolve the id via pm_meta (optional)."
    }
  }
}

merge_end_users

Merge source end-users into a target and return the merge result, including the merge event id (also recoverable later via list_identity_merges): all FK rows (events, insights, tasks, …) are re-pointed onto the target and the sources are tombstoned. A write; reversible for 30 days via unmerge_end_users. Get the candidate ids from get_device_candidates first — never guess which users to fold together. target_end_user_id and source_end_user_ids are required.

Argument	Type	Description
reason	string	Why the merge (optional, recorded).
target_end_user_id*	string	UUID of the end-user to keep, from get_device_candidates.
source_end_user_ids*	array	UUIDs of end-users to fold into the target, from get_device_candidates.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "reason": "device:anon_bridge",
      "target_end_user_id": "eu_keep",
      "source_end_user_ids": [
        "eu_discard"
      ]
    }
  ],
  "required": [
    "target_end_user_id",
    "source_end_user_ids"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "description": "Why the merge (optional, recorded)."
    },
    "target_end_user_id": {
      "type": "string",
      "description": "UUID of the end-user to keep, from get_device_candidates."
    },
    "source_end_user_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "UUIDs of end-users to fold into the target, from get_device_candidates."
    }
  }
}

pm_meta

List the org's PM lists, statuses, members, and features as id+name pairs. Read-only; returns arrays for resolution only (list_features carries the richer catalogue). Call it to turn a name into an id before create_task / update_task — never guess an id.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

post_to_channel

Post a message to a team Comms channel you belong to, as the connected member, and return the posted message. It appears live for teammates and is org-visible — keep it work-relevant. Resolve channel_id via list_channels; you can only post to channels you're a member of. Both channel_id and body are required.

Argument	Type	Description
body*	string	Message text, visible to all channel members (required).
channel_id*	string	Channel id to post into, from list_channels (required).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "body": "Shipped SSO — closing the epic.",
      "channel_id": "chan_123"
    }
  ],
  "required": [
    "channel_id",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Message text, visible to all channel members (required)."
    },
    "channel_id": {
      "type": "string",
      "description": "Channel id to post into, from list_channels (required)."
    }
  }
}

promote_idea

Promote an idea into a roadmap feature: creates a feature from the idea (name + description), stamps the idea 'promoted' and links it to the new feature, and returns the feature id. Idempotent — an already-promoted idea returns its existing feature. Resolve the id via list_ideas; only id is required. Align the new feature to an initiative/goal afterwards with update_feature.

Argument	Type	Description
id*	string	Idea id to promote, from list_ideas (required).
product_id	string	Product to create the feature under, from whoami (optional; the idea's product or the primary when omitted).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "idea_123"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Idea id to promote, from list_ideas (required)."
    },
    "product_id": {
      "type": "string",
      "description": "Product to create the feature under, from whoami (optional; the idea's product or the primary when omitted)."
    }
  }
}

read_channel

Read a Comms channel's recent messages, newest included (the connected member must be a channel member). Read-only; returns the messages, empty when the channel is silent. Resolve channel_id first with list_channels — never guess it. Optional limit.

read-only

Argument	Type	Description
limit	number	Max messages to return (optional).
channel_id*	string	Channel id, from list_channels.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "limit": 50,
      "channel_id": "chan_eng"
    }
  ],
  "required": [
    "channel_id"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max messages to return (optional)."
    },
    "channel_id": {
      "type": "string",
      "description": "Channel id, from list_channels."
    }
  }
}

reply_in_channel

Reply in a thread under a specific message in a Comms channel you belong to, as the connected member, and return the posted reply — org-visible to the channel. Resolve channel_id via list_channels and the parent message's id via read_channel. channel_id, parent_id, and body are all required.

Argument	Type	Description
body*	string	Reply text, visible to all channel members (required).
parent_id*	string	Parent message id to thread under, from read_channel (required).
channel_id*	string	Channel id, from list_channels (required).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "body": "On it — PR up in an hour.",
      "parent_id": "msg_9",
      "channel_id": "chan_123"
    }
  ],
  "required": [
    "channel_id",
    "parent_id",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Reply text, visible to all channel members (required)."
    },
    "parent_id": {
      "type": "string",
      "description": "Parent message id to thread under, from read_channel (required)."
    },
    "channel_id": {
      "type": "string",
      "description": "Channel id, from list_channels (required)."
    }
  }
}

reply_to_conversation

Send a public reply to a support-inbox conversation, as the connected member, and return the result — it goes to the end-user on the conversation's channel. A write. Resolve conversation_id via list_conversations; read the thread with get_conversation before replying. conversation_id and body are required. For an internal-only note use add_note; to close it use resolve_conversation.

Argument	Type	Description
body*	string	Public reply text sent to the end-user (required).
conversation_id*	string	Conversation id to reply to, from list_conversations (required).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "body": "Thanks for flagging — the export bug is fixed and live.",
      "conversation_id": "conv_42"
    }
  ],
  "required": [
    "conversation_id",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Public reply text sent to the end-user (required)."
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation id to reply to, from list_conversations (required)."
    }
  }
}

reschedule_booking

Reschedule a booking to a new start time (ISO 8601) and return the result — the invitee is notified. A write. Resolve booking_id via list_bookings first. booking_id and start are required.

Argument	Type	Description
start*	string	New start time, ISO 8601 (e.g. 2026-07-20T15:00:00Z) (required).
booking_id*	string	Booking id to move, from list_bookings (required).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "start": "2026-07-20T15:00:00Z",
      "booking_id": "book_7"
    }
  ],
  "required": [
    "booking_id",
    "start"
  ],
  "properties": {
    "start": {
      "type": "string",
      "description": "New start time, ISO 8601 (e.g. 2026-07-20T15:00:00Z) (required)."
    },
    "booking_id": {
      "type": "string",
      "description": "Booking id to move, from list_bookings (required)."
    }
  }
}

resolve_conversation

Mark a support-inbox conversation resolved (closed) and return the result. A write; idempotent — resolving an already-resolved conversation is a no-op. Resolve conversation_id via list_conversations first. Do it after you've replied and the ask is handled.

Argument	Type	Description
conversation_id*	string	Conversation id to resolve, from list_conversations (required).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "conversation_id": "conv_42"
    }
  ],
  "required": [
    "conversation_id"
  ],
  "properties": {
    "conversation_id": {
      "type": "string",
      "description": "Conversation id to resolve, from list_conversations (required)."
    }
  }
}

revert_to_version

Restore an earlier artifact version (F5) to current and return the now-current version: the existing current version is flipped to 'reverted' (kept for the learning signal) and the chosen version becomes current again. A write — not idempotent, since re-running reverts again. version_id is the version you want to RESTORE; get it from list_artifact_versions and never guess it. Optional reason is recorded.

Argument	Type	Description
reason	string	Why you're reverting (optional, recorded).
version_id*	string	Id of the version to restore (make current), from list_artifact_versions.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "reason": "new review missed the metric finding",
      "version_id": "ver_8f3a"
    }
  ],
  "required": [
    "version_id"
  ],
  "properties": {
    "reason": {
      "type": "string",
      "description": "Why you're reverting (optional, recorded)."
    },
    "version_id": {
      "type": "string",
      "description": "Id of the version to restore (make current), from list_artifact_versions."
    }
  }
}

review_artifact

Agent-as-critic over a DRAFT artifact (a feature spec, experiment plan, or page): checks it against a baseline PM bar — clear problem/hypothesis, a measurable success metric, evidence cited, risks named, a rollout/experiment plan — and returns structured findings (section, severity, a CONCRETE suggested fix, and a verbatim evidence quote) plus a 0-100 score. A write: each call re-runs the review and persists it as a new version (see list_artifact_versions). Resolve target_id first — via pm_meta or list_features for a feature, list_experiments for an experiment, list_pages for a page. One small LLM call; use it before sending a draft for sign-off.

Argument	Type	Description
rubric_id	string	Score against a specific rubric; omit to use the org's default rubric (or the built-in baseline).
target_id*	string	Id of the feature/experiment/page to review — from pm_meta, list_features, list_experiments, or list_pages.
target_type*	string	What kind of artifact target_id is: a feature (spec), an experiment (plan), or a page (doc/PRD).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "target_id": "feat_8f3a",
      "target_type": "feature"
    }
  ],
  "required": [
    "target_id",
    "target_type"
  ],
  "properties": {
    "rubric_id": {
      "type": "string",
      "description": "Score against a specific rubric; omit to use the org's default rubric (or the built-in baseline)."
    },
    "target_id": {
      "type": "string",
      "description": "Id of the feature/experiment/page to review — from pm_meta, list_features, list_experiments, or list_pages."
    },
    "target_type": {
      "enum": [
        "feature",
        "experiment",
        "page"
      ],
      "type": "string",
      "description": "What kind of artifact target_id is: a feature (spec), an experiment (plan), or a page (doc/PRD)."
    }
  }
}

unmerge_end_users

Undo a previous end-user merge: reads the merge ledger and re-points every FK row (events, insights, tasks, …) back to its original end-user, un-tombstoning the folded-in sources. Safe to retry — a second undo of the same merge changes nothing (it fails with already_reverted). Use to correct a wrong identity merge (merges stay reversible for 30 days). Find the event_id with list_identity_merges (pick an un-reverted merge); event_id is required.

Argument	Type	Description
event_id*	string	Id of the merge event to undo, from list_identity_merges.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "event_id": "uuid"
    }
  ],
  "required": [
    "event_id"
  ],
  "properties": {
    "event_id": {
      "type": "string",
      "description": "Id of the merge event to undo, from list_identity_merges."
    }
  }
}

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.

Argument	Type	Description
id*	string	Decision id, from list_decisions (required).
title	string	New title (optional).
status	string	New status (optional).
link_id	string	New linked id, or null to unlink (optional).
link_type	string	New link target (optional).
rationale	string	New rationale; null clears it (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "dec_123",
      "status": "revisit"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Decision id, from list_decisions (required)."
    },
    "title": {
      "type": "string",
      "description": "New title (optional)."
    },
    "status": {
      "enum": [
        "decided",
        "proposed",
        "revisit"
      ],
      "type": "string",
      "description": "New status (optional)."
    },
    "link_id": {
      "type": "string",
      "description": "New linked id, or null to unlink (optional)."
    },
    "link_type": {
      "enum": [
        "feature",
        "release",
        "objective"
      ],
      "type": "string",
      "description": "New link target (optional)."
    },
    "rationale": {
      "type": "string",
      "description": "New rationale; null clears it (optional)."
    }
  }
}

update_experiment

Argument	Type	Description
id*	string	Experiment id, from list_experiments (required).
state	string	Build-Measure-Learn stage (optional).
title	string	New title (optional).
metric	string	New metric; null clears it (optional).
result	string	Free-text result / what you learned; null clears it (optional).
target	string	New target; null clears it (optional).
verdict	string	Outcome (optional).
decision	string	What you'll do next (optional).
hypothesis	string	New hypothesis; null clears it (optional).

Input schema (JSON)

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.

Argument	Type	Description
id*	string	Feature id to update, from list_features (required).
name	string	New name (optional).
status	string	Lifecycle status (optional).
description	string	New description; null clears it (optional).
target_date	string	Target ship date 'YYYY-MM-DD', or null to clear (optional).
mark_shipped	boolean	true stamps the ship date now; false clears it (optional).
objective_id	string	Align directly under this objective, from list_objectives; null unlinks (optional).
initiative_id	string	Align under this initiative (line-of-sight), from list_initiatives; null unlinks (optional).

Input schema (JSON)

update_idea

Update an idea's title / body / status and return it; omitted fields unchanged. status ∈ new|under_review|planned|promoted|declined (set 'promoted' via promote_idea instead, so a feature is actually created). Resolve the id via list_ideas; only id is required.

Argument	Type	Description
id*	string	Idea id, from list_ideas (required).
body	string	New body; null clears it (optional).
title	string	New title (optional).
status	string	New status (optional; prefer promote_idea over setting 'promoted' by hand).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "idea_123",
      "status": "under_review"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Idea id, from list_ideas (required)."
    },
    "body": {
      "type": "string",
      "description": "New body; null clears it (optional)."
    },
    "title": {
      "type": "string",
      "description": "New title (optional)."
    },
    "status": {
      "enum": [
        "new",
        "under_review",
        "planned",
        "promoted",
        "declined"
      ],
      "type": "string",
      "description": "New status (optional; prefer promote_idea over setting 'promoted' by hand)."
    }
  }
}

update_initiative

Update an initiative and return it; omitted fields are unchanged. Re-point it to a different goal with objective_id (null unlinks). status ∈ planned|active|paused|done|abandoned. Resolve the id via list_initiatives; only id is required.

Argument	Type	Description
id*	string	Initiative id, from list_initiatives (required).
name	string	New name (optional).
status	string	Lifecycle status (optional).
timeframe	string	New timeframe; null clears it (optional).
description	string	New description; null clears it (optional).
objective_id	string	New parent goal, from list_objectives; null unlinks (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "init_123",
      "status": "active"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Initiative id, from list_initiatives (required)."
    },
    "name": {
      "type": "string",
      "description": "New name (optional)."
    },
    "status": {
      "enum": [
        "planned",
        "active",
        "paused",
        "done",
        "abandoned"
      ],
      "type": "string",
      "description": "Lifecycle status (optional)."
    },
    "timeframe": {
      "type": "string",
      "description": "New timeframe; null clears it (optional)."
    },
    "description": {
      "type": "string",
      "description": "New description; null clears it (optional)."
    },
    "objective_id": {
      "type": "string",
      "description": "New parent goal, from list_objectives; null unlinks (optional)."
    }
  }
}

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.

Argument	Type	Description
id*	string	Key result id, from list_objectives (required).
name	string	New name (optional).
unit	string	New unit, e.g. 'USD'; null clears it (optional).
start_value	number	New starting baseline (optional).
target_value	number	New target value; null clears it (optional).
current_value	number	New current value (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "kr_123",
      "current_value": 42000
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Key result id, from list_objectives (required)."
    },
    "name": {
      "type": "string",
      "description": "New name (optional)."
    },
    "unit": {
      "type": "string",
      "description": "New unit, e.g. 'USD'; null clears it (optional)."
    },
    "start_value": {
      "type": "number",
      "description": "New starting baseline (optional)."
    },
    "target_value": {
      "type": "number",
      "description": "New target value; null clears it (optional)."
    },
    "current_value": {
      "type": "number",
      "description": "New current value (optional)."
    }
  }
}

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.

Argument	Type	Description
id*	string	Objective id, from list_objectives (required).
name	string	New name (optional).
period	string	New period, e.g. 'Q4 2026'; null clears it (optional).
description	string	New description; null clears it (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "obj_123",
      "name": "Reach $75k MRR"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Objective id, from list_objectives (required)."
    },
    "name": {
      "type": "string",
      "description": "New name (optional)."
    },
    "period": {
      "type": "string",
      "description": "New period, e.g. 'Q4 2026'; null clears it (optional)."
    },
    "description": {
      "type": "string",
      "description": "New description; null clears it (optional)."
    }
  }
}

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.

Argument	Type	Description
id*	string	Page id, from list_pages (required).
body	string	New content as plain text; blank lines separate paragraphs. REPLACES existing content (optional).
icon	string	New emoji icon; null clears it (optional).
title	string	New title (optional).
archived	boolean	true archives (hides) the page; false restores it (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "page_123",
      "archived": true
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Page id, from list_pages (required)."
    },
    "body": {
      "type": "string",
      "description": "New content as plain text; blank lines separate paragraphs. REPLACES existing content (optional)."
    },
    "icon": {
      "type": "string",
      "description": "New emoji icon; null clears it (optional)."
    },
    "title": {
      "type": "string",
      "description": "New title (optional)."
    },
    "archived": {
      "type": "boolean",
      "description": "true archives (hides) the page; false restores it (optional)."
    }
  }
}

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.

Argument	Type	Description
id*	string	Release id, from list_releases (required).
version	string	New version (optional).
changelog	string	New changelog; null clears it (optional).
released_at	string	Ship time ISO 8601, or null for draft (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "rel_123",
      "released_at": "2026-07-15T12:00:00Z"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Release id, from list_releases (required)."
    },
    "version": {
      "type": "string",
      "description": "New version (optional)."
    },
    "changelog": {
      "type": "string",
      "description": "New changelog; null clears it (optional)."
    },
    "released_at": {
      "type": "string",
      "description": "Ship time ISO 8601, or null for draft (optional)."
    }
  }
}

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.

Argument	Type	Description
id*	string	Sprint id, from list_sprints (required).
goal	string	New goal; null clears it (optional).
name	string	New name (optional).
state	string	Lifecycle state; 'closed' completes it (optional).
end_date	string	End, ISO 8601, or null (optional).
start_date	string	Start, ISO 8601, or null (optional).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "spr_123",
      "state": "closed"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Sprint id, from list_sprints (required)."
    },
    "goal": {
      "type": "string",
      "description": "New goal; null clears it (optional)."
    },
    "name": {
      "type": "string",
      "description": "New name (optional)."
    },
    "state": {
      "enum": [
        "future",
        "active",
        "closed"
      ],
      "type": "string",
      "description": "Lifecycle state; 'closed' completes it (optional)."
    },
    "end_date": {
      "type": "string",
      "description": "End, ISO 8601, or null (optional)."
    },
    "start_date": {
      "type": "string",
      "description": "Start, ISO 8601, or null (optional)."
    }
  }
}

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). Pass sprint_id: null to remove the task from its sprint. Resolve ids first — the task via get_task/list_tasks, and status/feature/insight/sprint/member ids via pm_meta and the list_* reads — never guess them. Only id is required.

Argument	Type	Description
id*	string	Task id, from list_tasks or get_task.
title	string	New title (optional; omitted fields stay unchanged).
priority	string	New priority level, urgent highest (optional).
sprint_id	string	Move into a sprint, or null to remove (optional; resolve via list_sprints).
status_id	string	New status; resolve the id via pm_meta (optional).
feature_id	string	Feature id to link on the spine, from pm_meta or list_features (optional).
insight_id	string	Insight id to link on the spine, from list_insights (optional).
description	string	New body / details (optional).

vote_idea

Cast (or remove) the connected member's vote on an idea and return the new vote state. Adds your vote by default; pass remove:true to take it back. One vote per member — voting twice is a no-op. Resolve the id via list_ideas; only id is required.

Argument	Type	Description
id*	string	Idea id, from list_ideas (required).
remove	boolean	true removes your vote instead of adding it (optional; default false).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "id": "idea_123"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Idea id, from list_ideas (required)."
    },
    "remove": {
      "type": "boolean",
      "description": "true removes your vote instead of adding it (optional; default false)."
    }
  }
}

whoami

Show the connected AIOProductOS identity (org, member) AND the org's products (id, name, is_primary). Read-only; returns the identity plus the product list. For a multi-product org, call this first to get the product ids, then pass one as `product_id` to any product-scoped tool; omit product_id to use the primary.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

{
  "type": "object",
  "examples": [
    {
      "id": "exp_123",
      "state": "learn",
      "verdict": "validated",
      "decision": "persevere"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Experiment id, from list_experiments (required)."
    },
    "state": {
      "enum": [
        "hypothesis",
        "build",
        "measure",
        "learn"
      ],
      "type": "string",
      "description": "Build-Measure-Learn stage (optional)."
    },
    "title": {
      "type": "string",
      "description": "New title (optional)."
    },
    "metric": {
      "type": "string",
      "description": "New metric; null clears it (optional)."
    },
    "result": {
      "type": "string",
      "description": "Free-text result / what you learned; null clears it (optional)."
    },
    "target": {
      "type": "string",
      "description": "New target; null clears it (optional)."
    },
    "verdict": {
      "enum": [
        "validated",
        "invalidated"
      ],
      "type": "string",
      "description": "Outcome (optional)."
    },
    "decision": {
      "enum": [
        "pivot",
        "persevere"
      ],
      "type": "string",
      "description": "What you'll do next (optional)."
    },
    "hypothesis": {
      "type": "string",
      "description": "New hypothesis; null clears it (optional)."
    }
  }
}

{
  "type": "object",
  "examples": [
    {
      "id": "feat_123",
      "mark_shipped": true
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Feature id to update, from list_features (required)."
    },
    "name": {
      "type": "string",
      "description": "New name (optional)."
    },
    "status": {
      "enum": [
        "active",
        "discovered",
        "archived"
      ],
      "type": "string",
      "description": "Lifecycle status (optional)."
    },
    "description": {
      "type": "string",
      "description": "New description; null clears it (optional)."
    },
    "target_date": {
      "type": "string",
      "description": "Target ship date 'YYYY-MM-DD', or null to clear (optional)."
    },
    "mark_shipped": {
      "type": "boolean",
      "description": "true stamps the ship date now; false clears it (optional)."
    },
    "objective_id": {
      "type": "string",
      "description": "Align directly under this objective, from list_objectives; null unlinks (optional)."
    },
    "initiative_id": {
      "type": "string",
      "description": "Align under this initiative (line-of-sight), from list_initiatives; null unlinks (optional)."
    }
  }
}