ai.dotsy/mcp · v0.4.1 · cloud-and-infra
Dotsy is healthy: it completed an MCP handshake in 2429 ms and exposes 91 tools.
Build and publish static sites on Dotsy with draft-first MCP tools, OAuth Connect, and API keys.
Endpoint: https://mcp.dotsy.ai/mcp (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 91 |
| Latency | 2429 ms |
| Last checked (UTC) | 2026-10-14T09:00:06.219Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-14T09:00:06.219Z | Healthy | 2429 |
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 | 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. |
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 | 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 | 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 | 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 | Permanently delete site; confirmSlug must equal slug. |
bulk_put_content | 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 | 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 | Atomic writes[] + deletes[]; attach routes via writes[].route. At most 10 writes; each body ≤60KB and the call ≤80KB. Larger new pages: stage_content_chunk then writes[].bodyStaging, or dotsy push / PUT content-raw. |
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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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. |
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). |
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 | 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 | 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 | 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 | 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 | 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 | Remove a route by path. |
list_goals | List site conversion goals (pageview paths and form submits). Required before start_test. |
put_goals | 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 | Promote a winning A/B variant to live — explicit user instruction only; see get_skill('verify') § A/B. |
delete_draft_test | 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 | 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 | 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 | 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 | 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 | 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. |
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 | 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. |