# Punch List by SMB Team

> Website feedback for SMB Team's clients. Open a review link, click anything on your new website, and leave a note. No account, nothing to install.

Punch List (https://feedback.smbteam.com) is the feedback tool SMB Team (https://smbteam.com), a web agency, uses while it builds websites for its clients. SMB Team sends a client a review link; the client's new website opens in the browser with a comment layer on top. Clicking anything pins a note to that spot, and every note lands on the team's punch list with a status the client can watch: open, in progress, resolved.

Clients never sign in and never install anything, on a computer or a phone. SMB Team staff sign in with an emailed link to create review links and manage them from a dashboard.

Punch List is built on MarkLayer (https://github.com/thevrus/MarkLayer), open source under the Apache-2.0 licence. SMB Team is not affiliated with the MarkLayer project.

## For clients

- Open the link SMB Team sent you. Your website loads with the review tools on top.
- Click the spot you want to talk about and type your note. Drawings, highlights and screenshots are there too.
- Watch each note move from open to in progress to resolved, and reply on any note to keep the conversation in one place.
- Help: https://feedback.smbteam.com/help

## Features

- Comments pinned to the element they were left on, with threaded replies, five statuses (open, in_progress, resolved, approved, dismissed) and four priorities (low, medium, high, urgent)
- Each comment records the browser, operating system and viewport width it was written on
- Suggested edits: select text on the page and write the exact replacement, shown as a diff
- Drawing tools: pen, highlight, arrow, line, rectangle, circle, text label, area capture
- Desktop, tablet and mobile preview widths; comments stay attached to the right element as the layout reflows
- PDFs and images can be reviewed the same way as a page
- Live cursors, plus voice and video between the people on a link
- Multi-page projects: one link can hold up to 50 pages
- Export every comment as Markdown, or the annotated page as a PNG

## For AI coding agents (MCP)

Every share link is a remote MCP server (Streamable HTTP) at the link plus /mcp. Nothing to install, no key: the link is the credential.

    claude mcp add --transport http marklayer https://feedback.smbteam.com/s/{id}/mcp

Add ?agent=<name> so reviewers see which agent picked up their comment. A password-protected link takes `Authorization: Bearer <password>`.

The agent works the comments as a queue: marklayer_list_annotations to backfill, marklayer_watch_annotations to wait for new ones, marklayer_acknowledge before starting, marklayer_resolve with a one-line summary when done, marklayer_dismiss with a reason when it cannot act, marklayer_reply to ask a question. marklayer_read_page, marklayer_create_annotation and marklayer_suggest_edit let it review a page itself. approved is the one status an agent never sets: it is the person who asked for the change confirming the fix.

Full setup per client (Claude Code, Claude, Codex, Cursor, VS Code): https://feedback.smbteam.com/mcp.md

## Share API

A share link can be created with one HTTP POST. The id you choose is the access token, so use an unguessable one (nanoid, uuid).

    POST https://feedback.smbteam.com/api/{id}
    Content-Type: application/json
    { "ops": [], "url": "https://example.com/page", "width": 1440 }

The link is then https://feedback.smbteam.com/s/{id}. OpenAPI spec: https://feedback.smbteam.com/api/openapi.json

## Retention

A review link is deleted 90 days after it was last opened, and any view or comment resets that clock. Links a team member has saved to their dashboard are kept until they delete them.

## Links

- Website: https://feedback.smbteam.com
- Help for reviewers: https://feedback.smbteam.com/help
- MCP setup for coding agents: https://feedback.smbteam.com/mcp
- Privacy Policy: https://feedback.smbteam.com/privacy
- Current version: 0.10.0
- SMB Team: https://smbteam.com
- Built on MarkLayer (Apache-2.0): https://github.com/thevrus/MarkLayer

## Contact

Email: support@smbteam.com

## Optional

- [Full details](/llms-full.txt)