# ui-ticket-mcp

> ui-ticket-mcp is an open-source MCP server for developer tools. Click UI problems in your browser; coding agents read the notes and fix the code. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Repository:** https://github.com/0ics-srls/ui-ticket-mcp_public
- **MCP Registry name:** io.github.0ics-srls/ui-ticket-mcp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/ui-ticket-mcp
