Skip to content
MCP server

ui-ticket-mcp

Click UI problems in your browser; coding agents read the notes and fix the code

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
1.6.2
Listing updated
today

Similar MCP servers

About ui-ticket-mcp

ui-ticket-mcp is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

A reviewer opens their running app, presses Alt+A or the floating button, and clicks an element to attach a comment such as the spacing being wrong. The agent later reads that comment with context about exactly what was pointed at: element name, CSS selector, bounding box, nearby text, computed styles, full DOM path and accessibility attributes. Reviews can be tagged general, bug, suggestion or question, and replies are threaded.

One Python process serves MCP over stdio to the agent and a local REST API on port 3200 to the browser panel. Reviews live in a SQLite database at .reviews/reviews.db inside the project. The browser side is a ui-ticket-panel Web Component installed from npm or loaded from a CDN, and it works with Angular, React, Vue, Svelte or plain HTML. The README stresses that the API always runs on localhost and that the project website is only a landing page.

The README says ten tools are available, including get_review_summary, get_reviews, get_annotated_reviews, get_pending_work, add_review and resolve_review.

Install

Run in a terminal

claude mcp add ui-ticket-mcp --env PROJECT_ROOT='<PROJECT_ROOT>' -- uvx ui-ticket-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "ui-ticket-mcp": {
      "command": "uvx",
      "args": [
        "ui-ticket-mcp"
      ],
      "env": {
        "PROJECT_ROOT": "<PROJECT_ROOT>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "ui-ticket-mcp": {
      "command": "uvx",
      "args": [
        "ui-ticket-mcp"
      ],
      "env": {
        "PROJECT_ROOT": "<PROJECT_ROOT>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "ui-ticket-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ui-ticket-mcp"
      ],
      "env": {
        "PROJECT_ROOT": "<PROJECT_ROOT>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ui-ticket-mcp": {
      "command": "uvx",
      "args": [
        "ui-ticket-mcp"
      ],
      "env": {
        "PROJECT_ROOT": "<PROJECT_ROOT>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "ui-ticket-mcp": {
      "command": "uvx",
      "args": [
        "ui-ticket-mcp"
      ],
      "env": {
        "PROJECT_ROOT": "<PROJECT_ROOT>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PROJECT_ROOTRoot directory of the project being reviewedRequired
  • REVIEW_PORTHTTP port for REST API (default: 3200)

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

get_review_summary
Gives an overview of all pages with review counts.
get_reviews
Lists review comments, optionally for one page.
get_annotated_reviews
Returns reviews that carry element annotation metadata.
get_pending_work
Lists all open reviews grouped by page.
add_review
Creates a review with optional tag, metadata and parent.
resolve_review
Marks a review as resolved.

What it does

Click-to-annotate
Select an element or drag over a region to attach a review.
Rich element context
Captures selector, DOM path, styles, text and accessibility data.
Pending work list
Groups open reviews by page as a to-do list for the agent.
Threaded reviews
Supports replies, tags, search and filters by status.
Local SQLite storage
Keeps reviews in the project folder.
Framework independent
The review panel is a standard Web Component.

Good for

  • Point at a misaligned button and have an agent fix the CSS
  • Collect design feedback from teammates on a staging prototype
  • Give an agent a prioritized list of open UI issues
  • Track which pages still have unresolved review comments

Pricing

Open source

Free to run locally; packaged on PyPI

ui-ticket-mcp FAQ

How do I connect it?

Add a uvx ui-ticket-mcp entry to .mcp.json with PROJECT_ROOT set to your project.

Where are reviews stored?

In a SQLite database at .reviews/reviews.db inside your project.

Does the API run in the cloud?

No. It always runs on localhost, port 3200 by default.

Which frameworks work?

Any, since the panel is a Web Component; SSR frameworks need a dynamic client-side import.

Is ui-ticket-mcp free?

Yes. ui-ticket-mcp is open source, so you can use and self-host it for free.

How do I add ui-ticket-mcp to Claude Code?

Run this command in your terminal: claude mcp add ui-ticket-mcp --env PROJECT_ROOT='<PROJECT_ROOT>' -- uvx ui-ticket-mcp

What are the best alternatives to ui-ticket-mcp?

The closest alternatives to ui-ticket-mcp are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers