Build and publish static sites on dotsy with draft-first MCP tools, OAuth Connect, and API keys.
Connect Remote server
claude mcp add --transport http mcp https://mcp.dotsy.ai/mcp
{
"mcpServers": {
"mcp": {
"url": "https://mcp.dotsy.ai/mcp"
}
}
}
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.dotsy.ai/mcp"
}
}
}
Settings > Connectors > Add custom connector
URL: https://mcp.dotsy.ai/mcp
Tools 80 found in our last check
create_siteCreate 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_siteSite 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 list_content/get_site_manifest. Large sites (200+ pages): list_pages is…
update_briefUpdate `_intent/site.md` (site brief) or a page brief when `page` is set. See field descriptions for rules, notes, and head enums.
get_planRead-only workspace plan and pooled usage; pass slug for this site's add-ons. Call before a large build.
get_analyticsRead-only traffic overview (default) or full breakdowns via include[]; optional bot id for crawler page drill-down.
set_analytics_providerConnect 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 pas…
get_custom_codeRead the site-wide custom code: `draft` (what the next publish puts live) and `published` (what visitors get now) for both boxes — head (before </head>) and body (before </body>) — plus `pending`, `runOn` and `maxChars`.
set_custom_codeSet site-wide custom code: `head` goes before </head> and `body` before </body> on every page, on every layout. It is saved as a draft and goes live with the next publish_site (on a live-mode site the dashboard publishes only the code). It never runs in the editor. Up to 20,000…
set_site_iconSet the favicon from a square image asset. Draft until publish.
update_siteUpdate 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…
rename_siteRename the site slug (hostname {slug}.dotsy.site). Owner-only; use the returned slug afterwards. Published site: the old slug redirects on the API (301 reads, 308 writes) and the old host 301s, both reserved until delete or rename-back. Never published: the old slug 404s and its…
publish_sitePublish draft to live. handoff required; feedback optional. Warnings (form_unwired, store, SEO) are advisory: tell the user. Site-check errors return a publish_issues decision. A request to publish is not agreement to publish those errors: use its publishWithIssues code only aft…
get_site_tasksWhat needs fixing on a site, from stored checks. Call after writes, before publish_site.
get_draft_statusPending draft changes: content keys and routes with status. May include requiredDecision (publish_confirm) before publish_site.
review_changesReview queue: what changed and isn't live yet. list (counts first) → get one item (hidden changes, optional diff, bodyChanged: false means only title/meta/route fields changed — review hidden, not the visible page) → mark_ready / unmark (≤50 ids). Then publish_site onlyReady:tru…
discard_draftsDiscard unpublished drafts: all (omit key/keys/routes/menus), one content key (key), menu draft only (menus:true), or a selection (keys, routes). Destructive — check get_draft_status first.
delete_sitePermanently delete site; confirmSlug must equal slug.
bulk_put_contentStage 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_manifestContent 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_replaceCase-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_contentFind pages containing a phrase (grep without reading bodies). Requires do-sqlite — graduate_site first if search_unavailable.
graduate_siteEnable 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: `reason` names the gate — unsupported source backend (never overridable); strictDraf…
apply_changesetStage 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…
import_site_from_urlImport URL to draft. On complete, response may include requiredDecision — preview then ask mirror vs editable before structure_*.
get_structure_statusFlat vs structured page counts; chromeCoverage = real per-fragment page counts + missedPages (check before promising sitewide edits). Informs user — do not auto-run analyze/apply while requiredDecision pending.
structure_site_analyzePropose shared layout + fragments; persist:false first. Wait for mirror-vs-editable answer if requiredDecision pending.
structure_site_applyRewrite flat pages to layout + fragments (draft). Do not call while requiredDecision pending — user must pick editable first. It extracts header/footer only; report chromeCoverage counts, not 'sitewide'. Afterwards share_section with no arguments lists the other repeated blocks…
get_structure_resultLast structure apply job result (structuredKeys, conflicts, partial).
adapt_site_analyzePropose 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 pendi…
adapt_site_applyApply 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_revertAtomically restore everything the last adapt_site_apply wrote (fragments, the menu doc when the op touched it, index, member configs, routes).
get_adapt_statusRead adapt state: proposal summary + proposalEtag (+ applied/consumed flag), undo-record presence, active or queued job progress. Use to resume in a fresh session.
list_contentList content keys (HTML/md); not assets — use list_assets. Defaults to 50 keys per page: raise limit (max 1000) or pass cursor (nextCursor). Per-row `size`/`missing` are measured only on pages of ≤100 rows; past that they're ABSENT (never `null`) unless you pass withSize:true (o…
get_contentRead 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_contentStage 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_chunkAppend 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_contentEdit one content key via ops[] (selector ops or replace-string; wrap/unwrap/move restructure siblings). Stages draft; op shapes in schema.
batch_patch_contentpatch_content on multiple keys; all-or-nothing validation. Preferred edit path for pages over 60KB. replace-string value/replace ≤60KB; whole call ≤80KB.
delete_contentDelete 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_contentRe-key a page by slug (draft or published static), server-side hash copy. Default deletes static routes; movePath:true repoints the route, rewrites menu refs, redirects and root-relative / {slug}.dotsy.site hrefs in draft HTML (as rename_page), and for an already-published page…
put_postStage 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_colle…
inspect_collectionCollection 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 = ne…
list_collectionsCollections 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_co…
update_collectionRename 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 it…
new_post_templateRead-only scaffold for a new post — suggested key/path, membership meta, blank or duplicate body. Then put_post (+ optional put_route).
get_collection_schemaRead 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 {…
put_collection_schemaReplace the whole field schema (draft; publish makes it live). Edit what get_collection_schema returns. Collection keys exactly as list_collections returns them ("blog/" or an id). Field: { key, type, label?, help?, required?, unique?, inCard?, default? } — type text (multiline,…
set_item_statusChange a roadmap/board item status (stamps dates; on release drafts the changelog post and links both ways). Never hand-edit *At, daysToRelease, or votes.
get_boardList board items with status, stamp fields, and baked vote counts (draft overlay included). Live vote totals: site host GET /__dotsy/votes.
list_votesList voters on one board item (voter id + source only — no email).
remove_votesRemove one voter's vote and drop their release subscription for that item.
list_suggestionsList form suggestions awaiting moderation (duplicate hints against the board).
moderate_suggestionDecide one form suggestion from list_suggestions: approve (new draft board item; stages content, does not publish), merge (into an existing board item, subscribes the voter/email) or decline (no board item).
add_ideaAdd an idea from outside the site (draft board item or inbox suggestion). Idempotent on externalRef.
list_ideasSearch draft/published board items and open suggestions by title token overlap.
infer_collection_schemaSuggest 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_c…
reindex_collectionBuild/finish collection indexes after publish returns collectionDataPending or collectionSqlPending.
preview_pageVerify-only composed HTML check; home preview may include requiredDecision — ask mirror vs editable before structure_*.
verify_pagePre-publish lint (tags, assets, layout, SEO, speed and accessibility). Summary first: health issues grouped by code, each with fix:{tool,args,fill?} — supply the fill args, then call. health.summary counts are whole-site (groups/codes filter only issues and assets). Pair with pr…
preflight_sitePlan check before publish or large build (counts, plan page cap, seo suggestions; imports: form_unwired advisory, webflow_store blocking). When ok is false, blocking lists the failed suggestion codes. Read-only.
start_edit_sessionOpen 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_outlineSite 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…
share_sectionMake 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/hi…
detach_sectionGive 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_routeGet one route by path (home is '/').
put_routeCreate/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_routePartial 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, includ…
rename_pageChange a page's URL: moves its route from `from` to `to`. Menu links and redirects to the old path retarget automatically; a 301 stays at the old path by default (leaveRedirect). Root-relative and https://{slug}.dotsy.site/ hrefs in draft page, layout and fragment HTML are rewri…
delete_routeRemove a route by path.
list_goalsList site conversion goals (pageview paths and form submits). Required before start_test.
put_goalsCreate or replace all site conversion goals (≤50). Required before start_test when no goal exists.
estimate_testEstimate days to reach promote readiness for a page (traffic baseline). Read-only.
start_testStart a same-URL A/B test (draft or live source). Rules → get_skill('verify') § A/B.
promote_experimentPromote a winning A/B variant to live — explicit user instruction only; see get_skill('verify') § A/B.
delete_draft_testRemove a draft A/B test (releases variant bodies; does not publish).
set_experiment_noteRecord what was learned from an ended A/B test (≤500 chars; null clears).
get_menuRead a menu's draft items and etag; menu rules → get_skill('nav').
put_menu_itemPartial upsert one menu item: send only the fields to change; every omitted field (parent, sort, label, kind, ref, newTab, html/childTemplate/childShell/attrs/data) keeps its stored value, and parent: null moves it to the top level. A new id needs label, kind and ref (parent def…
delete_menu_itemRemove one item from a menu (page stays live).
reorder_menuSet final menu order. Pass ifMatch from get_menu; stale → 409 with current items.
Details
| Endpoint | https://mcp.dotsy.ai/mcp (Streamable HTTP) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | ai.dotsy/mcp |
More developer tools servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
