@fasterfixes/mcp

Documentation · Website

MCP server for Faster Fixes — connect AI coding agents to your client feedback.

Clients leave feedback on your site via the widget. This MCP server lets your AI coding agent fetch that feedback and update its status, so you never leave your terminal.

Prerequisites

1. Agent token — Organization Settings > Agent Tokens > Create token
2. Project ID — Project Settings > the proj_... identifier

Installation

No global install needed. Run a single command to configure your editor.

Claude Code

claude mcp add faster-fixes -s project \
  --env FASTER_FIXES_TOKEN=ff_agent_xxx \
  --env FASTER_FIXES_PROJECT=proj_xxx \
  -- npx -y @fasterfixes/mcp

Or add to .mcp.json at your project root:

{
  "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 in your project (or ~/.cursor/mcp.json for global):

{
  "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 in your project:

{
  "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"
      }
    }
  }
}

Note: VS Code uses "servers" (not "mcpServers") and requires "type": "stdio".

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 in your project (or ~/.codex/config.toml for global):

[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"

Note: Codex uses TOML, not JSON.

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"
      }
    }
  }
}

Note: Zed uses "context_servers" as the key, and the config goes directly in your main settings file.

Agent Skill (optional)

For a one-command workflow, install the fix-feedback skill. It teaches your agent the full loop: fetch → fix → resolve.

npx skills add manucoffin/faster-fixes --skill fix-feedback

Then just say fix feedback and your agent handles the rest. Works with Claude Code, Cursor, Windsurf, and 40+ other agents via skills.sh.

Usage

After configuring, ask your agent:

• "Check for new feedback"
• "Get all open feedback and fix them"
• "Mark feedback abc123 as resolved"

Or set up a scheduled task to fetch and fix feedback automatically.

Tools

list_feedbacks

List feedback items for your project. Returns page URL, CSS selector, click coordinates, component tree, browser info, and screenshot.

| Parameter | Type | Required | Description | | ---------- | ------ | -------- | -------------------------------------------------- | | status | string | No | Filter: new, in_progress, resolved, closed | | page_url | string | No | Filter by the page where feedback was left | | format | string | No | markdown (default) or json |

update_feedback_status

Update the status of a feedback item.

| Parameter | Type | Required | Description | | ------------- | ------ | -------- | --------------------------------------------- | | feedback_id | string | Yes | The feedback ID | | status | string | Yes | new, in_progress, resolved, or closed |

create_feedbacks

Create one or many feedback items. Designed for migrating from BugHerd, Marker.io, Userback, Usersnap, and similar tools — feed the agent a CSV or JSON export and it will populate Faster Fixes. The batch is atomic, and integrations (e.g. GitHub issue creation) are intentionally skipped so an import does not fan out into hundreds of issues.

| Parameter | Type | Required | Description | | --------------- | ------ | -------- | ------------------------------------------------------------------------------------------ | | feedbacks | array | Yes | Up to 100 feedback items per call. See item shape below. | | reviewer_name | string | No | Name of the reviewer to attribute imports to. Reused if it exists. Defaults to "Imported feedback". | | source | string | No | Origin tool tag (e.g. bugherd, marker.io). Stamped into each item's metadata. |

Each feedback item:

| Field | Type | Required | Description | | ---------------- | ------ | -------- | -------------------------------------------------------------------- | | comment | string | Yes | Bug description / feedback text. | | pageUrl | string | Yes | Page URL where the feedback was originally left. | | status | string | No | new (default), in_progress, resolved, or closed. | | selector | string | No | CSS selector of the targeted element. | | clickX | number | No | Click X coordinate (px). | | clickY | number | No | Click Y coordinate (px). | | browserName | string | No | Browser name from the original report. | | browserVersion | string | No | Browser version. | | os | string | No | Operating system. | | viewportWidth | number | No | Viewport width (px). | | viewportHeight | number | No | Viewport height (px). | | createdAt | string | No | ISO 8601 timestamp. Preserves the original report date during migration. | | metadata | object | No | Arbitrary key/value pairs (e.g. { "originalId": "bh-12345" }). |

Environment variables

| Variable | Required | Description | | ---------------------- | -------- | ----------------------------------------------------- | | FASTER_FIXES_TOKEN | Yes | Agent token from Organization Settings | | FASTER_FIXES_PROJECT | Yes | Project ID (proj_...) from Project Settings | | FASTER_FIXES_URL | No | API base URL (defaults to https://www.faster-fixes.com) |

Security

• The agent token is scoped to your organization. Each capability (read, update status, create) is a separate permission you grant when creating the token — leave any unchecked to lock the agent out of that operation.
• No delete or admin operations are available.
• Tokens can be revoked instantly from the dashboard.
• All API calls are rate-limited, and bulk creates are capped at 100 items per call and stop at your plan's feedback limit.

License

MIT