Docs: Tool reference
planning toolset

get_report

Get a report. Reports on feedback over a date range. type: overview (new posts, votes, comments over time vs the previous period), top_posts (most votes gained), status_flow, revenue_at_stake (open and in-progress posts by voters' companies' MRR), customer_requests (what each company asked for, with priority, renewal and owner), stale_posts (in-progress posts idle 4+ weeks), board_activity or member_activity. range presets roll forward (default last_30_days); custom takes from and to. Rows carry admin links and drill-down filters for search_posts. Team only. No side effects.

Toolset
planning
Who can call it
OwnersManagersContributorsAPI keys
REST
GET /api/v1/w/{workspace}/reports/{type}
Behavior
read-onlyidempotent

Input

FieldTypeDescription
typerequiredone of: overview, top_posts, status_flow, revenue_at_stake, customer_requests, stale_posts, board_activity, member_activity
rangeone of: last_7_days, last_30_days, last_90_days, last_12_months, this_month, last_month, this_quarter, last_quarter, this_year, last_year, all_time, custom Default: "last_30_days".
fromstringcustom ranges: first day, YYYY-MM-DD.
tostringcustom ranges: last day, YYYY-MM-DD (inclusive).
daysintegerstale_posts: days without an update (default 28).
limitintegerRows (default 25, max 200). Default: 25.

Output

FieldTypeDescription
workspacerequiredstring
rangerequiredobject
generated_atrequiredstring
reportrequiredobject

Calling it

// MCP: tools/call
{ "name": "get_report", "arguments": {"type":"<one of: overview, top_posts, status_flow, revenue_at_stake, customer_requests, stale_posts, board_activity, member_activity>"} }

// Typed client
await carechannel.get_report({"type":"<one of: overview, top_posts, status_flow, revenue_at_stake, customer_requests, stale_posts, board_activity, member_activity>"});