MCP Tool Reference
Detailed reference for each tool exposed by the FeedbackJar MCP server. With an account token pinned to a single workspace via X-Organization-Id, the organization_id parameter does not apply.
list_organizations
List all workspaces your account token can access. Only available with account tokens that do not include X-Organization-Id in the MCP config.
Parameters: none
Returns each workspace’s id, name, slug, and your role. Use the id as organization_id in other tool calls.
Example prompt
List my FeedbackJar workspaces, then show the top open bugs in the FeedbackJar workspace.list_posts
List feedback posts sorted by vote count.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only (get from list_organizations) |
status | string | OPEN, IN_PROGRESS, COMPLETED, CLOSED, PENDING, MERGED |
type | string | BUG, FEATURE_REQUEST, FEEDBACK, QUESTION, IDEA, REVIEW |
boardId | string | Filter to a specific board |
sortBy | string | voteCount (default), createdAt, updatedAt |
sortOrder | string | desc (default) or asc |
limit | number | Max results (1–100, default 20) |
cursor | string | Pagination cursor |
Example prompt
List the top 5 open bugs.get_post
Get a single post by ID, including full widget metadata.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |
id | string | Post ID |
The metadata field contains everything the widget captured: browser name and version, OS, page URL, viewport, screen resolution, device memory, network type, and a timestamp — everything an agent needs to reproduce the bug.
search_posts
Search feedback posts by keyword in title and content.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |
q | string | Search query |
limit | number | Max results (1–100, default 20) |
Example prompt
Search for posts mentioning "sidebar" in the FeedbackJar workspace.update_status
Update a post’s status.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |
id | string | Post ID |
status | string | OPEN, IN_PROGRESS, COMPLETED, or CLOSED |
Example prompt
Mark post cm1abc123 as COMPLETED.update_post
Update a feedback post. Use this to change the post type (e.g. from FEATURE_REQUEST to BUG), status, title, content, visibility, or board.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |
id | string | Post ID |
title | string | New title |
content | string | New body |
type | string | BUG, FEATURE_REQUEST, FEEDBACK, QUESTION, IDEA, REVIEW |
status | string | OPEN, IN_PROGRESS, COMPLETED, or CLOSED |
visibility | string | PUBLIC, UNLISTED, or PRIVATE |
boardId | string | Move post to a different board |
At least one optional field must be provided.
Example prompt
Change post cm1abc123 from FEATURE_REQUEST to BUG.reply_to_post
Add a comment to a post. Useful for letting users know a bug has been fixed.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |
id | string | Post ID |
content | string | Comment text |
Example prompt
Reply to post cm1abc123: "Fixed in v2.4.0 — update and let us know if it's still happening."create_post
Create a new feedback post.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |
boardId | string | Board to post to |
title | string | Post title |
content | string | Post body |
type | string | FEATURE_REQUEST (default), BUG, FEEDBACK, QUESTION, IDEA, REVIEW |
tagIds | string[] | Optional tag IDs to assign (use list_tags to find IDs) |
Posts created via MCP are attributed to [Workspace Name] MCP and show the workspace icon as the author avatar.
Example prompt
Create a bug report on board cm1abc123 titled "Login fails on Safari" with tagIds ["tag1", "tag2"]merge_posts
Merge a duplicate post into a target post. Votes from the source transfer to the target.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |
sourceId | string | Duplicate post ID to merge away |
targetId | string | Post to merge into |
list_boards
List all boards in the workspace (names and IDs).
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |
list_tags
List all tags in the workspace.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Workspace ID — account tokens only |