Skip to content
MCP server

Onlay

Publish HTML or Markdown to a stable link and pull readers' edits back to your agent

Install
Pricing
Freemium
Platforms
Web, CLI, API
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About Onlay

Onlay is a freemium MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.onlay.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "onlay": {
      "url": "https://api.onlay.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $10 a month

Free for five active documents; Pro $10/month billed yearly or $12 monthly

Prices change. Check onlay.io before you buy.

Onlay 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 to Onlay

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents