@feedboon/mcp-server

MCP server for Feedboon — manage visual bug reports from Claude Code, Cursor, and Windsurf.

---

Feedboon is an AI-first visual feedback tool for websites. Users capture screenshots, annotate bugs, and collect feedback — and this MCP server lets you manage it all without leaving your IDE.

Features

Tool	Description
list_projects	List all projects accessible to the authenticated user
list_feedback	List feedback items for a project with optional status/priority filters
get_feedback	Get detailed feedback including screenshot URL, metadata, console errors, and comments
update_feedback	Update feedback status, priority, title, or description
add_comment	Add a comment to a feedback item

Quick Start

1. Get your API key

Sign in at app.feedboon.com → Account → API Keys → Create API Key

Copy the fbk_... value (shown only once).

2. Connect to your IDE

Claude Code

claude mcp add feedboon -e FEEDBOON_API_KEY=fbk_your_key -- npx -y @feedboon/mcp-server

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "feedboon": {
      "command": "npx",
      "args": ["-y", "@feedboon/mcp-server"],
      "env": {
        "FEEDBOON_API_KEY": "fbk_your_key_here"
      }
    }
  }
}

Windsurf

Add to your MCP configuration (same format as Cursor):

{
  "mcpServers": {
    "feedboon": {
      "command": "npx",
      "args": ["-y", "@feedboon/mcp-server"],
      "env": {
        "FEEDBOON_API_KEY": "fbk_your_key_here"
      }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "feedboon": {
      "command": "npx",
      "args": ["-y", "@feedboon/mcp-server"],
      "env": {
        "FEEDBOON_API_KEY": "fbk_your_key_here"
      }
    }
  }
}

Global Install (Alternative)

npm install -g @feedboon/mcp-server
FEEDBOON_API_KEY=fbk_your_key feedboon-mcp

3. Start using it

Ask your AI assistant to interact with Feedboon:

> Show all new bugs in my project

> Get details for feedback FB-007

> Mark FB-007 as done and add a comment "Fixed in commit abc123"

Environment Variables

Variable	Required	Default	Description
FEEDBOON_API_KEY	Yes	—	Your API key from app.feedboon.com/account/api-keys
FEEDBOON_API_URL	No	https://api.feedboon.com	Custom API URL (for self-hosted instances)

Tools Reference

list_projects

List all projects accessible to the authenticated user.

Parameters: None

Example output:

Found 2 project(s):

- **Acme Corp** (acme.com) — ID: `proj_abc` — 12 feedback items
- **Demo Site** (demo.example.com) — ID: `proj_xyz` — 3 feedback items

list_feedback

List feedback items for a project with optional filtering.

Parameters:

Parameter	Type	Required	Description
project_id	string	Yes	Project ID (UUID)
status	string	No	Filter: new, in_progress, review, done, closed
priority	string	No	Filter: low, medium, high, critical
page	number	No	Page number (default: 1)
per_page	number	No	Items per page (default: 20, max: 100)

Example output:

Found 3 feedback item(s) (page 1/1):

🟡 **FB-007** 🔴 Checkout button not working
   /checkout | Chrome | ID: `uuid-here`

🔵 **FB-003** 🟠 Image not loading on product page
   /products/123 | Safari | ID: `uuid-here`

get_feedback

Get full details about a specific feedback item.

Parameters:

Parameter	Type	Required	Description
feedback_id	string	Yes	Feedback ID (UUID)

Returns: Title, status, priority, description, clicked element selector, browser/OS environment, console errors with source locations, screenshot URL, and all comments.

update_feedback

Update a feedback item's status, priority, title, or description.

Parameters:

Parameter	Type	Required	Description
feedback_id	string	Yes	Feedback ID (UUID)
status	string	No	New status
priority	string	No	New priority
title	string	No	Updated title
description	string	No	Updated description

add_comment

Add a comment to a feedback item. Comments are automatically marked as AI-generated.

Parameters:

Parameter	Type	Required	Description
feedback_id	string	Yes	Feedback ID (UUID)
content	string	Yes	Comment text

Development

# Clone the repo
git clone https://github.com/ilyapavlov/feedboon-mcp.git
cd feedboon-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally (for development)
FEEDBOON_API_KEY=fbk_your_key npm run dev

# Type check
npm run type-check

# Lint
npm run lint

Project Structure

src/
  index.ts              # Server entry point, tool registration
  api/
    client.ts           # HTTP client for Feedboon REST API
  tools/
    list-projects.ts    # list_projects tool
    list-feedback.ts    # list_feedback tool
    get-feedback.ts     # get_feedback tool
    update-feedback.ts  # update_feedback tool
    add-comment.ts      # add_comment tool

How It Works

This MCP server communicates with the Feedboon REST API using your API key. It runs locally on your machine via stdio transport and does not store any data.

Your IDE (Claude Code / Cursor / Windsurf)
  ↕ MCP Protocol (stdio)
@feedboon/mcp-server (runs locally)
  ↕ HTTPS (Bearer token auth)
Feedboon API (api.feedboon.com)
  ↕
Supabase (database)

Links

• Feedboon Website
• Dashboard
• Documentation
• API Reference
• Report Issues

License

MIT