Feedbucket MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Feedbucket MCP Servershow me the 5 most recent unresolved feedback items"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Feedbucket MCP Server
A Model Context Protocol (MCP) server that lets AI assistants (Claude Code, Cursor) manage website feedback from Feedbucket.
Beta Software: This project is in beta. Use at your own risk. Please report issues on GitHub.
Prerequisites
Before installing this MCP server, make sure you have:
A Feedbucket account
Feedbucket installed on your website
Protected mode enabled (recommended):
Go to Widget Settings
Set "Trigger Feedbucket using a query string" to Yes
Save settings and copy your secret key
Related MCP server: Featurebase MCP Server
Quick Start
1. Install from npm
npm install -g feedbucket-mcp2. Run the setup wizard
# For protected projects:
feedbucket-setup https://your-website.com YOUR_FEEDBUCKET_SECRET
# For public projects:
feedbucket-setup https://your-website.comThe setup script automatically:
Extracts the project ID from your website HTML
Fetches the private key from Feedbucket API
Configures Claude Code and Cursor
3. Restart your IDE
Restart Claude Code or Cursor to load the new MCP server.
4. Start using it
Ask your AI assistant:
"Show me unresolved feedback from Feedbucket"
"What's the feedback summary for this project?"
"Add a comment to feedback #12345 saying we've fixed this"
Alternative: Clone from GitHub
If you prefer to clone the repository:
git clone https://github.com/swiftcomza/feedbucket-mcp.git
cd feedbucket-mcp
npm install && npm run build
npm run setup -- https://your-website.com YOUR_FEEDBUCKET_SECRETAvailable Tools
Tool | Description |
| List and filter feedback with smart summarization |
| Get full details of a specific feedback item |
| Quick project overview (total, resolved, by type, recent activity) |
| Add comments to feedback items |
| Mark feedback as resolved |
| Check API connection status |
feedback_list
List feedback with powerful filtering:
Parameters:
- resolved (boolean): Filter by resolution status
- limit (number): Items to retrieve (default: 10, max: 50)
- offset (number): Skip items for pagination
- summary (boolean): Return condensed format (default: true)
- page_filter (string): Filter by page URL (partial match)
- reporter_filter (string): Filter by reporter name
- feedback_type (string): 'screenshot', 'video', or 'text'
- created_after (string): ISO date filterfeedback_get
Get complete details for a single feedback item:
Parameters:
- feedback_id (number, required): The feedback IDReturns full text, all comments, attachments, browser/device info, and console logs.
feedback_stats
Get a quick project health overview:
Returns:
- Total feedback count
- Resolved vs unresolved breakdown
- Feedback by type (screenshot/video/text)
- Recent activity (7 days, 30 days)
- Top 5 pages with most feedbackfeedback_comment
Add a comment to a feedback item:
Parameters:
- feedback_id (number, required): The feedback ID
- comment (string, required): Comment text
- reporter_name (string): Defaults to "Claude AI Assistant"
- reporter_email (string): Defaults to "claude@anthropic.com"
- resolve (boolean): Also resolve the feedback (default: false)feedback_resolve
Mark a feedback item as resolved:
Parameters:
- feedback_id (number, required): The feedback IDSetup Options
Automatic Setup (recommended)
# Protected project - provide URL and secret
npm run setup -- https://your-website.com YOUR_SECRET
# Public project - just the URL
npm run setup -- https://your-website.comManual Project ID (if auto-detection fails)
# With project ID only (public)
npm run setup -- --project-id tMbUCuQ4FeFJVViMEPlb
# With project ID and API key (protected)
npm run setup -- --project-id tMbUCuQ4FeFJVViMEPlb --api-key YOUR_SECRETConfigure only one IDE
# Claude Code only
npm run setup -- https://your-website.com YOUR_SECRET --claude
# Cursor only
npm run setup -- https://your-website.com YOUR_SECRET --cursorExtract credentials without configuring
npm run setup -- https://your-website.com YOUR_SECRET --extractFull help
npm run setup -- --helpManual Configuration
If you prefer to configure manually:
Claude Code
Add to .mcp.json in your project root:
{
"mcpServers": {
"feedbucket": {
"command": "node",
"args": ["/path/to/feedbucket-mcp/dist/index.js"],
"env": {
"FEEDBUCKET_PROJECT_ID": "your-project-id",
"FEEDBUCKET_PRIVATE_KEY": "your-private-key",
"FEEDBUCKET_API_KEY": "your-api-key"
}
}
}
}Or use the CLI:
claude mcp add feedbucket \
-e FEEDBUCKET_PROJECT_ID="your-project-id" \
-e FEEDBUCKET_PRIVATE_KEY="your-private-key" \
-e FEEDBUCKET_API_KEY="your-api-key" \
-- node /path/to/feedbucket-mcp/dist/index.jsCursor
Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"feedbucket": {
"command": "node",
"args": ["/path/to/feedbucket-mcp/dist/index.js"],
"env": {
"FEEDBUCKET_PROJECT_ID": "your-project-id",
"FEEDBUCKET_PRIVATE_KEY": "your-private-key",
"FEEDBUCKET_API_KEY": "your-api-key"
}
}
}
}Environment Variables
Variable | Required | Description |
| Yes | Project ID from the |
| Yes | Private key for commenting/resolving (auto-fetched by setup) |
| No* | API key for protected projects ( |
*Required if your project uses query string protection.
Development
# Install dependencies
npm install
# Development mode (with hot reload)
npm run dev
# Type checking
npm run typecheck
# Linting
npm run lint
# Build for production
npm run buildArchitecture
This MCP server was reverse-engineered from the Feedbucket browser widget to provide:
Smart Summarization: Optimizes large datasets for AI consumption
Client-side Filtering: Reduces API calls by filtering locally
Full TypeScript: Strict mode with comprehensive types
Production Ready: Proper error handling and validation
API Endpoints Used
Method | Endpoint | Purpose |
GET |
| Fetch project with all feedback |
POST |
| Add comment to feedback |
PUT |
| Mark feedback as resolved |
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseAquality-maintenanceEnables interaction with Canny.io customer feedback platform through natural language. Supports board management, post creation/updating, search functionality, and comprehensive feedback management operations.Last updated63
- AlicenseBqualityDmaintenanceEnables interaction with Featurebase API to manage feature requests, feedback posts, comments, and upvotes. Supports creating, updating, and organizing customer feedback through natural language commands.Last updated124418MIT
- Alicense-qualityDmaintenanceEnables interaction with Fider customer feedback platforms, supporting post management, commenting, tagging, and status updates through natural language commands.Last updated1MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to access TestFlight beta tester feedback, including screenshots, crash logs, and text comments from App Store Connect. It works across any platform without requiring Xcode, using official API keys and optional browser automation for full text feedback.Last updated8
Related MCP Connectors
Give AI agents access to form submissions — read, search, update, and process file attachments.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Give AI coding agents access to your Vynix visual feedback, bug reports, and AI diagnosis.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/swiftcomza/feedbucket-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server