ui-ticket-mcp
Click UI problems in your browser; coding agents read the notes and fix the code
- 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-mcpAdd 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 reviewedRequiredREVIEW_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.


