# MarkLayer

MarkLayer brings webpage feedback into an agent workflow, where the agent can reply, update statuses, and suggest edits. Use it to review a page with other people.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 41
- Author: thevrus
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thevrus/MarkLayer/tree/HEAD/apps/mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/marklayer

## What it does

The server connects MarkLayer page annotations to an agent. It can mark a comment as in progress, reply, close or dismiss it. It can also inspect a page before anyone has commented, add its own feedback, and propose a precise text change for a person to review.

Tools cover rooms, annotations, replies, polls, and ordered next steps. The agent can wait for incoming notes and update their status for everyone in the room to see. The stdio setup runs through `npx`; provide a room at startup or connect to one later. A first-time `npx -y` download can outlast the MCP client's startup timeout, so the initial connection may fail.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MARKLAYER_ROOM`, `MARKLAYER_API_BASE`, `MARKLAYER_AGENT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MARKLAYER_ROOM=<MARKLAYER_ROOM> --env MARKLAYER_API_BASE=<MARKLAYER_API_BASE> --env MARKLAYER_AGENT=<MARKLAYER_AGENT> --transport stdio mcp -- npx -y marklayer-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env MARKLAYER_ROOM=<MARKLAYER_ROOM> --env MARKLAYER_API_BASE=<MARKLAYER_API_BASE> --env MARKLAYER_AGENT=<MARKLAYER_AGENT> -- npx -y marklayer-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "marklayer-mcp"
            ],
            "env": {
                "MARKLAYER_ROOM": "<MARKLAYER_ROOM>",
                "MARKLAYER_API_BASE": "<MARKLAYER_API_BASE>",
                "MARKLAYER_AGENT": "<MARKLAYER_AGENT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "marklayer-mcp"
            ],
            "env": {
                "MARKLAYER_ROOM": "<MARKLAYER_ROOM>",
                "MARKLAYER_API_BASE": "<MARKLAYER_API_BASE>",
                "MARKLAYER_AGENT": "<MARKLAYER_AGENT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MARKLAYER_ROOM=<MARKLAYER_ROOM> -e MARKLAYER_API_BASE=<MARKLAYER_API_BASE> -e MARKLAYER_AGENT=<MARKLAYER_AGENT> mcp npx -y marklayer-mcp
```
Replace <…> with your own values

## When to use it
- process new feedback on a webpage
- mark comments as in progress or resolved
- suggest a focused copy edit for page text
- publish a checklist tied to annotations
- collect reviewer votes in a room

## Example prompts
- Watch the MarkLayer room, fix each new comment, then close it with a short summary.
- Read the page in this room and leave feedback on its interface.
- Suggest a grammar correction for the page and ask the reviewers to choose an option.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md