{"id":"ai.dotsy/mcp","slug":"ai-dotsy-mcp","title":"dotsy","description":"Build and publish static sites on dotsy with draft-first MCP tools, OAuth Connect, and API keys.","version":"0.9.22","publisher":{"kind":"domain","id":"dotsy.ai","label":"dotsy.ai","url":"https://dotsy.ai"},"website":"https://dotsy.ai","repository":"","remotes":[{"type":"streamable-http","url":"https://mcp.dotsy.ai/mcp"}],"packages":[],"published":"2026-11-19","updated":"2026-11-19","status":"online","auth":"","latency_ms":1430,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"create_site","title":"Create site","description":"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.","read_only":false},{"name":"get_site","title":"Site details","description":"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 list_content/get_site_manifest. Large sites (200+ pages): list_pages is paginated (cursor) or use get_site_manifest for the full route set.","read_only":true},{"name":"update_brief","title":"Update site brief","description":"Update `_intent/site.md` (site brief) or a page brief when `page` is set. See field descriptions for rules, notes, and head enums.","read_only":false},{"name":"get_plan","title":"Workspace plan and usage","description":"Read-only workspace plan and pooled usage; pass slug for this site's add-ons. Call before a large build.","read_only":true},{"name":"get_analytics","title":"Site analytics","description":"Read-only traffic overview (default) or full breakdowns via include[]; optional bot id for crawler page drill-down.","read_only":true},{"name":"set_analytics_provider","title":"Set analytics provider","description":"Connect an analytics provider (GA4, Plausible, Fathom, Umami) or remove it (provider 'none'). dotsy adds its script to every live page's <head>, no publish needed. One provider per site. Use this, not a pasted GA4 gtag snippet. Other tags (GTM, ads pixels, Clarity, verification <meta>) go in set_custom_code.","read_only":false},{"name":"get_custom_code","title":"Site custom code","description":"Read 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`.","read_only":true},{"name":"set_custom_code","title":"Set site custom code","description":"Set site-wide custom code: `head` goes before </head> and `body` before </body> on every page, on every layout. Saved as a draft; goes live with the next publish_site (on a live-mode site the dashboard publishes only the code). Never runs in the editor. ≤20,000 characters per box, stored as sent; `warnings` flags likely mistakes (unclosed <script>, <html>/<head>/<body> tags, canonical or robots ta","read_only":false},{"name":"set_site_icon","title":"Set site icon","description":"Set the favicon from a square image asset. Draft until publish.","read_only":false},{"name":"update_site","title":"Update site settings","description":"Update site settings: title, keyConvention, editingMode, signature (\"Made with dotsy\" badge; live immediately), trailingSlash, ownSeoFiles, aiTrain, and the language settings; each field's own description has the details. Slug is the hostname — use rename_site. Set editingMode 'staged' before handing the editor to a person via start_edit_session's draftEditorUrl.","read_only":false},{"name":"rename_site","title":"Rename site address","description":"Rename 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 hostname is released (create_site can reuse it). Stored HTML URLs are not rewritten (use find_replace).","read_only":false},{"name":"publish_site","title":"Publish site","description":"Publish 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 after the user has seen them and said to publish anyway; if you can't ask, fix them or stop and report. If a fix needs text ","read_only":false},{"name":"get_site_tasks","title":"Site open tasks","description":"What needs fixing on a site, from stored checks. Call after writes, before publish_site.","read_only":true},{"name":"get_draft_status","title":"Draft status","description":"Pending draft changes: content keys and routes with status. May include requiredDecision (publish_confirm) before publish_site.","read_only":true},{"name":"review_changes","title":"Review changes queue","description":"Review 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:true. Drafts-only sites: a person marks.","read_only":false},{"name":"discard_drafts","title":"Discard drafts","description":"Discard 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.","read_only":false},{"name":"delete_site","title":"Delete site","description":"Permanently delete site; confirmSlug must equal slug.","read_only":false},{"name":"bulk_put_content","title":"Save content in bulk","description":"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.","read_only":false},{"name":"get_site_manifest","title":"Site manifest","description":"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.","read_only":true},{"name":"find_replace","title":"Find and replace","description":"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.","read_only":false},{"name":"search_content","title":"Search content","description":"Find pages containing a phrase (grep without reading bodies). Requires do-sqlite — graduate_site first if search_unavailable.","read_only":true},{"name":"graduate_site","title":"Enable search and collections","description":"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: `reason` names the gate — unsupported source backend (never overridable); strictDrafts (default true; false skips it) on unpublished drafts or unrecovered KV rows; or an incomplete-looking KV snapshot (e.g","read_only":false},{"name":"apply_changeset","title":"Apply changeset","description":"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 ≤60KB and the call ≤80KB. Larger new pages: stage_content_chunk then writes[].bodyStaging, or dotsy pu","read_only":false},{"name":"import_site_from_url","title":"Import site from URL","description":"Import URL to draft. On complete, response may include requiredDecision — preview then ask mirror vs editable before structure_*.","read_only":false},{"name":"get_structure_status","title":"Structure status","description":"Flat 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.","read_only":true},{"name":"structure_site_analyze","title":"Analyze site structure","description":"Propose shared layout + fragments; persist:false first. Wait for mirror-vs-editable answer if requiredDecision pending.","read_only":false},{"name":"structure_site_apply","title":"Apply site structure","description":"Rewrite 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 (banner, CTA).","read_only":false},{"name":"get_structure_result","title":"Structure result","description":"Last structure apply job result (structuredKeys, conflicts, partial).","read_only":true},{"name":"adapt_site_analyze","title":"Analyze nav and blog","description":"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.","read_only":true},{"name":"adapt_site_apply","title":"Apply nav and blog changes","description":"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.","read_only":false},{"name":"adapt_site_revert","title":"Revert nav and blog changes","description":"Atomically restore everything the last adapt_site_apply wrote (fragments, the menu doc when the op touched it, index, member configs, routes).","read_only":false},{"name":"get_adapt_status","title":"Adapt status","description":"Read adapt state: proposal summary + proposalEtag (+ applied/consumed flag), undo-record presence, active or queued job progress. Use to resume in a fresh session.","read_only":true},{"name":"list_content","title":"List content","description":"List 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 (one storage read per row). Only `size: null` + `missing: true` means the page's bytes are gone.","read_only":true},{"name":"get_content","title":"Read content","description":"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.","read_only":true},{"name":"put_content","title":"Save content","description":"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.","read_only":false},{"name":"stage_content_chunk","title":"Stage large content chunk","description":"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.","read_only":false},{"name":"patch_content","title":"Edit content","description":"Edit one content key via ops[] (selector ops or replace-string; wrap/unwrap/move restructure siblings). Stages draft; op shapes in schema.","read_only":false},{"name":"batch_patch_content","title":"Edit content in bulk","description":"patch_content on multiple keys; all-or-nothing validation. Preferred edit path for pages over 60KB. replace-string value/replace ≤60KB; whole call ≤80KB.","read_only":false},{"name":"delete_content","title":"Delete content","description":"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.","read_only":false},{"name":"rename_content","title":"Rename content key","description":"Re-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 leaves a 301 (leaveRedirect, default true). Retry-safe: 409 rename_failed rolls back, resend. On fragments/<name>.html it","read_only":false},{"name":"put_post","title":"Save blog post","description":"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 response's fieldWarnings flag values that don't fit — soft, never blocking).","read_only":false},{"name":"inspect_collection","title":"Inspect collection","description":"Collection state — count, server.mode, sample entries, tag (membershipKind, match=) when discovered, name, noun, URL pattern, layout, where listed, post fields used. Pass status/q/cursor/limit (any one, even empty) for a full items[] page instead: status draft = never published; a published post with unpublished edits is status published with hasChanges:true (never draft), showing its staged title","read_only":true},{"name":"list_collections","title":"List collections","description":"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.","read_only":true},{"name":"update_collection","title":"Rename collection","description":"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 — different from omitting it, which leaves the current value alone.","read_only":false},{"name":"new_post_template","title":"New post template","description":"Read-only scaffold for a new post — suggested key/path, membership meta, blank or duplicate body. Then put_post (+ optional put_route).","read_only":true},{"name":"get_collection_schema","title":"Get collection fields","description":"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 the stored file is broken: fix it with put_collection_schema using that hash.","read_only":true},{"name":"put_collection_schema","title":"Replace collection fields","description":"Replace the whole field schema (draft; publish makes it live). Edit what get_collection_schema returns; keys as list_collections gives them (\"blog/\" or an id). Field: { key, type, label?, help?, required?, unique?, inCard?, default? } — type text (multiline, minLength, maxLength) | number (min, max, integer) | boolean | option (options[] required) | multiOption (options[] required, max) | link | e","read_only":false},{"name":"set_item_status","title":"Set board item status","description":"Change a roadmap/board item status (stamps dates; on release drafts the changelog post and links both ways). Never hand-edit *At, daysToRelease, or votes.","read_only":false},{"name":"get_board","title":"Get board snapshot","description":"List board items with status, stamp fields, and baked vote counts (draft overlay included). Live vote totals: site host GET /__dotsy/votes.","read_only":true},{"name":"list_votes","title":"List votes on an item","description":"List voters on one board item (voter id + source only — no email).","read_only":true},{"name":"remove_votes","title":"Remove a vote","description":"Remove one voter's vote and drop their release subscription for that item.","read_only":false},{"name":"list_suggestions","title":"List form suggestions","description":"List form suggestions to moderate (duplicate hints); `about` filters by tool id.","read_only":true},{"name":"moderate_suggestion","title":"Moderate a suggestion","description":"Decide 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.","read_only":false},{"name":"add_idea","title":"Add an external idea","description":"Add an idea from outside the site (draft board item or inbox suggestion). Idempotent on externalRef.","read_only":false},{"name":"list_ideas","title":"Search ideas and suggestions","description":"Search draft/published board items and open suggestions by title token overlap.","read_only":true},{"name":"infer_collection_schema","title":"Suggest collection fields","description":"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.","read_only":true},{"name":"reindex_collection","title":"Rebuild collection index","description":"Build/finish collection indexes after publish returns collectionDataPending or collectionSqlPending.","read_only":false},{"name":"preview_page","title":"Preview page","description":"Verify-only composed HTML check; home preview may include requiredDecision — ask mirror vs editable before structure_*.","read_only":true},{"name":"verify_page","title":"Verify page","description":"Pre-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 preview_page — see get_skill('verify').","read_only":true},{"name":"preflight_site","title":"Preflight site build","description":"Plan 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.","read_only":true},{"name":"start_edit_session","title":"Start edit session","description":"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 '/'.","read_only":false},{"name":"get_site_outline","title":"Site outline","description":"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. Answers 'is my layout missing', 'which shared sections exist and where', 'where does this menu show' without listing every page. Rea","read_only":true},{"name":"share_section","title":"Share a section","description":"Share a repeated block, or move/hide a shared section. No arguments: lists blocks on 3+ pages (likeSection: matches a shared one). sourceKey + selector (selectors: a sibling run): dry run lists pages; dryRun:false shares it. name + suggestionId: put it on a suggestion's pages (after = through while remaining > 0). name + scope/hide/show: move to/from every page, or hide/show per page. too_many_pag","read_only":false},{"name":"detach_section","title":"Detach a section","description":"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).","read_only":false},{"name":"get_route","title":"Get route","description":"Get one route by path (home is '/').","read_only":true},{"name":"put_route","title":"Save route","description":"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.","read_only":false},{"name":"patch_route","title":"Update route","description":"Partial route update (only sent fields change; an OMITTED field is left alone). On a nullable field (contentKey, redirectTo, redirectStatus, preserveQuery), null CLEARS it to its default — unlike omitting it. To set redirectTo/redirectStatus, send purpose: \"redirect\" in the SAME call (only what's sent is checked, even on an existing redirect) or it 400s invalid_body.","read_only":false},{"name":"rename_page","title":"Change page URL","description":"Change a page's URL: moves route `from` to `to`. Menu links and redirects to the old path retarget; a 301 stays at the old path (leaveRedirect). Root-relative and https://{slug}.dotsy.site/ hrefs in draft page, layout and fragment HTML are rewritten (linksRewritten; not custom-domain absolutes or code samples; linksRewriteTruncated when the scan caps at 100 HTML keys, 500 with full content search)","read_only":false},{"name":"delete_route","title":"Delete route","description":"Remove a route by path.","read_only":false},{"name":"list_goals","title":"List goals","description":"List site conversion goals (pageview paths and form submits). Required before start_test.","read_only":true},{"name":"put_goals","title":"Replace goals","description":"Create or replace all site conversion goals (≤50). Required before start_test when no goal exists.","read_only":false},{"name":"estimate_test","title":"Estimate A/B test","description":"Estimate days to reach promote readiness for a page (traffic baseline). Read-only.","read_only":true},{"name":"start_test","title":"Start A/B test","description":"Start a same-URL A/B test (draft or live source). Rules → get_skill('verify') § A/B.","read_only":false},{"name":"promote_experiment","title":"Promote A/B winner","description":"Promote a winning A/B variant to live — explicit user instruction only; see get_skill('verify') § A/B.","read_only":false},{"name":"delete_draft_test","title":"Delete draft A/B test","description":"Remove a draft A/B test (releases variant bodies; does not publish).","read_only":false},{"name":"set_experiment_note","title":"Save A/B test note","description":"Record what was learned from an ended A/B test (≤500 chars; null clears).","read_only":false},{"name":"get_menu","title":"Get menu","description":"Read a menu's draft items and etag; menu rules → get_skill('nav').","read_only":true},{"name":"put_menu_item","title":"Save menu item","description":"Partial upsert one menu item: send only the fields to change; omitted fields keep their stored value and parent: null moves it to the top level. data/attrs merge per key (data: {desc} keeps data.icon; a null value removes that key). A new id needs label, kind and ref (parent defaults to null, sort to the end) and dedupes by (menu, ref) onto an item linking the same target. An existing id updates t","read_only":false},{"name":"delete_menu_item","title":"Delete menu item","description":"Remove one item from a menu (page stays live).","read_only":false},{"name":"reorder_menu","title":"Reorder menu","description":"Set final menu order. Pass ifMatch from get_menu; stale → 409 with current items.","read_only":false}],"server_info":{"name":"dotsy","version":"0.9.22","title":"dotsy","websiteUrl":"https://dotsy.ai","icons":[{"src":"https://mcp.dotsy.ai/favicon.svg","mimeType":"image/svg+xml","sizes":["any"]},{"src":"https://mcp.dotsy.ai/icon-192.png","mimeType":"image/png","sizes":["192x192"]},{"src":"https://mcp.dotsy.ai/icon-256.png","mimeType":"image/png","sizes":["256x256"]},{"src":"https://mcp.dotsy.ai/icon-512.png","mimeType":"image/png","sizes":["512x512"]}]},"category":"news","tags":["travel","analytics","developer"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-06","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/ai-dotsy-mcp/"}