# Comma

> Comma is a free MCP server for files and documents. Publish HTML reports from an agent, gather anchored comments, and revise at the same link. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://commareports.com/docs/mcp
- **Repository:** https://github.com/doramirdor/comma-plugin
- **MCP Registry name:** com.commareports/comma
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-15

## About

Reports published through this server live at a share link that stays the same across revisions. An agent creates the report, teammates leave comments anchored to parts of the rendered page, and the agent reads those threads, fixes the report and republishes to the same URL. It can then reply on a thread and resolve it.

The tool surface is wider than reports. Docs list tools for assets, reviewers and review requests, scheduled routines, skills, connectors, integrations, notifications and websites, each gated by the scopes on your API token. The hosted server uses Streamable HTTP with a comma_sk_ bearer token, the same token and limits as the REST API, and nothing runs locally.

Reports are viewable by anyone with the link, not indexed by search engines, unless the agent sets visibility to private. Commenters sign in for free. A Claude Code plugin from the doramirdor/comma-plugin repository adds slash commands such as /comma-publish and /comma-review on top of the MCP attachment.

## Features

- **Same-URL revisions:** update_report publishes a new revision at the existing share link.
- **Anchored comments:** Reviewers comment on specific parts of the rendered report, and agents read and resolve the threads.
- **Scoped API tokens:** Tool access follows the scopes on the comma_sk_ token, with 60 requests per minute each.
- **Routines and websites:** Tools cover scheduled routines and creating and deploying websites.
- **Claude Code plugin:** A plugin bundles the MCP attachment with commands to publish, search and review.

## Good for

- Publish an agent's analysis as a shareable HTML report
- Collect team feedback on a draft and have the agent apply it
- Search earlier reports from inside a coding session
- Schedule a recurring report run with a routine

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http comma https://commareports.com/api/mcp
```

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

```sh
https://commareports.com/api/mcp
```

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

```json
{
  "mcpServers": {
    "comma": {
      "url": "https://commareports.com/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "comma": {
      "type": "http",
      "url": "https://commareports.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "comma": {
      "serverUrl": "https://commareports.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "comma": {
      "type": "http",
      "url": "https://commareports.com/api/mcp"
    }
  }
}
```

## Tools

- `create_report`: Publishes an HTML report and returns its share link.
- `update_report`: Publishes a new revision of an existing report.
- `get_report`: Fetches a report.
- `search_reports`: Searches reports.
- `list_comments`: Lists comments on a report.
- `add_comment`: Adds a comment.
- `reply_to_comment`: Replies on a comment thread.
- `set_comment_status`: Changes a comment's status, for example to resolve it.
- `set_report_sharing`: Changes a report's sharing settings.
- `request_review`: Requests a review of a report.
- `create_routine`: Creates a scheduled routine.
- `deploy_website`: Deploys a website.

## FAQ

### Who can see a report my agent creates?

Anyone with the link can view it, and it is not indexed by search engines, unless the agent passes visibility private.

### How does authentication work?

A comma_sk_ API token goes in the Authorization header, the same token and checks as the REST API.

### What does it cost?

The pricing page says Comma is free with unlimited reports and commenters; Enterprise adds SSO, on-prem and custom domains at custom pricing.

### Is the plugin repository the source of the product?

No. It is an auto-published MIT mirror; the main Comma repository is private.

### Is Comma free?

Yes. Comma is free to use.

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

Run this command in your terminal: claude mcp add --transport http comma https://commareports.com/api/mcp

### What are the best alternatives to Comma?

The closest alternatives to Comma are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

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