Faster Fixes
/fasterfixes
Turn messy client feedback into agent-ready bug reports.
About
During the review phase of a web project, clients send feedback through WhatsApp messages, scattered screenshots, and vague descriptions with no link to the page. Developers then spend time deciphering what was meant, finding the right page, and turning it into something actionable.
Faster Fixes replaces that workflow. Clients leave feedback directly on the website through a lightweight widget. The system captures the full context automatically — screenshot, page URL, DOM selector, browser metadata, and React component tree when available. Developers consume that feedback from a dashboard or directly from their AI coding agent via MCP.
The goal is a short path from client comment to resolved fix:
client feedback → structured context → AI agent fixes it
How It Works
1. Collect feedback with the widget
Install the React widget in your application. Clients click anywhere on the page to leave feedback. The widget captures the screenshot, element selector, component tree, and browser info automatically — no setup required from the client.
import { FeedbackProvider } from "@fasterfixes/react";
function App() {
return (
<FeedbackProvider apiKey="your-project-api-key">
<YourApp />
</FeedbackProvider>
);
}
2. Review feedback on the dashboard
Open the Faster Fixes dashboard to see all feedback items organized by project and page. Each item includes the client's comment alongside the captured context. Copy any item as a structured markdown report, ready to paste into your AI coding agent.
3. Or let your agent handle it via MCP
Connect the Faster Fixes MCP server to your editor. Your AI coding agent can fetch new feedback, read the full context, locate the relevant code, fix the issue, and mark it as resolved — without leaving the terminal.
claude mcp add faster-fixes -s project \
--env FASTER_FIXES_TOKEN=ff_agent_xxx \
--env FASTER_FIXES_PROJECT=proj_xxx \
-- npx -y @fasterfixes/mcp
The MCP server works with Claude Code, Cursor, VS Code, Windsurf, Codex, and Zed.
Features
- Visual feedback widget — clients click on elements to leave feedback, no training needed
- Automatic context capture — screenshot, page URL, DOM selector, component tree, browser info
- Developer dashboard — organized view of all feedback across projects
- Markdown export — copy any feedback item as a structured bug report for AI agents
- MCP server — AI coding agents fetch and resolve feedback programmatically
- Agent skill — install as a skill for autonomous feedback-to-fix workflows
- GitHub integration — automatically create issues from feedback items
- Team collaboration — organizations, projects, and role-based access
- Review links — share a link with clients so they can leave feedback without an account
Packages
This monorepo publishes three npm packages:
| Package | Description | Install |
|---|---|---|
@fasterfixes/react | React feedback widget | npm install @fasterfixes/react |
@fasterfixes/core | Framework-agnostic client library | npm install @fasterfixes/core |
@fasterfixes/mcp | MCP server for AI coding agents | npx -y @fasterfixes/mcp |
MCP Setup
The MCP server exposes two tools: list_feedbacks and update_feedback_status. It connects to the Faster Fixes API using an organization-scoped agent token.
Claude Code
Add to your .mcp.json:
{
"mcpServers": {
"faster-fixes": {
"command": "npx",
"args": ["-y", "@fasterfixes/mcp"],
"env": {
"FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
"FASTER_FIXES_PROJECT": "proj_your_project_id"
}
}
}
}
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"faster-fixes": {
"command": "npx",
"args": ["-y", "@fasterfixes/mcp"],
"env": {
"FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
"FASTER_FIXES_PROJECT": "proj_your_project_id"
}
}
}
}
VS Code (GitHub Copilot)
Add to .vscode/mcp.json:
{
"servers": {
"faster-fixes": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@fasterfixes/mcp"],
"env": {
"FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
"FASTER_FIXES_PROJECT": "proj_your_project_id"
}
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"faster-fixes": {
"command": "npx",
"args": ["-y", "@fasterfixes/mcp"],
"env": {
"FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
"FASTER_FIXES_PROJECT": "proj_your_project_id"
}
}
}
}
Codex
Add to .codex/config.toml:
[mcp_servers.faster-fixes]
command = "npx"
args = ["-y", "@fasterfixes/mcp"]
[mcp_servers.faster-fixes.env]
FASTER_FIXES_TOKEN = "ff_agent_your_token_here"
FASTER_FIXES_PROJECT = "proj_your_project_id"
Zed
Add to ~/.config/zed/settings.json:
{
"context_servers": {
"faster-fixes": {
"command": "npx",
"args": ["-y", "@fasterfixes/mcp"],
"env": {
"FASTER_FIXES_TOKEN": "ff_agent_your_token_here",
"FASTER_FIXES_PROJECT": "proj_your_project_id"
}
}
}
}
You can find your agent token and project ID in Organization Settings on the dashboard.
Built With
- Next.js — app framework
- React — UI library
- Prisma — database ORM
- tRPC — type-safe API layer
- Tailwind CSS — styling
- Better Auth — authentication
- Stripe — billing
- Inngest — background jobs
- Turborepo — monorepo tooling
License
This repository is licensed under the GNU AGPLv3 License.
The widget packages (@fasterfixes/core, @fasterfixes/react) and the MCP server (@fasterfixes/mcp) are licensed under MIT for unrestricted use in your applications.
Server Config
{
"mcpServers": {
"faster-fixes": {
"command": "npx",
"args": [
"-y",
"@fasterfixes/mcp"
],
"env": {
"FASTER_FIXES_TOKEN": "<YOUR_TOKEN>",
"FASTER_FIXES_PROJECT": "<YOUR_PROJECT_ID>"
}
}
}
}Recommend Servers
View All高德地图官方 MCP Server
A Serper MCP Server