# Onlay

> Onlay is a freemium MCP server for productivity. Publish HTML or Markdown to a stable link and pull readers' edits back to your agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** Web, CLI, API, macOS, Linux, Windows
- **Website:** https://onlay.io/for-agents
- **MCP Registry name:** io.onlay/onlay
- **Categories:** productivity, files and documents
- **Listing updated:** 2026-11-15

## About

Onlay is built around a review loop for pages an agent produces. The agent pushes a file and gets a link that never changes; readers comment on blocks or, if allowed, edit wording in place; the agent pulls every edit and comment thread as structured data, revises the file, and publishes the next version to the same link while replying to each thread.

The site is explicit about where it does not fit: long co-written documents, design files, code review, plain hosting, or pages that must be indexed, since documents are unlisted and served with noindex. Each document is served from its own origin, and readers do not need an account to comment.

Agents with a shell are steered to the CLI, because MCP routes the document through the model's context on every call.

## Features

- **Stable share links:** Each push updates the same URL, with the last ten versions restorable on Free.
- **Structured feedback pull:** Edits and open comment threads come back with the quoted text and file lines.
- **Thread replies:** Resolve or reply to a thread on the same push that fixes it.
- **Anonymous commenting:** Readers comment by typing a name once, with no account.
- **CLI and MCP access:** Use the CLI from a shell or the remote MCP server from hosted agents.

## Good for

- Collect client feedback on an AI-generated report
- Share a prototype page and fold reviewers' wording fixes back in
- Run review rounds on a spec or plan written as Markdown
- Publish a built static site folder for feedback on Pro

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http onlay https://api.onlay.io/mcp
```

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

```sh
https://api.onlay.io/mcp
```

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

```json
{
  "mcpServers": {
    "onlay": {
      "url": "https://api.onlay.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "onlay": {
      "type": "http",
      "url": "https://api.onlay.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "onlay": {
      "serverUrl": "https://api.onlay.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "onlay": {
      "type": "http",
      "url": "https://api.onlay.io/mcp"
    }
  }
}
```

## Tools

- `publish_document`: Publishes an HTML or Markdown file to a stable link.
- `pull_feedback`: Pulls readers' edits and comment threads.
- `patch_document`: Applies a patch to a published document.

## FAQ

### What does it cost?

Free covers five active documents with unlimited readers; Pro is $10 a month billed yearly or $12 monthly.

### Which MCP tools exist?

publish_document, pull_feedback and patch_document.

### Are pages searchable by search engines?

No. Documents are unlisted and served with noindex.

### How large can files be?

Up to 4 MB on Free and 16 MB on Pro.

### Is Onlay free?

Onlay has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.

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

Run this command in your terminal: claude mcp add --transport http onlay https://api.onlay.io/mcp

### What are the best alternatives to Onlay?

The closest alternatives to Onlay 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/onlay
