All servers · Marketing & SEO · Cloud & networking · Code & repositories

Dotsy

ai.dotsy/mcp · v0.5.1

Measured by MCP Station

Description written by the publisher, not verified

Build and publish static sites on Dotsy with draft-first MCP tools, OAuth Connect, and API keys.

Connect

claude mcp add --transport http mcp https://mcp.dotsy.ai/mcp

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.dotsy.ai/mcp"
    }
  }
}

Tools as reported by the server

• create_site
  Create empty site; seeds brief. Globally taken slugs auto-suffix to `{slug}-{adjective}-{noun}` (default); pass onSlugTaken:"fail" to get a 409 instead of a renamed site.
• get_site
  Site detail, stats, publicUrl, brief head (default-on), and readiness flags. pages[] is a ~25-entry head by default (stats.pages has the true count) — pass pages: true for the full array (capped at 1000), or enumerate everything with list_content/get_site_manifest. Large sites (200+ pages): list_pag
• update_brief write/delete
  Update `_intent/site.md` (site brief) or a page brief when `page` is set. See field descriptions for rules, notes, and head enums.
• get_analytics
  Read-only traffic overview (default) or full breakdowns via include[]; optional bot id for crawler page drill-down.
• set_analytics_provider write/delete
  Connect a third-party analytics provider (GA4, Plausible, Fathom, Umami) or remove it (provider 'none'). Dotsy adds the provider's script to the <head> of every live page — live immediately, no publish needed. Replaces any earlier provider (one per site). Use this instead of pasting a GA4 gtag snipp
• update_site
  Update site settings: title, keyConvention, or editingMode ('live' = each editor save publishes immediately; 'staged' = saves stay drafts until publish_site). Slug is the hostname — change it with rename_site, not this tool. Set 'staged' before handing the editor to a person via start_edit_session's
• rename_site write/delete
  Rename the site slug (public hostname {slug}.dotsy.site). Owner-only. After success: use the returned slug in every later tool. Published site: the old slug redirects on the API (301 for reads, 308 for writes) while it stays reserved; the old host 301s and stays reserved until delete or rename-back.
• publish_site write/delete
  Publish draft to live. feedback and handoff required (use dummy feedback + one-line handoff if clean).
• get_draft_status
  Pending draft changes: content keys and routes with status. May include requiredDecision (publish_confirm) before publish_site.
• discard_drafts write/delete
  Discard unpublished drafts: all (omit key/keys/routes), one content key (key), or a selection (keys, routes). Destructive — check get_draft_status first.
• delete_site write/delete
  Permanently delete site; confirmSlug must equal slug.
• bulk_put_content write/delete
  Stage many content keys (pages, layouts, fragments). Content only — not routes or assets. Each body ≤60KB and the whole call ≤80KB; larger pages use stage_content_chunk, dotsy push, or PUT content-raw. May queue above the inline threshold.
• get_site_manifest
  Content keys + hashes only (optional routes=true) — static files live in list_assets, not manifest. Diff keys+hashes before apply_changeset; stage only changed bodies.
• find_replace write/delete
  Case-insensitive find→replace across pages in one staged commit. Batch all replacements into ONE call — never parallelize find_replace on the same key (concurrent edits surface as per-key conflict). find/replace ≤60KB.
• search_content
  Find pages containing a phrase (grep without reading bodies). Requires do-sqlite — graduate_site first if search_unavailable.
• graduate_site
  Enable site search & collections (kv → do-sqlite), one-way. Unlocks search_content, collection indexes, visitor /__paige/search, and moves any R2 form-submission ledger into SiteDb. 409 blocked covers three unrelated gates: an unsupported source backend (no override, ever); strictDrafts — default tr
• apply_changeset write/delete
  Stage writes[] + deletes[] in one call; attach routes via writes[].route. writes[].ifMatch (hash from get_site_manifest; "" = must not exist) guards each key (a delete takes { key, ifMatch } too); atomic:true makes one stale key write nothing (409 changeset_conflict). At most 10 writes; each body ≤6
• import_site_from_url
  Import URL to draft. On complete, response may include requiredDecision — preview then ask mirror vs editable before structure_*.
• get_structure_status
  Flat vs structured page counts; informs user — do not auto-run analyze/apply while requiredDecision pending.
• structure_site_analyze
  Propose shared layout + fragments; persist:false first. Wait for mirror-vs-editable answer if requiredDecision pending.
• decompose_analyze
  Deprecated — use structure_site_analyze.
• structure_site_apply write/delete
  Rewrite flat pages to layout + fragments (draft). Do not call while requiredDecision pending — user must pick editable first. It extracts header/footer only: afterwards share_section with no arguments lists the other repeated blocks (banner, CTA).
• get_structure_result
  Last structure apply job result (structuredKeys, conflicts, partial).
• adapt_site_analyze
  Propose nav wiring + blog collectionization for an imported mirror (draft, opt-in). Read-only; returns per-adapter reports + proposalEtag. Nav decline may include nextStep (e.g. mega-menu → edit fragments/header.html). Wait for mirror-vs-editable answer if requiredDecision pending.
• adapt_site_apply write/delete
  Apply the adapt proposal (draft): wire nav into the menu store and/or rewrite the blog index to a live <dotsy-collection>. One undo covers the whole apply; a second apply is refused until adapt_site_revert (or force). Queued applies are polled to completion.
• adapt_site_revert write/delete
  Atomically restore everything the last adapt_site_apply wrote (fragments, the menu doc when the op touched it, index, member configs, routes).
• get_adapt_status
  Read adapt state: proposal summary + proposalEtag (+ applied/consumed flag), undo-record presence, active or queued job progress. Use to resume in a fresh session.
• list_content
  List content keys (HTML/md); not assets — use list_assets. Defaults to 50 keys per page — raise limit (max 1000) or pass cursor (from nextCursor) to page through the rest. Per-row `size`/`missing` are measured automatically only on pages of ≤100 rows; past that they're ABSENT (not measured, never `n
• get_content
  Read one content key; optional selector (region) or published=true (live body). Bodies over 40KB without a selector return a truncated summary — use selector, batch_patch_content, or dotsy pull.
• put_content write/delete
  Stage one content key. Body ≤60KB. Larger pages: stage_content_chunk + apply_changeset bodyStaging, dotsy push, or PUT content-raw. Edits to an existing large page: batch_patch_content.
• stage_content_chunk
  Append one ≤60KB chunk of a large new page. Omit stagingId on seq 0; pass the returned stagingId on later seq. Set finalize:true on the last chunk, then apply_changeset with writes[].bodyStaging.
• patch_content write/delete
  Edit one content key via ops[] (selector ops or replace-string; wrap/unwrap/move restructure siblings). Stages draft; op shapes in schema.
• batch_patch_content write/delete
  patch_content on multiple keys; all-or-nothing validation. Preferred edit path for pages over 60KB. replace-string value/replace ≤60KB; whole call ≤80KB.
• delete_content write/delete
  Delete content key (tombstone if published). A fragments/* section that pages still place is refused with section_in_use (lists the pages) — detach it or remove it first.
• rename_content write/delete
  Re-key a page by slug (draft or published static). Server-side hash copy — no body round-trip. Default deletes static routes (obscure-URL); movePath:true repoints the route, rewrites menu refs and other redirects aimed at the old path, and — only for an already-PUBLISHED page — leaves a 301 there to
• put_post write/delete
  Stage a blog post via structured meta+body (?format=post). Key e.g. blog/my-post.html. Declared membership: meta.collections; schedule: meta.visibleAt; SEO title override: meta.seoTitle (card always shows meta.title); custom fields: meta.custom (typed per collection by get_collection_schema; the res
• inspect_collection
  Collection state — count, server.mode, sample entries, tag (membershipKind, match=) when discovered; plus name, noun, URL pattern, layout, where it's listed, and post fields used. Pass status/q/cursor/limit (any one, even empty) for a full items[] page instead: status draft = never published; a publ
• list_collections
  Collections on the site — name, noun, item count (or 'not published yet'), URL pattern, and whether any member is staged. Includes a collection only a draft page lists. Returns a bare array (not wrapped in an object) — pass each row's key verbatim to inspect_collection/update_collection.
• update_collection
  Rename a collection's display name and/or noun (e.g. the generic 'posts' key shown as 'Recipes' / 'recipe') — cosmetic only, stored separately from the tag that defines membership; doesn't need publish. Provide at least one of name/noun. null (or "") resets that field back to its derived default — d
• new_post_template
  Read-only scaffold for a new post — suggested key/path, membership meta, blank or duplicate body. Then put_post (+ optional put_route).
• get_collection_schema
  Read the site's collection field definitions (`_data/collections.json`, draft view): { schema: { v: 1, collections: { "<key>": { fields[], settings? } } }, hash }. hash is null when no schema exists yet — pass it as put_collection_schema ifMatch. 409 collection_schema_invalid { hash, issues } means
• put_collection_schema write/delete
  Replace the whole field schema (draft; publish makes it live). Read it with get_collection_schema first and send it back edited. Collection keys exactly as list_collections returns them ("blog/" or an id). Field: { key, type, label?, help?, required?, unique?, inCard?, default? } — type text (multil
• infer_collection_schema
  Suggest fields for one collection from a sample of its items' meta.custom values (published data, else drafts) — writes nothing. Returns { sampled, suggestions: [{ field: { key, type, options? }, count, samples, defined }], skipped }. Review, then add the ones you want via put_collection_schema.
• reindex_collection
  Build/finish collection indexes after publish returns collectionDataPending or collectionSqlPending.
• preview_page
  Verify-only composed HTML check; home preview may include requiredDecision — ask mirror vs editable before structure_*.
• verify_page
  Pre-publish lint (tags, assets, layout). Pair with preview_page — see get_skill('verify').
• preflight_site
  Plan check before publish or large build (counts, route soft limit, seo suggestions). When ok is false, blocking lists the failed suggestion codes. Read-only.
• start_edit_session
  Open a draft session. Returns preview/edit URLs for the person (see linkGuidance). draftEditorUrl only when the site gives AI agents Full access. path defaults to '/'.
• get_site_outline
  Site shape: every layout and shared section (`sections`: fragments/* by name, with page count, whether the file exists and staged-change flag), whether a layout is missing, redirects count, menus grouped by where they show, and collections with their page placements. Use for 'is my layout missing',
• share_section write/delete
  Make a block that repeats on several pages one shared section, or change where one shows. No arguments: lists blocks repeated on 3+ pages. sourceKey + selector (or selectors: a sibling run, one wrapper): a dry run finds every page with it; dryRun:false shares it. name + scope/hide/show: move an exis
• detach_section write/delete
  Give one page its own copy of a shared section; every other page keeps the shared one. A draft — publish_site to go live. A section the layout places is hidden on that page instead (share_section name + hide).
• get_route
  Get one route by path (home is '/').
• put_route write/delete
  Create/replace route; contentKey derived from path if omitted. On a field that accepts null (contentKey, redirectTo, redirectStatus, preserveQuery), sending null clears it back to its default.
• patch_route write/delete
  Partial route update (only sent fields change; an OMITTED field is left alone). On a field that accepts null (contentKey, redirectTo, redirectStatus, preserveQuery), sending null CLEARS it back to its default — different from omitting it. To set redirectTo/redirectStatus, include purpose: "redirect"
• rename_page write/delete
  Change a page's URL: moves its route from `from` to `to`. Menu links and other redirects that pointed at the old path retarget automatically; a 301 is left at the old path by default (leaveRedirect). Retry-safe (resend the same call after any error). Errors: 404 route_not_found (from isn't a route);
• delete_route write/delete
  Remove a route by path.
• list_goals
  List site conversion goals (pageview paths and form submits). Required before start_test.
• put_goals write/delete
  Create or replace all site conversion goals (≤50). Required before start_test when no goal exists.
• estimate_test
  Estimate days to reach promote readiness for a page (traffic baseline). Read-only.
• start_test
  Start a same-URL A/B test (draft or live source). Rules → get_skill('verify') § A/B.
• promote_experiment write/delete
  Promote a winning A/B variant to live — explicit user instruction only; see get_skill('verify') § A/B.
• delete_draft_test write/delete
  Remove a draft A/B test (releases variant bodies; does not publish).
• set_experiment_note
  Record what was learned from an ended A/B test (≤500 chars; null clears).
• get_menu
  Read a menu's draft items and etag; menu rules → get_skill('nav').
• put_menu_item write/delete
  Partial upsert one menu item: provided fields overwrite; omitted html/childTemplate/childShell/attrs/data are preserved. To remove those keys, use put_menu_doc. A brand-new id dedupes by (menu, ref) — reuses an existing item linking the same target instead of creating a duplicate. An id that already
• delete_menu_item write/delete
  Remove one item from a menu (page stays live).
• reorder_menu
  Set final menu order. Pass ifMatch from get_menu; stale → 409 with current items.
• get_menu_doc
  Read the whole menu doc (all menus + shell/template), etag for put_menu_doc, and issues (by item id) — page_not_routable, page_missing, page_dead_link, page_is_redirect — computed from the draft routes, so a link that won't show or leads nowhere shows up before publish.
• put_menu_doc write/delete
  Replace the whole menu doc (ifMatch from get_menu_doc required). Each item may omit menu — the enclosing menu key in doc is used.
• list_assets
  CMS uploads under assets/ only — not mirrored clone CDN (get_site mirroredAssets or import warmJob). Not content — use list_content. Uploaded files are live in the editor and draft preview at once; the published site picks them up at the next publish.
• get_asset
  Read one asset (metadata + base64 + stored sha256). sha256 is the stored blob; may differ from upload bodySha256 when IMAGES re-encodes rasters. Uploaded files are live in the editor and draft preview at once; the published site picks them up at the next publish.
• bulk_put_assets write/delete
  Upload 1–200 CMS assets; key = path after /assets/. Each item: exactly one of bodyBase64, bodyText (plain text for .css/.js/.mjs/.json/.svg/.txt/.xml only — not .html pages), or importFromUrl. Optional bodySha256 verifies submitted bytes before write; response sha256 is stored bytes (JS/CSS match; W
• delete_asset write/delete
  Delete a static asset by key. The editor and draft preview drop it at once; the published site drops it at the next publish.
• start_site
  Start one draft site with no Dotsy account. Returns slug + guestToken — pass guestToken on every later tool call until claim_site.
• claim_site
  Move the guest draft onto your signed-in Dotsy account. Requires OAuth Connect; pass the guestToken from start_site.
• list_skills
  Paige build skills (id + whenToUse). Pull get_skill on demand — do not duplicate in tool text.
• get_skill
  Skill body + optional questions[]. Accepts an id OR a synonym (e.g. 'list', 'menu') — resolves aliases and suggests near-misses. Start with intake when ambiguous.
• submit_feedback
  Optional mid-session feedback (required feedback rides with publish_site).
• get_activity
  List site activity or fetch one change diff (pass id). Filters: who, state, actor (me), since, limit≤20. Notes from context are visible to everyone on the site — no secrets.
• list_versions
  List the site's published versions, newest first (who, when, pages, live, restorable). Use before restore_version.
• restore_version
  Bring an earlier published version back as unpublished changes (page content only — routes, menus, images and settings stay). version: a number from list_versions, or "previous". dryRun: show what would change. Then review and publish_site, or discard_drafts to undo; publish:true makes it live at on
• undo_publish write/delete
  Take back the last publish at once: restores the version before it for the pages that publish changed and publishes them, and the undone changes stay as unpublished changes (`restaged`). On a live-mode site nothing is kept (its next save would publish it again): the answer has `redo.version` — resto
• revert_change
  Undo one activity event by staging the prior version as draft only — call publish_site to go live. Respects AI access.
• get_account_context
  Account, user, memberships[]. Pass workspace on writes when memberships.length > 1.
• add_custom_domain
  Connect apex and/or www on a paid plan; starts a DNS connect session.
• get_custom_domain_connect
  Current connect session and nextAction (browser URL or manual DNS guide).
• reapply_custom_domain_oauth
  Re-apply DNS with stored Cloudflare OAuth grant (no browser).
• refresh_custom_domain
  Poll one hostname until DNS/cert propagates.
• wait_for_custom_domain
  Poll one hostname until it is connected or the timeout is reached.
• set_primary_custom_domain
  Set the canonical host (301 target) when multiple hostnames are connected.
• list_custom_domains
  List all custom hostnames and connection status for the site.
• remove_custom_domain write/delete
  Remove one custom hostname from the site.
• list_form_submissions
  List form submissions (metadata + bounded field preview — not full PII). Works on kv and do-sqlite backends.
• get_form_submission
  Read one form submission with the full field payload (explicit PII access — use only when needed).
• list_my_sites
  List your Dotsy sites. Renders a site-picker for humans; agent reads structuredContent. Use to choose a site — not for editing content (use edit_page) or verify-only checks (use preview_page). Defaults to your active workspace; pass workspace (org id or slug from get_account_context memberships) to
• list_pages
  List pages on a site — route settings (path/title/navLabel/purpose) by default, one row per route. Renders a page-picker for humans (redirect and worker routes left out there — nothing to open in edit_page); agent reads structuredContent. Use after picking a site — not for editing (use edit_page) or
• edit_page
  Open the interactive page canvas to change content: the user clicks an element, then you call patch_content. Use when the intent is editing — not for verify-only checks (use preview_page).
• get_site_build_progress
  Read-only build progress for humans (build-theater view) during structure/adapt or after import. Agent reads structuredContent.forHumans — optional; do not call in a loop during import_site_from_url (that tool blocks until done). Prefer get_site for agent logic.

Tool changes

• 2026-10-23: create_site, get_site, update_brief, get_analytics, set_analytics_provider, update_site, rename_site, publish_site, get_draft_status, discard_drafts, delete_site, bulk_put_content
• 2026-10-22: create_site, get_site, update_brief, get_analytics, update_site, rename_site, publish_site, get_draft_status, discard_drafts, delete_site, bulk_put_content, get_site_manifest
• 2026-10-18: create_site, get_site, update_brief, get_analytics, update_site, rename_site, publish_site, get_draft_status, discard_drafts, delete_site, bulk_put_content, get_site_manifest
• 2026-10-18: create_site, get_site, update_brief, get_analytics, update_site, rename_site, publish_site, get_draft_status, discard_drafts, delete_site, bulk_put_content, get_site_manifest
• 2026-10-18: create_site, get_site, update_brief, get_analytics, update_site, rename_site, publish_site, get_draft_status, discard_drafts, delete_site, bulk_put_content, get_site_manifest
• 2026-10-17: create_site, get_site, update_brief, get_analytics, update_site, rename_site, publish_site, get_draft_status, discard_drafts, delete_site, bulk_put_content, get_site_manifest
• 2026-10-16: create_site, get_site, update_brief, get_analytics, update_site, rename_site, publish_site, get_draft_status, discard_drafts, delete_site, bulk_put_content, get_site_manifest

Website · JSON · Text for agents · Registry updated 2026-10-22