Ollav MCP server

export OLLAV_API_KEY=ol_test_...

/plugin marketplace add ollav-app/ollav
/plugin install ollav@ollav

claude mcp add --transport http ollav https://app.ollav.app/mcp --header "Authorization: Bearer $OLLAV_API_KEY"

Settings → Connectors → Add custom connector
Name: Ollav
URL:  https://app.ollav.app/mcp

{
  "mcpServers": {
    "ollav": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.ollav.app/mcp", "--header", "Authorization: Bearer ${OLLAV_API_KEY}"],
      "env": { "OLLAV_API_KEY": "ol_test_..." }
    }
  }
}

{
  "mcpServers": {
    "ollav": {
      "url": "https://app.ollav.app/mcp",
      "headers": { "Authorization": "Bearer ${env:OLLAV_API_KEY}" }
    }
  }
}

Settings → Apps & Connectors → Create (developer mode; menu names change over time)
Name:            Ollav
MCP server URL:  https://app.ollav.app/mcp
Authentication:  OAuth

{
  "mcpServers": {
    "ollav": {
      "type": "http",
      "url": "https://app.ollav.app/mcp",
      "headers": { "Authorization": "Bearer ol_test_..." }
    }
  }
}

curl -s https://app.ollav.app/mcp \
  -H "Authorization: Bearer $OLLAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s https://app.ollav.app/mcp \
  -H "Authorization: Bearer $OLLAV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_documents","arguments":{}}}'

{
  "name": "share_html",
  "arguments": {
    "html": "<!DOCTYPE html><html><head><title>Pricing page v2</title></head><body><h1>Pricing</h1></body></html>",
    "filename": "pricing.html",
    "idempotency_key": "5f0c3b1e-8a2d-4c6f-9e7a-0b1c2d3e4f50"
  }
}

{
  "url": "https://content.ollav.app/p/qkjgjQCQGz",
  "slug": "qkjgjQCQGz",
  "documentId": "9908f969-9774-4374-a5bf-d66abcfbe70b",
  "versionId": "b8cfa354-0c7c-4102-bf14-69b49de24ca3",
  "deduped": false,
  "versioned": false,
  "visibility": "workspace",
  "warnings": [],
  "livemode": false
}

Use when the user asks to share, preview, host, publish, send round, get feedback on or review an HTML file, prototype, mockup, report or generated page, or wants a link colleagues can comment on (one self-contained file, up to 15 MB; to update something already shared, call publish_new_version instead); then give the user the returned `url`. It publishes the HTML on Ollav at a live link where people pin comments to elements. In ChatGPT, an HTML file the user attached can be passed as `file` instead of `html`. Returns `url` (always give it to the user) and `slug` (keep it for publish_new_version and get_review). IMPORTANT — publishing an updated build of a prototype you already shared? Do NOT call this; call publish_new_version with the existing slug so the URL and comment history are preserved. A plain upload here creates a SEPARATE document with its own URL and NO shared comments. The document lands in the workspace this API key belongs to. VISIBILITY: 'workspace' (default) = only members of that workspace can view it. 'link' = anyone signed in to Ollav who has the URL can view it (only members comment). 'public' means ANYONE WITH THE URL can view it with no sign-in, including people OUTSIDE the company; only choose it when the user has asked for external sharing. Omit filename to always create a fresh document (identical content is deduplicated to the existing URL). Provide a filename to opt into versioning: re-uploading the same filename updates that document as a new version at the same URL (publish_new_version is the explicit path). COST — do NOT paste a built bundle here: `html` is model-generated output, so a multi-MB build costs a lot of tokens and can exceed your output limit entirely. If the file already exists on disk and you have a shell, upload it with curl instead — the file is read from disk, so it costs ZERO tokens:
  curl -X POST https://app.ollav.app/api/documents \
    -H "Authorization: Bearer $OLLAV_API_KEY" -H "X-Ollav-Client: agent" \
    -F "file=@dist/index.html"
Building a React/Vue app? Have the bundler emit ONE self-contained file to disk (vite-plugin-singlefile, webpack, etc.) and curl that — never regenerate a bundle as model output. Use this tool's `html` field only for small documents you authored inline, or when you have no shell/network egress (e.g. claude.ai or Cowork sandboxes), where MCP is the only channel.
Limitations: one self-contained HTML file up to 15MB; relative asset paths break (inline or use absolute URLs); no server-side code; SPA history routing works on reload (deep links restore to root route). The response may include advisory warnings[].

{
  "name": "publish_new_version",
  "arguments": {
    "slug": "qkjgjQCQGz",
    "html": "<!DOCTYPE html><html><body><h1>Pricing</h1><p>Annual plans now 20% off.</p></body></html>"
  }
}

{
  "url": "https://content.ollav.app/p/qkjgjQCQGz",
  "slug": "qkjgjQCQGz",
  "versionId": "0d6c1f4e-2b3a-4c5d-8e9f-a0b1c2d3e4f5",
  "deduped": false,
  "versioned": true,
  "warnings": [],
  "livemode": false
}

Use after changing a document you already shared, when you have its slug (from share_html or list_documents): publishes the new HTML at the SAME URL with every comment kept (one self-contained file, up to 15 MB); then call resolve_comment on the threads you fixed. Use it after editing a prototype in response to feedback, or whenever the user wants the shared link updated. Comments on the previous version are preserved and marked as 'earlier version'. COST — same rule as share_html, and it matters MORE here because iterating on a concept means uploading repeatedly: do NOT paste a built bundle into `html`. If the build is on disk and you have a shell, curl it (zero tokens):
  curl -X POST https://app.ollav.app/api/documents/{slug}/versions \
    -H "Authorization: Bearer $OLLAV_API_KEY" -H "X-Ollav-Client: agent" \
    -F "file=@dist/index.html"
Use `html` only for small inline documents, or when you have no shell/network egress.
Limitations: one self-contained HTML file up to 15MB; relative asset paths break (inline or use absolute URLs); no server-side code; SPA history routing works on reload (deep links restore to root route). The response may include advisory warnings[].

{
  "name": "list_documents",
  "arguments": {}
}

{
  "workspace": {
    "id": "w_8c1e",
    "name": "Acme"
  },
  "documents": [
    {
      "slug": "qkjgjQCQGz",
      "title": "Pricing page v2",
      "url": "https://content.ollav.app/p/qkjgjQCQGz",
      "visibility": "workspace",
      "versionCount": 2,
      "commentCount": 3,
      "unresolvedCount": 1
    }
  ],
  "sharedWithMe": []
}

Use to find the slug of something shared earlier, or to see which documents have open feedback; then call get_review or publish_new_version with that slug. Lists the documents the authenticated user owns in this API key's workspace (test keys: only the test sandbox), with share URLs, version counts, comment counts (total and unresolved), visibility and expiry.

{
  "name": "get_document",
  "arguments": {
    "slug": "qkjgjQCQGz"
  }
}

{
  "slug": "qkjgjQCQGz",
  "title": "Pricing page v2",
  "url": "https://content.ollav.app/p/qkjgjQCQGz",
  "visibility": "workspace",
  "currentVersionId": "0d6c1f4e-2b3a-4c5d-8e9f-a0b1c2d3e4f5",
  "versions": [
    {
      "id": "0d6c1f4e-2b3a-4c5d-8e9f-a0b1c2d3e4f5",
      "createdAt": 1793145600000
    },
    {
      "id": "b8cfa354-0c7c-4102-bf14-69b49de24ca3",
      "createdAt": 1793059200000
    }
  ]
}

Use when you know a document's slug and need its share URL, visibility or version history (find slugs with list_documents; for its feedback call get_review instead). Returns metadata, the share URL and every version.

{
  "name": "get_comments",
  "arguments": {
    "slug": "qkjgjQCQGz"
  }
}

{
  "slug": "qkjgjQCQGz",
  "currentVersionId": "0d6c1f4e-2b3a-4c5d-8e9f-a0b1c2d3e4f5",
  "count": 1,
  "unresolvedCount": 1,
  "comments": [
    {
      "id": "3f2b8c1e-5d4a-4e7b-9c6d-1a2b3c4d5e6f",
      "parentId": null,
      "body": "Can the annual toggle default to on?",
      "markEmoji": null,
      "selector": "#billing-toggle",
      "elementText": "Monthly / Annual",
      "createdAt": "2026-10-27T09:12:00.000Z",
      "resolvedAt": null,
      "author": {
        "email": "maya@example.com",
        "name": "Maya"
      }
    }
  ]
}

Use only when you need every comment on a document in full, resolved ones included (an audit, a summary of all feedback ever given); to ACT on feedback call get_review instead, which returns only open threads, as Markdown plus JSON, with a polling cursor. Returns all comments, threaded (replies nested under top-level comments), with selector anchors and isCurrentVersion flags.

{
  "name": "get_review",
  "arguments": {
    "slug": "qkjgjQCQGz"
  }
}

{
  "slug": "qkjgjQCQGz",
  "title": "Pricing page v2",
  "url": "https://content.ollav.app/p/qkjgjQCQGz",
  "totalThreads": 1,
  "openThreads": 1,
  "returned": 1,
  "cursor": "2026-10-27T09:12:00.000Z",
  "markdown": "# Review: Pricing page v2\n\n1 open thread.\n\n## 1. \"Monthly / Annual\" (Maya)\n\nCan the annual toggle default to on?",
  "threads": [
    {
      "id": "3f2b8c1e-5d4a-4e7b-9c6d-1a2b3c4d5e6f",
      "status": "open",
      "onCurrentVersion": true,
      "comment": "Can the annual toggle default to on?",
      "markEmoji": null,
      "author": {
        "email": "maya@example.com",
        "name": "Maya"
      },
      "anchor": {
        "quote": "Monthly / Annual",
        "reproduceNote": null,
        "selector": "#billing-toggle"
      },
      "replies": []
    }
  ]
}

Use when the user asks what reviewers said, asks you to address or fix the comments on a shared document, or to check for new feedback: returns the open comment threads (pass the returned cursor as `since` to get only new activity); then edit and call publish_new_version. It reads collaborator feedback shaped for ITERATING on a document. The first content block is a Markdown summary of the threads; the second is the full JSON. Returns OPEN comment threads by default (status: 'open' | 'resolved' | 'all'). Each thread carries a source-findable anchor — anchor.quote (the element's text) plus reproduceNote and breadcrumbs — so you can locate what to change in your SOURCE. NOTE: anchor.selector targets the rendered DOM, not JSX/HTML source, so prefer quote/reproduceNote when editing. Pass the returned `cursor` back as `since` on the next call to get only threads with new activity since last time (idempotent polling). Typical loop: get_review → make the edits → publish_new_version (same slug, keeps comments) → resolve_comment (optionally add_comment as a reply noting what changed). Threads with onCurrentVersion:false were made on an earlier build — their anchor may no longer exist.

{
  "name": "add_comment",
  "arguments": {
    "slug": "qkjgjQCQGz",
    "parent_id": "3f2b8c1e-5d4a-4e7b-9c6d-1a2b3c4d5e6f",
    "body": "Fixed in v2: the toggle now defaults to Annual."
  }
}

{
  "id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d",
  "parentId": "3f2b8c1e-5d4a-4e7b-9c6d-1a2b3c4d5e6f",
  "body": "Fixed in v2: the toggle now defaults to Annual.",
  "markEmoji": null,
  "selector": null,
  "elementText": null,
  "createdAt": "2026-10-27T10:02:00.000Z",
  "resolvedAt": null,
  "author": {
    "email": "agent-owner@example.com",
    "name": "Ada"
  }
}

Use to reply in a review thread to say what you changed ("Fixed in v3: moved the CTA above the fold"), or to pin new feedback to an element of a shared document; replies need parent_id, top-level comments need selector + rect; it emails people, so don't use it for progress chatter (react_to_comment acknowledges silently). The comment is visible to the document's workspace members, and Ollav emails the document owner (and, for a reply, everyone in the thread) a notification naming this key as the agent. Top-level comments require selector + rect to anchor the pin to an element, and may set mark_emoji to show an emoji on the page instead of the numbered pin; with mark_emoji the body may be empty (a reaction pinned to the element). Replies require only parent_id and a body.

{
  "name": "resolve_comment",
  "arguments": {
    "comment_id": "3f2b8c1e-5d4a-4e7b-9c6d-1a2b3c4d5e6f"
  }
}

{
  "ok": true,
  "resolved": true
}

Use after you've fixed what a thread asked for, typically right after publish_new_version: marks the top-level comment resolved (or with unresolve: true reopens it); only the comment's author or the document owner can, and a reply via add_comment saying what changed is good practice. Resolve or unresolve a top-level comment by its id (from get_review or get_comments).

{
  "name": "react_to_comment",
  "arguments": {
    "comment_id": "3f2b8c1e-5d4a-4e7b-9c6d-1a2b3c4d5e6f",
    "reaction": "👀"
  }
}

{
  "ok": true,
  "commentId": "3f2b8c1e-5d4a-4e7b-9c6d-1a2b3c4d5e6f",
  "reactions": [
    {
      "reaction": "👀",
      "count": 1
    }
  ]
}

Use to acknowledge a comment without a reply or email, e.g. 👀 when you start on it and ✅ when it's done (one emoji; a comment holds at most 20 different reactions). Add (or with remove:true, take back) your reaction to a comment or reply: any single emoji; the default bar is 👍 (agree), ❤️, 🎉, 👀 (looking at it) and ✅ (done). The old names "+1", "eyes", "check" and "heart" still work. Anyone who can comment on the document can react.

{
  "name": "delete_comment",
  "arguments": {
    "comment_id": "7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d"
  }
}

{
  "deleted": true
}

Use only when the user asks to delete a comment: permanently deletes it and, for a top-level comment, all its replies (comment author or document owner only); to close a thread you fixed, call resolve_comment instead. Returns {deleted:true} on success.

{
  "name": "export_data",
  "arguments": {
    "scope": "account"
  }
}

{
  "scope": "account",
  "downloadUrl": "https://app.ollav.app/api/exports/download?token=...",
  "expiresAt": 1793146500000,
  "partial": false
}

Use only when the user asks for a copy or export of their data (GDPR access or portability): returns a signed link to a ZIP, valid 15 minutes, to give the user; exports are rate limited, so don't call it repeatedly. scope "account" (default): the key owner's profile, memberships, owned documents with every version, and their comments and reactions — limited to this API key's workspace. scope "workspace": everything in this key's workspace (workspace owner only). Returns {downloadUrl, expiresAt}: a signed link, valid 15 minutes, that streams the ZIP; manifest.json inside lists every item. Needs the read scope.

{
  "isError": true,
  "content": [
    { "type": "text", "text": "Ollav returned 404 NOT_FOUND: Document not found. What to do: Check the slug or id. ... Details: https://ollav.app/docs/errors#NOT_FOUND" },
    { "type": "text", "text": "{\"error\":{\"type\":\"not_found_error\",\"code\":\"NOT_FOUND\",\"message\":\"Document not found\",\"hint\":\"Check the slug or id. ...\",\"doc_url\":\"https://ollav.app/docs/errors#NOT_FOUND\",\"request_id\":\"req_6f1c2a9b0d4e8f7a1b2c3d4e\"}}" }
  ]
}

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32001,
    "message": "Invalid or missing Ollav API key: this key was not accepted. ...",
    "data": { "type": "authentication_error", "code": "AUTH_REQUIRED", "message": "This API key or OAuth token was not accepted.", "param": "Authorization", "hint": "The key is mistyped, revoked ...", "doc_url": "https://ollav.app/docs/errors#AUTH_REQUIRED" }
  }
}