Docs: Tool reference
core toolset

search_posts

Search posts. Finds posts by text and filters, sorted and paginated, with excerpts rather than full bodies (get_post has those). Shortcuts board, category and status take slugs or names; filter takes the full DSL for anything else (votes, dates, status_type, author, any/not). Sorts: trending (default), top, new, recently_updated, status_changed, or relevance (default when text is given). End users see public boards only. No side effects.

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

Input

FieldTypeDescription
textstringWords in the title or body.
boardstringBoard slug, name or ID.
categorystringCategory name, slug or ID.
statusstringStatus name or ID, e.g. "Planned".
filterobjectFilter DSL (Appendix A). A condition is {"field","op","value"}; groups are {"all":[...]}, {"any":[...]} or {"not":{...}}, nested up to 3 deep. Fields: text, board, category, status, status_type, author, moderation_state, tag, owner, has_owner, on_roadmap, eta, author_company, voter_company, voter_segment, mrr_at_stake, votes, comments, created_at, updated_at, status_changed_at, custom.<key>, votes_priority.<level>. Operators: eq, neq, in, nin (lists), gt, gte, lt, lte, between ([low, high]), contains (text), exists (category), within_days (dates). Example: {"all":[{"field":"board","op":"eq","value":"bugs"},{"field":"votes","op":"gte","value":10}]}
sortone of: trending, top, new, recently_updated, status_changed, relevance
limitintegerItems per page (default 25, max 100). Default: 25.
cursorstringPass the previous response's next_cursor to get the next page.

Output

FieldTypeDescription
itemsrequiredarray of object
sortrequiredone of: trending, top, new, recently_updated, status_changed, relevance
next_cursorrequiredstring or nullCursor for the next page, or null when this is the last page.

Calling it

// MCP: tools/call
{ "name": "search_posts", "arguments": {} }

// Typed client
await carechannel.search_posts({});