Revdoku

Create one anonymous public website preview that expires in 24 hours. No Revdoku account, login, private bucket, forms, notifications, analytics, access gate, custom URL, or custom domain is created. The URL is randomized. Anonymous creates and updates share a limit of 60 publish operations per hour

Replace all files in an unclaimed anonymous website preview while keeping the same randomized URL and original 24-hour expiry. Requires the opaque update token returned by website_preview_create. Creating and updating previews share a limit of 60 publish operations per hour per source IP. Updating n

Check an anonymous preview's publish or claim status using the preview id and opaque update token. After claim, local agents exchange the returned one-time connection token themselves; hosted MCP clients call an authenticated Revdoku tool and use the sign-in UI (never sign up inside chat).

Check the authenticated Revdoku account and remote MCP capabilities, including onboarding state, features.github_sync eligibility, and publishing.free_plan_available. When onboarding.state is empty_account, offer onboarding.suggested_projects instead of only asking a broad question; create the selec

Return a stable Revdoku dashboard link for buckets, websites, or connector access. The link never signs a browser in; the user authenticates normally if needed.

List visible Revdoku buckets with website state, GitHub sync status/setup links, and archive/delete guidance. Use this before follow-up bucket actions. Pass query to filter by title.

Get one bucket, its files, website type/current revision, effective path permissions, website state, GitHub sync status/setup link, and archive/delete guidance. For Wbuilder buckets, read AGENTS.md and _config/wbuilder/contract.json before editing data/**; _config/** is readable but read-only. Pass

Create a private Revdoku bucket for agent-generated files, reports, or websites. Built-in forms can be configured through metadata.publication_forms, including the resource form and a system or website-file success response; writing files still creates only a private draft.

List trusted Revdoku bucket templates that can be imported into a new private bucket.

Create a private Revdoku bucket by importing files from a trusted Revdoku template manifest. The bucket is not published.

Update bucket title, description, or metadata. Configure built-in forms through metadata.publication_forms. For a resource landing page, configure resource with success_response mode=file and a website-relative path, and use {{REVDOKU_FORM:resource}} when it should appear inline. For an inline signu

Archive one bucket. Active websites must be unpublished first.

Restore one archived bucket back to the active bucket list.

Permanently delete an unpublished normal bucket after confirmation. Get bucket_id and delete.confirmation from bucket_list or bucket_get.

List files in a Revdoku bucket. Pass limit and offset for paginated results; omit them to return all files for compatibility. Pass query to search by name/path, or folder to list one folder's files.

Read one text bucket file (HTML/CSS/JS/JSON/Markdown/etc.) already stored in Revdoku. Not for binary files (images, fonts, PDFs).

Get full metadata for one bucket file by file_id (preferred) or path, without downloading its content. Use this to expand the lean file_id/version_id returned by bucket_file_write and bucket_file_write_many into complete file details when needed.

Write or replace one TEXT file in a bucket (HTML/CSS/JS/JSON/SVG/Markdown/etc.). For a Wbuilder bucket, first read AGENTS.md and its contract, edit data/**, leave _config/** read-only, and pass expected_bucket_revision_id from bucket_get when practical. JavaScript is supported and published as-is. B

Append UTF-8 text to an existing text file in a bucket, such as txt, md, csv, jsonl, js/code files, and similar text formats. This is not a binary-file API and it does not parse CSV or JSON; for ordinary .json, raw append can make invalid JSON. If the file or bucket is locked, retry briefly; if it r

Write multiple TEXT website files (HTML/CSS/JS/JSON/SVG/Markdown/etc.) in one bucket edit. For Wbuilder, read AGENTS.md first, edit data/**, leave _config/** read-only, and pass expected_bucket_revision_id from bucket_get. Save-time checks validate recognized Wbuilder files before any entry is writt

Rename or move one same-bucket file path by blob reference, creating a rename revision without reuploading bytes.

Copy one existing file to another path or bucket by storage reference, including archived sources. The target bucket must be writable; bytes are never downloaded or reuploaded.

Move one file by storage reference. Same-bucket moves create a rename revision; cross-bucket moves copy then soft-delete the source without reuploading bytes.

Batch rename, move, or copy files using server-side path/blob references. Use for folder cleanup or reorganization without reading or reuploading bytes.

Lock a whole bucket before broad edits or uploads so other agents can see this connector is working.

Unlock a bucket locked by this MCP connector.

Lock a bucket's visibility so it cannot be published, unpublished, switched between public/password access, or have its public URL changed by API or agents — use this to protect a bucket holding private data from accidental publishing. Locking is idempotent. There is deliberately no unlock tool: unl

Lock one or more bucket files before editing so other agents can see this connector is working.

Unlock a bucket file locked by this MCP connector.

Queue an async publish or republish of the bucket's saved draft as a live public website. The Free plan supports up to 100 public websites. Unless the user has already reviewed the site or explicitly asks to publish immediately, use bucket_publish_preview first and share that temporary URL for revie

Queue an async publish or republish of the bucket's saved draft with Password or Require Email access. New accounts start on Free without a trial. These access modes require payment for a permanent main site but can be evaluated with bucket_publish_preview on Free. Preview with the requested protect

Queue an async PREVIEW publish of the current saved draft to a temporary 'preview-<slug>' URL. Every preview expires after 15 minutes. Previews may use paid settings (including Password or Require Email) on Free so the user can evaluate them before upgrading; they stay noindex, do not affect the mai

Paid plans only: rename an existing website publication's <slug>.revdoku.site URL. If the site is live, files are republished under the new prefix; if it is unpublished, only the saved URL is changed for the next publish. Free websites retain their randomized URL. Fails with BUCKET_VISIBILITY_CHANGE

Change an already-published website's access settings WITHOUT republishing its files or URL. Use this to switch a live site between public, password, and Require Email, or rotate the password. Same-storage-class changes (e.g. password <-> Require Email, rotate password) are instant settings updates;

Queue an async unpublish of a bucket website while keeping the reserved URL. Use before archive/delete when bucket_list says required_action is unpublish_first, then check bucket_publication_get separately until status is unpublished before archiving or deleting. Fails with BUCKET_VISIBILITY_CHANGE_

List active and historical bucket website publications visible to this MCP connector.

Get one bucket website publication.

Get a bucket website's activity and analytics directly with bucket_id, or pass a publication_id from bucket_get's website.id, bucket_publish, or bucket_publication_list. Event instants are recorded in UTC; calendar boundaries and labels use the account time_zone returned in the response. activity is

List visitor leads for one publication: verified Require Email visitors and unverified emails collected by a Password Gate, including first/last visit, visit count, and per-path activity, plus recent access sessions. Use this to follow up without opening the Revdoku dashboard. Emails are sensitive,

Create personal links for a Require Email website: each tracked URL admits one recipient without the emailed OTP step and appears in Tracking Links with its engagement analytics. Recreating a recipient's link replaces its expiry and invalidates the previous URL. Defaults to allowlisted addresses; ba

Read a bucket's integration variables and secrets. `variables` are PUBLIC config embedded into the published website and are returned in full. `secrets` are SERVER-only (for example RESEND_API_KEY) — encrypted and never returned; only each secret's name and last 4 characters are shown. Names are ENV

Set a bucket's integration variables and/or secrets (requires write access to the bucket). `variables` (PUBLIC — embedded into the published site and visible to every visitor) REPLACES the entire public set, so call bucket_env_get first and include the entries you want to keep. `secrets` (SERVER-onl