Docs: Tool reference
core toolset

count_posts

Count posts. Counts posts for up to 20 named filters in one call, e.g. needs_review (moderation pending), mine (owner is me) and stale (in progress, idle 4+ weeks). Each count takes the same text, board, category, status and filter DSL as search_posts; merged posts aren't counted and end users count only what they can see. Use it for "how many" questions and dashboards instead of paging through search_posts. No side effects.

Toolset
core
Who can call it
OwnersManagersContributorsCustomersAPI keysVisitors
REST
POST /api/v1/w/{workspace}/posts/count
Behavior
read-onlyidempotent

Input

FieldTypeDescription
countsrequiredarray of objectThe counts to make, each with its own key.

Output

FieldTypeDescription
countsrequiredarray of object

Calling it

// MCP: tools/call
{ "name": "count_posts", "arguments": {"counts":"<array of object>"} }

// Typed client
await carechannel.count_posts({"counts":"<array of object>"});