Agents & MCP
Tool catalog
The 15 MCP tools and when to reach for each.
| Tool | Use it to |
|---|
list_posts | List posts, filtered by board/status, sorted by votes or recency |
get_post | Read one post in full, discussion included |
search_posts | Hybrid semantic + keyword search — run this before filing anything |
get_roadmap | Posts grouped by roadmap columns |
what_to_build_next | Demand-ranked open feedback with the scoring shown per post |
| Tool | Use it to |
|---|
create_post | File feedback (markdown). Search first to avoid duplicates |
vote_post | Upvote on behalf of the authenticated principal (idempotent) |
| Tool | Use it to |
|---|
update_post_status | Move a post between statuses, or approve pending moderation |
find_duplicates | Semantic duplicate candidates for an existing post |
merge_post | Merge a duplicate into a canonical post — fully reversible |
unmerge_post | Reverse a merge losslessly |
| Tool | Use it to |
|---|
get_workspace_context | Brand voice + recent changelogs as style examples — fetch before writing |
create_changelog | Draft or publish an entry; link the shipped posts |
publish_changelog | Publish an existing draft |
list_changelogs | List entries, drafts included when authorized |
what_to_build_next scores votes + 0.5 × comments with a 90-day
half-life on post age, and returns the breakdown — re-weight it yourself if
your priorities differ.- Guest content carries
verified: false; filter it when vote integrity
matters.
- Merging is link-only and lossless — see
Triage like a teammate for the full contract.