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
Add the widget to any website: WordPress, Webflow, static HTML, or an app built with any framework. Paste one tag, replacing the Project ID with your own:
<script
src="https://cdn.jsdelivr.net/npm/@fasterfixes/widget@1/dist/widget.iife.js"
data-project-id="proj_your_project_id"
defer
></script>
In a React application, use the React embed instead. It mounts the same widget:
import { FeedbackProvider } from "@fasterfixes/react";
function App() {
return (
<FeedbackProvider projectId="proj_your_project_id">
<YourApp />
</FeedbackProvider>
);
}
In a Vue or Nuxt application, use the Vue embed:
import { createFasterFixes } from "@fasterfixes/vue";
createApp(App)
.use(createFasterFixes({ projectId: "proj_your_project_id" }))
.mount("#app");
In an Angular or Analog application, use the Angular embed:
import { provideFasterFixes } from "@fasterfixes/angular";
export const appConfig: ApplicationConfig = {
providers: [provideFasterFixes({ projectId: "proj_your_project_id" })],
};
In a Svelte or SvelteKit application, use the Svelte embed in the root component or layout:
<script lang="ts">
import { initFasterFixes } from "@fasterfixes/svelte";
initFasterFixes({ projectId: "proj_your_project_id" });
</script>
Clients click anywhere on the page to leave feedback. The widget captures the screenshot, element selector, browser info, and the React component tree on React sites automatically, with no setup required from the client. See the script embed, React, Vue, Angular and Svelte docs.
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 seven npm packages:
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.
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"
}
}
}
}
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"
}
}
}
}
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"
}
}
}
}
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"
}
}
}
}
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"
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
License
This repository is licensed under the GNU AGPLv3 License.
The widget packages (@fasterfixes/widget, @fasterfixes/react, @fasterfixes/vue, @fasterfixes/angular, @fasterfixes/svelte, @fasterfixes/core) and the MCP server (@fasterfixes/mcp) are licensed under MIT for unrestricted use in your applications.
