# Simple Commenter

> Simple Commenter is an MCP server for productivity. Search, triage and export website and asset feedback from Simple Commenter in chat. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $34.99 a month
- **Platforms:** Web, API, CLI
- **Website:** https://www.simplecommenter.com/docs/integrations/ai-agent
- **Repository:** https://github.com/simple-commenter/mcp-server
- **MCP Registry name:** io.github.simple-commenter/mcp-server
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-15

## About

Simple Commenter is a tool where clients leave comments directly on a live website, PDF or image. Its MCP server lets an assistant work through that feedback: list and search comments, read a comment with its element path, screenshot, click position and replies, change status, priority and tags, and reply. get_comment can also return an AI-written developer brief with a title, summary and suggested fix.

Access is scoped. The hosted connection at simplecommenter.com/api/mcp uses browser OAuth with read, write and settings scopes and project-level grants, while the npm package runs locally over stdio with an integration token. Local tokens have account-wide read, write and settings access, so the docs recommend hosted authorization for read-only or selected-project access. Each hosted connection belongs to one company.

MCP is included on paid plans and during the 14-day trial, but not on the free plan after the trial. There is no separate MCP fee, and the hosted server allows 120 authenticated requests per minute per connection.

## Features

- **Search and filter feedback:** Find comments by text, dates, author, status, tags or source across authorised projects.
- **Rich comment detail:** Reads element XPath, screenshot, click position, replies and an AI developer brief.
- **Status and tag updates:** Move comments through workflow states and edit priority, tags and visibility.
- **CSV export:** Exports a filtered set of comments with attachment links and an expiring URL.
- **Feedback reports:** Returns counts and breakdowns plus a report artifact.
- **Scoped access:** Hosted OAuth with project grants, or a local token for coding tools.

## Good for

- Turn client feedback on a staging site into a fix list
- Mark comments done after a coding agent resolves them
- Export a project's feedback to CSV for a review meeting
- Report on open versus resolved feedback by tag
- Reply to a reviewer from your editor

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://www.simplecommenter.com/api/mcp
```

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

```sh
https://www.simplecommenter.com/api/mcp
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://www.simplecommenter.com/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://www.simplecommenter.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://www.simplecommenter.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://www.simplecommenter.com/api/mcp"
    }
  }
}
```

## Tools

- `get_connection_info`: Refresh account, plan, granted permissions and connection context.
- `list_projects`: List projects authorised for this connection.
- `get_project_context`: Read statuses, tags, workflow settings and project links.
- `list_comments`: List feedback in one project with filters and pagination.
- `get_comment`: Full comment detail including element XPath, screenshot, replies and developer brief.
- `update_comment_status`: Mark a comment in progress, done and so on.
- `update_comment`: Set status, priority, tags, visibility or archive state.
- `reply_to_comment`: Reply with text and authorised upload references.
- `create_comment`: File new feedback on a page.
- `search_comments`: Search across authorised projects by text, dates, author, status, tags or source.
- `export_comments`: Download a filtered CSV with attachment links.
- `feedback_report`: Get feedback counts and breakdowns plus a report artifact.
- `get_billing_link`: List plans and prices and return a Stripe checkout or billing link.

## FAQ

### Is MCP available on the free plan?

No. It is included on paid plans and during the 14-day trial, but not on the free plan after the trial.

### How do I connect ChatGPT or Claude?

Use the hosted server URL https://www.simplecommenter.com/api/mcp with browser OAuth sign-in.

### What are the rate limits?

The hosted server allows 120 authenticated requests per minute per connection, and the local server 120 per minute per token.

### How do I set up the local server?

Run npx @simple-commenter/mcp-server init, which signs you in with an emailed code and writes a .mcp.json.

### Is Simple Commenter free?

Simple Commenter is a paid product with a free trial. Paid plans start at $34.99 a month.

### How do I add Simple Commenter to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://www.simplecommenter.com/api/mcp

### What are the best alternatives to Simple Commenter?

The closest alternatives to Simple Commenter 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/simple-commenter
