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
| Field | Type | Description |
|---|---|---|
text | string | Words in the title or body. |
board | string | Board slug, name or ID. |
category | string | Category name, slug or ID. |
status | string | Status name or ID, e.g. "Planned". |
filter | object | Filter 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}]} |
sort | one of: trending, top, new, recently_updated, status_changed, relevance | |
limit | integer | Items per page (default 25, max 100). Default: 25. |
cursor | string | Pass the previous response's next_cursor to get the next page. |
Output
| Field | Type | Description |
|---|---|---|
itemsrequired | array of object | |
sortrequired | one of: trending, top, new, recently_updated, status_changed, relevance | |
next_cursorrequired | string or null | Cursor 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({});