# Pinthread

> Pinthread is a freemium MCP server for developer tools. Let a coding agent read, reply to and resolve comments pinned on your live website. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API
- **Website:** https://pinthread.dev/mcp-server/
- **MCP Registry name:** io.github.Wladefant/pinthread
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-17

## About

Teammates leave comments directly on page elements, and each thread tells the agent where it lives: the page URL, the element's selector and visible text, the comment position or selected area, and every reply with its author. The agent can then make the change and answer in the thread. Threads may carry screenshots, logs, video or replay attachments, a suggested text edit with old and new values, and numbered steps to recreate an open menu or dialog.

Access is through a project-scoped bearer token starting with ptk_, created in the dashboard with either read or write scope. Tokens expire after 90 days by default and up to 365. There is no OAuth, and the remote endpoint needs no local install. Read tools list and fetch threads and new events after a cursor; write tools reply, ask a question, create, resolve, reopen, dismiss with a reason, apply suggestions and update status, assignee, priority or labels.

Localhost feedback lives on a separate branch that must be requested explicitly. The server is included on every plan, including the free one.

## Features

- **Element-anchored threads:** Each thread names the page, selector, visible text and position.
- **Read and write scopes:** Tokens are per project and either read-only or able to reply and resolve.
- **Rich attachments:** Screenshots, logs, video and replay with signed links valid for 15 minutes.
- **Suggested text edits:** Provides old and new text so an agent can apply and mark them done.
- **Event cursor:** list_events returns only new threads and replies after a cursor.
- **Localhost branch:** Feedback from local development is read with branch set to local.

## Good for

- Have Claude Code or Cursor work through design review comments
- Reply to reviewers from the agent after fixing an issue
- Poll for new feedback and react to it
- Apply suggested copy edits and resolve the threads

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http pinthread https://pinthread.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://pinthread.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pinthread": {
      "url": "https://pinthread.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pinthread": {
      "type": "http",
      "url": "https://pinthread.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pinthread": {
      "serverUrl": "https://pinthread.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pinthread": {
      "type": "http",
      "url": "https://pinthread.dev/mcp"
    }
  }
}
```

## Tools

- `whoami`: Show the project, token name and scope.
- `list_threads`: List threads with filters for status, assignee, priority, label, page or time.
- `get_thread`: Read one thread with comments, reactions, attachments and suggestions.
- `get_page_context`: Return open threads on one page with anchors.
- `get_attachment`: Read an image or screenshot attachment.
- `list_events`: Read new threads and replies after a cursor.
- `list_assignees`: List people and agents a thread can be assigned to.
- `reply_thread`: Add a reply as the agent.
- `ask_thread`: Ask a question and mark the thread as awaiting a reviewer.
- `create_thread`: Start a thread on a page at an anchor.
- `resolve_thread`: Mark a thread resolved.
- `reopen_thread`: Reopen a resolved thread.
- `dismiss_thread`: Dismiss feedback that needs no code change.
- `mark_suggestion_applied`: Mark a suggested text edit applied and resolve the thread.
- `update_thread`: Set status, assignee, priority, labels or due date.

## FAQ

### Does it need OAuth?

No, every request carries a static bearer token tied to one project.

### Is it free?

MCP access is on every plan including Free at $0 a month; paid plans start at 29 euros a month.

### How long do tokens last?

90 days by default, up to 365.

### How do I read localhost comments?

Call list_threads with branch set to local.

### Is Pinthread free?

Pinthread has a free plan, with paid plans for more usage or features.

### How do I add Pinthread to Claude Code?

Run this command in your terminal: claude mcp add --transport http pinthread https://pinthread.dev/mcp

### What are the best alternatives to Pinthread?

The closest alternatives to Pinthread are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/pinthread
