API reference
Unfurl exposes MCP tools on the remote server and a matching HTTP API. Your AI client calls the tools the same way it calls any other MCP tool.MCP endpoint:
https://mcp.unfurl.pub/mcp — add this URL as a custom connector, or run npx unfurl-install. On OAuth, sign in and click Allow. Dashboard API keys remain available for REST and for clients that send Authorization: Bearer oodoc_…. Setup: Connect MCP.MCP tools
publish_document
Create a document or fully replace HTML on an existing
document_id.edit_document
Apply search/replace edits to the current HTML without resending the whole file.
get_document
Fetch metadata and optional HTML.
update_document
Change title or description without publishing new HTML.
list_documents
List documents in the workspace.
find_document
Look up a document by title or slug.
get_workspace_info
Workspace, plan, entitlements, and document count.
list_feedback
Viewer annotations left on a shared page.
resolve_feedback
Mark a feedback item resolved after you fix it.
delete_document
Permanently delete a document and its share links.
REST API
The same operations are available over HTTP for scripts and custom integrations. See REST API (v1).Before you start
- Unfurl account — Sign in at unfurl.pub (Google or magic link), or try a homepage drop and claim the document later.
- Connect MCP — Run
npx unfurl-install, paste the MCP URL as a custom connector, or create an API key for REST. Details: Connect MCP. - Publish — Ask your assistant to publish HTML, or call
POST /api/v1/publish.