Skip to main content

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

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.5.0
File Size Uploaded Provenance Actions
ui_ticket_mcp-1.5.0.tar.gz 24.2 kB Without provenance Details for ui_ticket_mcp-1.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ui-ticket-mcp 1.5.0
File Interpreter ABI Platform Actions
ui_ticket_mcp-1.5.0-py3-none-any.whl Python 3 none any Details for ui_ticket_mcp-1.5.0-py3-none-any.whl

Total release size: 41.6 kB

Release files / ui_ticket_mcp-1.5.0.tar.gz

Download URL ui_ticket_mcp-1.5.0.tar.gz
Size 24.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d3057415c79ce12ed178711f385197ed7635a936031e962775b4d0d001c2eb71
BLAKE2b-256 checksum
How to use checksums
5656e2ef77de59fb8f0a13cc6c0da9ed59bd651498674fe8b2eb9edf9b958dd2
Upload date
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.5.0-py3-none-any.whl

Download URL ui_ticket_mcp-1.5.0-py3-none-any.whl
Size 17.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c2c81e7933ec84b2085b62a04800041718170c69f8ea07026275b3eedb0eae15
BLAKE2b-256 checksum
How to use checksums
3ba849a06a6eb445e176af73f8ab9ee0098e8c55d1c03ce4829294c743cf0674
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Security for ui-ticket-mcp 1.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page