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": {
    "review-system": {
      "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_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

More

Full documentation: github.com/0ics-srls/ui-ticket-mcp

Metadata

Release files for ui-ticket-mcp 0.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 0.5.0
File Size Uploaded Provenance Actions
ui_ticket_mcp-0.5.0.tar.gz 12.4 kB Without provenance Details for ui_ticket_mcp-0.5.0.tar.gz

Built distribution (wheel)

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

Total release size: 21.6 kB

Release files / ui_ticket_mcp-0.5.0.tar.gz

Download URL ui_ticket_mcp-0.5.0.tar.gz
Size 12.4 kB
Tags Source
SHA-256 checksum
How to use checksums
187b20521221278108114567d171fe1ef72235493ec6cb79fe60def2e949964d
BLAKE2b-256 checksum
How to use checksums
c02297048182b7fa8ae42e2c25d9f03fc0319fad582ea39b10236009b4fd8e18
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.11

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

Download URL ui_ticket_mcp-0.5.0-py3-none-any.whl
Size 9.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
12655959e55a10cfff316a71115483fb470a8a9b0c87707f96762aafe3e27345
BLAKE2b-256 checksum
How to use checksums
3c65061dc9091b79e9d3b3b64c6121322f88edce8b8e8c5523daee8d3d03d28c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.10.11

Security for ui-ticket-mcp 0.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