MCP Server

FeedbackJar exposes a Model Context Protocol (MCP) endpoint so AI coding agents like Claude Code and Cursor can read feedback, update statuses, and reply to posts — directly from your editor.

How it works

A user reports a bug through the widget (with browser info, page URL, and console errors already attached)
Your coding agent reads the top-voted issues via the FeedbackJar MCP server
It fixes the bug, marks the post as Completed, and replies with a note
Every voter gets an email notification automatically

Setup

1. Create an API token

Two options:

Workspace token (fj_live_) — go to Settings → API Tokens in your workspace. Scoped to that workspace only. Best when you only work in one project.
Account token (fj_user_) — go to Account → API Tokens. Works across all your workspaces. Best when one agent config should access multiple projects.

See the API Tokens guide for details.

2. Add to your agent config

Pick your coding agent for a copy-paste setup guide:

Agent	Guide
Cursor
Claude Code
GitHub Copilot
OpenAI Codex
Google Antigravity
Grok CLI

Or use the generic config below if your agent isn’t listed. See all guides at /mcp.

Claude Code — add to .mcp.json in your project root or your global MCP config.

Cursor — add to .cursor/mcp.json using the same format.

Token in URL (alternative)

If your client cannot set request headers, pass the API token as a query parameter on the MCP URL:

json

{
  "mcpServers": {
    "feedbackjar": {
      "type": "http",
      "url": "https://api.feedbackjar.com/mcp?token=fj_live_..."
    }
  }
}

The Authorization header is preferred when supported — URL tokens may appear in proxy logs and shell history. Send the API token on every request — the server is stateless and does not rely on MCP session IDs.

Workspace token

The token is already scoped to one workspace — no extra headers needed:

json

{
  "mcpServers": {
    "feedbackjar": {
      "type": "http",
      "url": "https://api.feedbackjar.com/mcp",
      "headers": {
        "Authorization": "Bearer fj_live_..."
      }
    }
  }
}

Account token — multi-workspace (recommended)

Use a single account token across all your workspaces. The agent calls list_organizations first, then passes organization_id to other tools:

json

{
  "mcpServers": {
    "feedbackjar": {
      "type": "http",
      "url": "https://api.feedbackjar.com/mcp",
      "headers": {
        "Authorization": "Bearer fj_user_..."
      }
    }
  }
}

Account token — single workspace

Pin the token to one workspace by adding X-Organization-Id. Tools behave like a workspace token (no organization_id param needed):

json

{
  "mcpServers": {
    "feedbackjar": {
      "type": "http",
      "url": "https://api.feedbackjar.com/mcp",
      "headers": {
        "Authorization": "Bearer fj_user_...",
        "X-Organization-Id": "cln1abc..."
      }
    }
  }
}

3. Use it

Once connected, ask your agent:

plaintext

What are the top open bugs in FeedbackJar?

plaintext

Fix the top-voted bug and mark it as completed.

plaintext

Reply to post cm1abc123 with "Fixed in v2.4.0".

Available tools

Tools depend on your token type and permissions. Workspace tokens get full access to their workspace. Account tokens only register tools matching the permissions you selected when creating the token.

Tool	Description	Account token (multi-workspace)
`list_organizations`	List workspaces your token can access	Always available
`list_posts`	List feedback posts, sorted by votes. Filter by status, type, or board.	Requires `organization_id`
`get_post`	Get a single post with full widget metadata (browser, OS, page URL, console errors).	Requires `organization_id`
`search_posts`	Search posts by keyword in title and content.	Requires `organization_id`
`update_status`	Update a post’s status: `OPEN`, `IN_PROGRESS`, `COMPLETED`, `CLOSED`.	Requires `organization_id`
`update_post`	Update a post’s type, status, title, content, visibility, or board.	Requires `organization_id`
`reply_to_post`	Add a comment to a post.	Requires `organization_id`
`create_post`	Create a new feedback post.	Requires `organization_id`
`merge_posts`	Merge a duplicate post into a target post. Votes transfer to the target.	Requires `organization_id`
`list_boards`	List all boards in the workspace.	Requires `organization_id`
`list_tags`	List all tags in the workspace.	Requires `organization_id`

With an account token pinned to a single workspace via X-Organization-Id, the organization_id column does not apply — tools work the same as with a workspace token.

A read-only account token (posts:read, boards:read, tags:read) will only show read tools — write tools like update_status, update_post, and create_post won’t appear.

See the MCP Tool Reference for parameters, example prompts, and return values for each tool.