ui-ticket-mcp

Review system for UI prototypes. Humans write comments in the browser, AI agents resolve them via MCP. One process serves both MCP (stdio) and REST API (HTTP).

Setup

Add to your .mcp.json:

{
  "mcpServers": {
    "ui-ticket-mcp": {
      "command": "uvx",
      "args": ["ui-ticket-mcp"],
      "env": {
        "PROJECT_ROOT": "/path/to/your/project"
      }
    }
  }
}

uvx downloads and runs the package automatically. MCP connects via stdio, REST API starts in background on http://localhost:3200. Reviews are stored in {PROJECT_ROOT}/.reviews/reviews.db (auto-created, committable to git).

Port configurable via REVIEW_PORT env var.

Fallback if you don't have uv: pip install ui-ticket-mcp, then use "command": "ui-ticket-mcp" instead of uvx.

MCP Tools

Tool	Description
`get_review_summary()`	Summary of pages with open/resolved counts
`get_reviews(page_id?)`	List comments, optionally filtered by page
`add_review(page_id, author, text)`	Add a new comment
`resolve_review(review_id, resolved_by?)`	Mark as resolved
`reopen_review(review_id)`	Reopen a resolved review
`batch_resolve(page_id, resolved_by?)`	Resolve all open on a page
`get_pending_work()`	Open reviews grouped by page (todo list)
`find_source_file_tool(page_id)`	Find source files matching a page_id
`get_annotated_reviews(page_id?)`	Reviews with element annotation metadata
`get_setup_guide()`	Full setup guide for the review system

REST API (starts automatically)

Method	Endpoint	Description
GET	`/api/reviews/summary`	Per-page summary
GET	`/api/reviews`	All reviews
GET	`/api/reviews/{page_id}`	Reviews for a page
POST	`/api/reviews/{page_id}`	Add review
PATCH	`/api/review/{id}`	Update status/text
DELETE	`/api/review/{id}`	Delete review
GET	`/api/version`	Server version

Metadata

Release files for ui-ticket-mcp 1.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ui-ticket-mcp 1.6.1
File	Size	Uploaded
ui_ticket_mcp-1.6.1.tar.gz	25.3 kB	Sep 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for ui-ticket-mcp 1.6.1
File	Interpreter	ABI	Platform	Reset
ui_ticket_mcp-1.6.1-py3-none-any.whl 17.4 kB Sep 28, 2026	Python 3	none	any	Details

Total release size: 42.8 kB

Release files / ui_ticket_mcp-1.6.1.tar.gz

Download URL	ui_ticket_mcp-1.6.1.tar.gz
Size	25.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`5b99935a24f96b697bbd2bc00b9da7996842cabf47296775954974278d61b008`
BLAKE2b-256 checksum How to use checksums	`fa2de00b9c52c4502d59a3e820a8cd43fe51cecda6519068104f43a9cfcc1838`
Upload date	Sep 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.12`

Release files / ui_ticket_mcp-1.6.1-py3-none-any.whl

Download URL	ui_ticket_mcp-1.6.1-py3-none-any.whl
Size	17.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3a71422b715dd8964745e80bbdeaed53cfa222fefbd42a0e2b48b7a82ce28fc2`
BLAKE2b-256 checksum How to use checksums	`6054df64c3785e9c31d0d401d26706f37048938cb8c18280593817e0a186f177`
Upload date	Sep 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.12`