Your comments.
Your agent’s next task.
Turn a comment on your site into a clear task, with the page, element, and conversation attached. For the whole loop from comment to fix, read the agent workflow guide. For tokens, scopes, and tools, read the MCP server reference.
01 · Create an agent token
Open your project in the dashboard and choose Agent access. Create a token and pick its scope:
- Read: list and read threads and new activity.
- Write: also reply, start, resolve, and reopen threads.
Tokens start with ptk_ and are shown once. They expire after 90 days by default, or up to 365 days. Revoke a token in the same tab at any time. Store it as PINTHREAD_TOKEN, never in your repository.
02 · Connect over MCP
pinthread is a remote MCP server at https://pinthread.dev/mcp. The token decides which project the agent sees.
claude mcp add --transport http pinthread https://pinthread.dev/mcp \
--header "Authorization: Bearer $PINTHREAD_TOKEN"Run it in your project with PINTHREAD_TOKEN set to your agent token.
[mcp_servers.pinthread]
url = "https://pinthread.dev/mcp"
bearer_token_env_var = "PINTHREAD_TOKEN"Add it to ~/.codex/config.toml. Codex reads the token from PINTHREAD_TOKEN.
{
"mcpServers": {
"pinthread": {
"url": "https://pinthread.dev/mcp",
"headers": { "Authorization": "Bearer ${env:PINTHREAD_TOKEN}" }
}
}
}Save it as .cursor/mcp.json in your project.
Any MCP client that supports streamable HTTP works. Send JSON-RPC with POST to https://pinthread.dev/mcp and the header Authorization: Bearer YOUR_AGENT_TOKEN.
03 · Tell your agent how to work
Add this to your AGENTS.md or CLAUDE.md:
When I mention pinthread comments, use the pinthread MCP tools. List the open threads, read each one with get_thread, then make the change and check it. Reply with what you changed. Resolve a thread only when you are confident the fix is complete. If a comment is a question or needs a decision, reply and leave it open.Tools
| Tool | Scope | What it does |
|---|---|---|
whoami | Read | Shows the project, token name, and scope of this connection. |
list_threads | Read | Lists threads. Filter by status (unresolved, open, in_progress, needs_review, resolved, dismissed, awaiting_reviewer, all), assignee, priority, label, page, or update time. |
get_thread | Read | Reads one thread with every comment, author, and reaction, plus its attachments and any suggested text edit. Set level to compact, standard, or detailed (key attributes, component, file:line, vscode:// and cursor:// links). |
get_page_context | Read | Returns the open threads on one page with their anchors, attachments, and suggested edits. |
get_attachment | Read | Reads one image or screenshot attachment by id, as an image. |
list_events | Read | Reads new threads and replies after a cursor, oldest first. |
list_assignees | Read | Lists the people and agents a thread can be assigned to. |
reply_thread | Write | Adds a reply as the agent. |
ask_thread | Write | Asks a focused question on a thread and marks it as awaiting a reviewer. A reviewer reply clears the marker. |
create_thread | Write | Starts a thread on a page at a given anchor. |
resolve_thread | Write | Marks a thread resolved. |
reopen_thread | Write | Reopens a resolved thread. |
dismiss_thread | Write | Dismisses feedback that needs no code change. A reason is required. |
mark_suggestion_applied | Write | Marks a suggested text edit as applied, adds a note, and resolves the thread. |
update_thread | Write | Sets a thread's status, assignee, priority, labels or due date. |
React to new feedback
Call list_events with since: "latest" to start from now, then pass back the cursor it returns. Each call returns only new threads and replies. Scripts can read the same feed over HTTP:
curl -H "Authorization: Bearer $PINTHREAD_TOKEN" \
"https://pinthread.dev/events?project=YOUR_PROJECT_KEY&branch=shared&since=latest"The response holds events, cursor, and more. Pass cursor as since on the next call.
Share your comments
Open the expanded drawer and choose Copy all comments for agent for open feedback across the project. The sidebar’s copy button copies only the current page.
Paste it into Codex, Claude Code, Cursor, or another agent with access to your repository. Resolved threads stay out of the prompt.
The useful details
- Your feedback and the replies that clarify it
- The page URL
- The element’s selector and visible text
- The comment position or selected area
A comment becomes a task
Page: /pricing
Target: #annual-plan-button
Element text: Choose plan
Maya: Make it clear this is billed annually.
Alex: Keep the monthly equivalent visible too.pinthread gives your agent context; it does not run an agent, upload your repository, or change your code itself.