MCP Tool Reference
Detailed reference for each tool exposed by the FeedbackJar MCP server. With an account token pinned to a single project via X-Organization-Id, the organization_id parameter does not apply.
list_organizations
List all projects 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 project’s id, name, slug, and your role. Use the id as organization_id in other tool calls.
Example prompt
List my FeedbackJar projects, then show the top open bugs in the FeedbackJar project.list_posts
List feedback posts sorted by vote count.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Project 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 and merge info: mergedInto (the post this one was merged into, or null) and mergedPosts (posts that were merged into this one).
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Project 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 | Project 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 project.update_status
Update a post’s status.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Project 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 | Project 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 | Project 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 | Project 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) |
onBehalfOfEmail | string | Optional. File the post as this person (a member is created if needed). Owner/admin only |
onBehalfOfName | string | Optional display name if they aren’t a member yet |
notifyAuthor | boolean | With onBehalfOfEmail: false skips emailing them about comments and status changes. Default true |
Posts created via MCP are attributed to [Project Name] MCP and show the project icon as the author avatar. With onBehalfOfEmail they are attributed to that person instead.
Example prompt
Create a bug report on board cm1abc123 titled "Login fails on Safari" with tagIds ["tag1", "tag2"]vote_on_behalf
Upvote a post as another person by email. A member is created if they don’t exist yet. Owner/admin only.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Project ID — account tokens only |
id | string | Post ID |
email | string | Email of the person the vote is cast for |
name | string | Optional display name if they aren’t a member yet |
Example prompt
Add a vote on post cm1abc123 on behalf of jane@acme.commerge_posts
Merge a duplicate post into a target post. Votes from the source transfer to the target.
To merge several duplicates into one post, call it once per duplicate with the same targetId. Use get_post on the target to see everything merged into it.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Project 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 project (names and IDs).
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Project ID — account tokens only |
list_tags
List all tags in the project.
Parameters
| Name | Type | Description |
|---|---|---|
organization_id | string | Project ID — account tokens only |