paige

endpoint

https://mcp.dotsy.ai/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is paige live?

Yes — it answered the hub's last check (checked 43m ago). It answered 100% of checks over the last 30 days.

Is paige free to use?

No — it asks for a key or a login before it will serve.

What tools does paige have?

89 tools: update_brief, publish_site, search_content, import_site_from_url, structure_site_analyze, put_route, get_asset, submit_feedback, ….

Is paige safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• update_brief auth-required never probed

  Update `_intent/site.md` (site brief) or a page brief when `page` is set. See field descriptions for rules, notes, and head enums.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "body": {
        "type": "string",
        "maxLength": 50000,
        "description": "Replace narrative body (site ≤50k chars; page ≤10k)."
      },
      "goal": {
        "type": "string",
        "maxLength": 4000,
        "description": "Current goal (site ≤4k chars; page ≤2k)."
      },
      "head": {
        "description": "Head fields to merge. Site: purpose, audience, kind (exploration|production), priorities ({seo,analytics,design,mobile}: must|nice|skip), editingModel (ai|simple-editor|creator), sections, design.{palette,type,layout}. Page: purpose, design.{direction,hero}."
      },
      "page": {
        "type": "string",
        "description": "Content key — targets that page's brief (`_intent/pages/<key>.md`). Omit for the site brief."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "notes": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 4000
          },
          {
            "type": "object",
            "properties": {
              "seo": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 4000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "design": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 4000
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "content": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 4000
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false
          }
        ],
        "description": "Site: free-form ## Notes string (≤4k) OR per-section notes object for Design system / Content & CMS / SEO (null clears one). Page brief: string only (≤2k)."
      },
      "rules": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "id",
            "card",
            "text"
          ],
          "properties": {
            "id": {
              "type": "string",
              "pattern": "^[a-z0-9-]{2,40}$"
            },
            "card": {
              "enum": [
                "intent",
                "design",
                "content",
                "seo"
              ],
              "type": "string"
            },
            "text": {
              "type": "string",
              "maxLength": 160,
              "minLength": 1
            },
            "check": {
              "anyOf": [
                {
                  "anyOf": [
                    {
                      "type": "object",
                      "required": [
                        "type",
                        "max"
                      ],
                      "properties": {
                        "max": {
                          "type": "integer",
                          "maximum": 300,
                          "minimum": 10
                        },
                        "type": {
                          "type": "string",
                          "const": "title-max"
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "type",
                        "suffix"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "const": "title-suffix"
                        },
                        "suffix": {
                          "type": "string",
                          "maxLength": 60,
                          "minLength": 1
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "type",
                        "min",
                        "max"
                      ],
                      "properties": {
                        "max": {
                          "type": "integer",
                          "maximum": 1000,
                          "minimum": 1
                        },
                        "min": {
                          "type": "integer",
                          "maximum": 1000,
                          "minimum": 0
                        },
                        "type": {
                          "type": "string",
                          "const": "description-length"
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "type"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "const": "one-h1"
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "type",
                        "words"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "const": "banned-words"
                        },
                        "words": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 40,
                            "minLength": 1
                          },
                          "maxItems": 50,
                          "minItems": 1
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "type"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "const": "image-alt"
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "type",
                        "colors"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "const": "allowed-colors"
                        },
                        "colors": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "pattern": "^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$"
                          },
                          "maxItems": 24,
                          "minItems": 1
                        }
                      },
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "required": [
                        "type",
                        "fonts"
                      ],
                      "properties": {
                        "type": {
                          "type": "string",
                          "const": "allowed-fonts"
                        },
                        "fonts": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "maxLength": 60,
                            "minLength": 1
                          },
                          "maxItems": 12,
                          "minItems": 1
                        }
                      },
                      "additionalProperties": false
                    }
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "level": {
              "enum": [
                "block",
                "warn"
              ],
              "type": "string"
            },
            "locked": {
              "type": "boolean"
            }
          },
          "additionalProperties": false
        },
        "maxItems": 30,
        "description": "Rules & guidelines lines to add or change (upsert by id — send only fields you change; omitted fields keep their stored value; check: null turns a Rule into a Guideline). A supported check (title-max, title-suffix, description-length, one-h1, banned-words, image-alt, allowed-colors, allowed-fonts) makes a Rule — use level block for hard musts (banned words, title suffix), warn for softer checks. locked can only be set by a person; locked: false unlocks."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "removeRules": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "maxItems": 30,
        "description": "Ids of rules or guidelines to remove (site brief only)."
      },
      "appendHandoff": {
        "type": "string",
        "maxLength": 500,
        "minLength": 1,
        "description": "Append a hand-off log line — site brief only; ignored when page is set."
      }
    },
    "additionalProperties": false
  }

  arguments 319 lines copy
• publish_site auth-required never probed

  Publish draft to live. feedback and handoff required (use dummy feedback + one-line handoff if clean).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "feedback",
      "handoff",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "pages": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        },
        "maxItems": 50,
        "description": "Publish only these pages — use when a publish returns rules_not_fully_checked; publish the rest in further batches (≤50 route paths, e.g. /pricing)."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "handoff": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: decisions, preferences, or open threads for the next session (appended to the brief)."
      },
      "feedback": {
        "type": "object",
        "required": [
          "category",
          "impactPercent",
          "title"
        ],
        "properties": {
          "title": {
            "type": "string"
          },
          "category": {
            "enum": [
              "missing_tool",
              "blocking_error",
              "extra_round_trips",
              "confusing_response",
              "workaround",
              "other"
            ],
            "type": "string",
            "description": "missing_tool | blocking_error | extra_round_trips | confusing_response | workaround | other"
          },
          "findings": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "category",
                "impactPercent",
                "title"
              ],
              "properties": {
                "title": {
                  "type": "string"
                },
                "category": {
                  "$ref": "#/properties/feedback/properties/category"
                },
                "description": {
                  "type": "string"
                },
                "operationId": {
                  "type": "string"
                },
                "impactPercent": {
                  "type": "integer",
                  "maximum": 100,
                  "minimum": 1
                },
                "suggestedImprovement": {
                  "type": "string"
                }
              },
              "additionalProperties": false
            },
            "maxItems": 20
          },
          "description": {
            "type": "string"
          },
          "impactPercent": {
            "type": "integer",
            "maximum": 100,
            "minimum": 1
          },
          "suggestedImprovement": {
            "type": "string"
          }
        },
        "description": "Required. Canonical dummy OK on friction-free sessions; tool intents attached automatically.",
        "additionalProperties": false
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "acknowledgeSeoWarnings": {
        "type": "boolean",
        "description": "Required when brief.priorities.seo is must and verify_page reported SEO errors (not warnings). User must have explicitly chosen to publish despite errors."
      },
      "confirmedDraftFingerprint": {
        "type": "string",
        "description": "Required when get_draft_status returned requiredDecision (publish_confirm). Must match the current draft fingerprint from get_draft_status."
      }
    },
    "additionalProperties": false
  }

  arguments 122 lines copy
• search_content auth-required never probed

  Find pages containing a phrase (grep without reading bodies). Requires do-sqlite — graduate_site first if search_unavailable.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "q",
      "context"
    ],
    "properties": {
      "q": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "limit": {
        "type": "integer",
        "maximum": 200,
        "minimum": 1
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 34 lines copy
• import_site_from_url auth-required never probed

  Import URL to draft. On complete, response may include requiredDecision — preview then ask mirror vs editable before structure_*.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "sourceUrl",
      "context"
    ],
    "properties": {
      "mode": {
        "enum": [
          "auto",
          "mirror",
          "render"
        ],
        "type": "string",
        "description": "Default auto — per-page mirror with silent render escalation"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "pages": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "url",
            "key"
          ],
          "properties": {
            "key": {
              "type": "string"
            },
            "url": {
              "type": "string"
            },
            "mode": {
              "enum": [
                "auto",
                "mirror",
                "render"
              ],
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "description": "Explicit page list; omit to import sourceUrl as index.html"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "segments": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "pathPrefix"
          ],
          "properties": {
            "mode": {
              "enum": [
                "auto",
                "mirror",
                "render"
              ],
              "type": "string"
            },
            "sitemap": {
              "type": "string",
              "description": "Sitemap path relative to sourceUrl, e.g. /designs/sitemap.xml. Omit only to import this segment's single hub page — expansion does NOT happen without it, and a segment_hub_only warning is returned as a reminder."
            },
            "maxPages": {
              "type": "integer",
              "maximum": 5000,
              "minimum": 1
            },
            "pathPrefix": {
              "type": "string",
              "description": "e.g. / or /designs"
            }
          },
          "additionalProperties": false
        },
        "description": "Split-origin segments — each expands into pages by fetching its own `sitemap`. A segment without `sitemap` imports only its pathPrefix hub page (with a warning), not the whole prefix."
      },
      "sourceUrl": {
        "type": "string",
        "format": "uri"
      },
      "workspace": {
        "type": [
          "string",
          "null"
        ],
        "description": "Workspace org id or slug (see get_account_context memberships). Only for multi-workspace users; omit otherwise. Ignored for pga_ keys (fixed workspace)."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "onSlugTaken": {
        "enum": [
          "fail",
          "auto-suffix",
          "merge"
        ],
        "type": "string",
        "default": "auto-suffix"
      },
      "keyConvention": {
        "enum": [
          "flat",
          "directory"
        ],
        "type": "string",
        "description": "Content key shape: directory = Astro dist (about/index.html); default flat"
      }
    },
    "additionalProperties": false
  }

  arguments 125 lines copy
• structure_site_analyze auth-required never probed

  Propose shared layout + fragments; persist:false first. Wait for mirror-vs-editable answer if requiredDecision pending.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "full": {
        "type": "boolean",
        "description": "Return the full manifest incl. per-page HTML samples (default: compacted — etag/action/counts kept, samples truncated — to fit the token budget)."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "scope": {
        "enum": [
          "flat-only",
          "all"
        ],
        "type": "string",
        "description": "Default flat-only; analyze clusters flat keys only."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "persist": {
        "type": "boolean",
        "description": "First call: false (preview only). true only after user confirms editable/CMS mode."
      },
      "profileId": {
        "enum": [
          "webflow",
          "wordpress",
          "generic",
          "framer"
        ],
        "type": "string"
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "sampleLimit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1
      },
      "refreshManifest": {
        "type": "boolean",
        "description": "Replace persisted manifest when true."
      }
    },
    "additionalProperties": false
  }

  arguments 59 lines copy
• put_route auth-required never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "path",
      "context"
    ],
    "properties": {
      "nav": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "menu"
              ],
              "properties": {
                "menu": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Menu this page joins — matches a <dotsy-nav menu=\"…\"> in the layout/fragment (e.g. \"primary\", \"footer\")."
                },
                "order": {
                  "type": "integer",
                  "description": "Sort position among siblings in this menu, ascending. Use gaps (10, 20, 30) to leave room for inserts."
                },
                "parent": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Parent route path within this menu for a nested/dropdown item (e.g. \"/services\"). Omit for top level."
                }
              },
              "additionalProperties": false
            }
          },
          {
            "type": "null"
          }
        ],
        "description": "DEPRECATED — use put_menu_item / menu API. Menu memberships on the route row. Still accepted during transition and synced to menu items. See get_skill('nav')."
      },
      "path": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "vars": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ]
      },
      "title": {
        "type": [
          "string",
          "null"
        ]
      },
      "layout": {
        "type": [
          "string",
          "null"
        ]
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "noindex": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "Exclude from sitemap/RSS; inject noindex meta (0.69)."
      },
      "purpose": {
        "type": [
          "string",
          "null"
        ]
      },
      "navLabel": {
        "type": [
          "string",
          "null"
        ],
        "description": "DEPRECATED — use put_menu_item / menu API. Menu link text for <dotsy-nav> (separate from title). Still accepted during transition and synced to menu items."
      },
      "contentKey": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "description": "Explicit content key (defaults to a path-derived key when omitted). null clears an explicit key back to that path default — same as omitting it, but usable on a PATCH to undo a prior set."
      },
      "experiment": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "id",
              "name",
              "status",
              "variants"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-z0-9-]+$",
                "description": "Stable experiment slug — cookie namespace; unique per site forever."
              },
              "name": {
                "type": "string",
                "maxLength": 80,
                "minLength": 1
              },
              "goalId": {
                "type": "string",
                "minLength": 1,
                "description": "Optional Dotsy conversion goal; omit when tracking in external analytics."
              },
              "status": {
                "enum": [
                  "draft",
                  "running",
                  "ended"
                ],
                "type": "string"
              },
              "endedAt": {
                "type": "string"
              },
              "handsOff": {
                "type": "boolean",
                "description": "Hands-off mode (0.56e M4): the daily sweep may auto-promote a ≥95% winner or auto-end keep-A after 30 days. Prefer setting this via start_test; kept here so route PATCH round-trips (weights/settings updates) don't strip the flag."
              },
              "variants": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "weight",
                    "contentKey"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "pattern": "^[a-z0-9-]+$",
                      "description": "Variant arm id — default \"a\" / \"b\" on create."
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 80
                    },
                    "weight": {
                      "type": "integer",
                      "maximum": 100,
                      "minimum": 0
                    },
                    "contentKey": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Published body key (may be routeless)."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 3,
                "minItems": 2
              },
              "startedAt": {
                "type": "string"
              },
              "changeNote": {
                "type": "string",
                "maxLength": 120,
                "description": "One line on what the variant changes (0.56e M2). Kept here so route PATCH round-trips (weights/settings updates) don't strip it."
              },
              "hypothesis": {
                "type": "string",
                "maxLength": 200
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ]
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "redirectTo": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "description": "Redirect target, a root-relative path (/…). Required when purpose is \"redirect\". null clears it — only valid once purpose stops being \"redirect\" (a redirect route always needs a target)."
      },
      "preserveQuery": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "Append the visitor's original query string to the redirect target (default true on a redirect). null clears an explicit override."
      },
      "redirectStatus": {
        "anyOf": [
          {
            "enum": [
              301,
              302,
              308
            ],
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "description": "301 permanent / 302 or 308 temporary (default 301 on a redirect). null clears an explicit override."
      }
    },
    "additionalProperties": false
  }

  arguments 253 lines copy
• get_asset auth-required never probed

  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.

  mcp-tool

  12345678910111213141516171819202122232425262728293031

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string",
        "minLength": 1,
        "description": "Path after /assets/ on the site — e.g. photos/hero.webp or style.css. Do not prefix with assets/ or /. Uploaded files are live in the editor and draft preview at once; the published site picks them up at the next publish."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 31 lines copy
• submit_feedback auth-required never probed

  Optional mid-session feedback (required feedback rides with publish_site).

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "category",
      "impactPercent",
      "title",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "title": {
        "type": "string"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "category": {
        "enum": [
          "missing_tool",
          "blocking_error",
          "extra_round_trips",
          "confusing_response",
          "workaround",
          "other"
        ],
        "type": "string",
        "description": "missing_tool | blocking_error | extra_round_trips | confusing_response | workaround | other"
      },
      "findings": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "category",
            "impactPercent",
            "title"
          ],
          "properties": {
            "title": {
              "type": "string"
            },
            "category": {
              "$ref": "#/properties/category"
            },
            "description": {
              "type": "string"
            },
            "operationId": {
              "type": "string"
            },
            "impactPercent": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1
            },
            "suggestedImprovement": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "maxItems": 20
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "description": {
        "type": "string"
      },
      "impactPercent": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1
      },
      "suggestedImprovement": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 89 lines copy
• refresh_custom_domain auth-required never probed

  Poll one hostname until DNS/cert propagates.

  mcp-tool

  12345678910111213141516171819202122232425262728293031

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "host",
      "context"
    ],
    "properties": {
      "host": {
        "type": "string",
        "minLength": 1,
        "description": "Hostname to refresh, e.g. www.example.com"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 31 lines copy
• update_site auth-required never probed

  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 draftEditorUrl. signature toggles the "Made with Dotsy" badge ({enabled, mark: logo|dot, reveal: pill|seal}); it is live immediately.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "title": {
        "type": "string",
        "maxLength": 200
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "signature": {
        "type": "object",
        "properties": {
          "mark": {
            "enum": [
              "logo",
              "dot"
            ],
            "type": "string",
            "description": "Resting look: 'dot' (senna dot, default) or 'logo' (Dotsy logo)."
          },
          "reveal": {
            "enum": [
              "pill",
              "seal"
            ],
            "type": "string",
            "description": "On hover: 'seal' (rotating stamp, default) or 'pill' (\"Made with Dotsy\")."
          },
          "enabled": {
            "type": "boolean",
            "description": "Show the badge in the bottom-right corner of every published page."
          }
        },
        "description": "\"Made with Dotsy\" signature badge. Takes effect on the live site immediately, no publish needed.",
        "additionalProperties": false
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "editingMode": {
        "enum": [
          "live",
          "staged"
        ],
        "type": "string",
        "description": "How the editor's Save behaves. 'live' (default) publishes each save immediately; 'staged' keeps saves as drafts until publish_site. Prefer 'staged' when an agent will hand the editor to a person (see start_edit_session → draftEditorUrl) so keystrokes don't go straight to the public site. API writes always stage regardless of this setting."
      },
      "keyConvention": {
        "enum": [
          "flat",
          "directory"
        ],
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 71 lines copy
• stage_content_chunk auth-required never probed

  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.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "seq",
      "body",
      "context"
    ],
    "properties": {
      "seq": {
        "type": "integer",
        "maximum": 84,
        "minimum": 0
      },
      "body": {
        "type": "string",
        "minLength": 1
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "finalize": {
        "type": "boolean"
      },
      "stagingId": {
        "type": "string",
        "pattern": "^stg_[a-zA-Z0-9_-]+$"
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "contentType": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 46 lines copy
• update_collection auth-required never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string",
        "description": "Collection key exactly as list_collections returned it, e.g. \"posts\" or \"blog/\" (a hand-typed key may 404 or get silently normalized)."
      },
      "name": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 80
          },
          {
            "type": "null"
          }
        ],
        "description": "Display name (≤80 chars). null resets to the derived name."
      },
      "noun": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 40
          },
          {
            "type": "null"
          }
        ],
        "description": "Singular noun for one item, e.g. \"post\" (≤40 chars). null resets to the derived noun."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 54 lines copy
• preflight_site auth-required never probed

  Plan check before large build (counts, route soft limit). Read-only.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "requiredAssets": {
        "type": "integer",
        "minimum": 0,
        "description": "How many assets you plan to upload"
      },
      "requiredRoutes": {
        "type": "integer",
        "minimum": 0,
        "description": "How many routes you plan to add"
      }
    },
    "additionalProperties": false
  }

  arguments 35 lines copy
• get_route auth-required never probed

  Get one route by path (home is '/').

  mcp-tool

  1234567891011121314151617181920212223242526272829

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "path",
      "context"
    ],
    "properties": {
      "path": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 29 lines copy
• edit_page auth-required never probed

  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).

  mcp-tool

  1234567891011121314151617181920212223242526

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site"
    ],
    "properties": {
      "path": {
        "type": "string",
        "description": "Route path (default /)."
      },
      "site": {
        "type": "string",
        "description": "Site slug."
      },
      "stage": {
        "enum": [
          "draft",
          "published"
        ],
        "type": "string",
        "description": "Preview stage. Default draft; published is planned but not supported yet."
      }
    },
    "additionalProperties": false
  }

  arguments 26 lines copy
• adapt_site_analyze auth-required 43m ago

  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.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "full": {
        "type": "boolean",
        "description": "Return the full per-member harvest report (default: compacted for the token budget)."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "options": {
        "type": "object",
        "properties": {
          "menu": {
            "type": "string",
            "minLength": 1,
            "description": "Menu name the nav adapter wires (default \"primary\")."
          },
          "index": {
            "type": "string",
            "minLength": 1,
            "description": "Blog index content key (default: probe blog.html, posts.html, …)."
          },
          "prefix": {
            "type": "string",
            "minLength": 1,
            "description": "Member key prefix override, e.g. \"post/\" (default: detected from index card links)."
          },
          "basePath": {
            "type": "string",
            "minLength": 1,
            "description": "Index route path override, e.g. \"/blog\" (default: the index route)."
          },
          "fragment": {
            "type": "string",
            "pattern": "^[\\w-]+$",
            "description": "Chrome fragment name the nav adapter reads (default \"header\")."
          },
          "pageSize": {
            "type": "integer",
            "maximum": 500,
            "minimum": 1,
            "description": "Explicit page size (default: visible card count)."
          }
        },
        "additionalProperties": false
      },
      "adapters": {
        "type": "array",
        "items": {
          "enum": [
            "nav",
            "collection"
          ],
          "type": "string"
        },
        "minItems": 1,
        "description": "Which adapters to analyze (default: both)."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "refreshProposal": {
        "type": "boolean",
        "description": "Replace an existing UNCONSUMED proposal (otherwise re-analyze 409s proposal_exists)."
      }
    },
    "additionalProperties": false
  }

  arguments 82 lines copy
• get_form_submission auth-required never probed

  Read one form submission with the full field payload (explicit PII access — use only when needed).

  mcp-tool

  12345678910111213141516171819202122232425262728293031

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "id",
      "context"
    ],
    "properties": {
      "id": {
        "type": "string",
        "minLength": 1,
        "description": "Submission id from list_form_submissions"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 31 lines copy
• get_site_build_progress auth-required never probed

  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.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug."
      }
    },
    "additionalProperties": false
  }

  arguments 14 lines copy
• estimate_test auth-required 43m ago

  Estimate days to reach promote readiness for a page (traffic baseline). Read-only.

  mcp-tool

  123456789101112131415161718192021222324252627282930

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "path",
      "context"
    ],
    "properties": {
      "path": {
        "type": "string",
        "description": "Route path, e.g. /pricing"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 30 lines copy
• get_account_context auth-required 43m ago

  Account, user, memberships[]. Pass workspace on writes when memberships.length > 1.

  mcp-tool

  123456789101112131415161718192021222324252627

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "context"
    ],
    "properties": {
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "workspace": {
        "type": [
          "string",
          "null"
        ],
        "description": "Workspace org id or slug (see get_account_context memberships). Only for multi-workspace users; omit otherwise. Ignored for pga_ keys (fixed workspace)."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 27 lines copy
• create_site auth-required never probed

  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.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "slug",
      "context"
    ],
    "properties": {
      "slug": {
        "type": "string",
        "minLength": 1
      },
      "title": {
        "type": "string",
        "maxLength": 200
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "purpose": {
        "type": "string",
        "maxLength": 280,
        "minLength": 5
      },
      "workspace": {
        "type": [
          "string",
          "null"
        ],
        "description": "Workspace org id or slug (see get_account_context memberships). Only for multi-workspace users; omit otherwise. Ignored for pga_ keys (fixed workspace)."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "editingMode": {
        "enum": [
          "live",
          "staged"
        ],
        "type": "string",
        "description": "How the editor's Save behaves. 'live' (default) publishes each save immediately; 'staged' keeps saves as drafts until publish_site. Prefer 'staged' when an agent will hand the editor to a person (see start_edit_session → draftEditorUrl) so keystrokes don't go straight to the public site. API writes always stage regardless of this setting."
      },
      "onSlugTaken": {
        "enum": [
          "fail",
          "auto-suffix",
          "merge"
        ],
        "type": "string",
        "default": "auto-suffix"
      },
      "keyConvention": {
        "enum": [
          "flat",
          "directory"
        ],
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 65 lines copy
• get_site auth-required never probed

  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_pages is paginated — use cursor or get_site_manifest for the full route set.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "brief": {
        "type": "boolean",
        "description": "Include parsed brief head (default true)."
      },
      "pages": {
        "type": "boolean",
        "description": "Return the full pages[] array instead of the default ~25-entry head (server-capped at 1000 either way). Default false."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 33 lines copy
• get_analytics auth-required never probed

  Read-only traffic overview (default) or full breakdowns via include[]; optional bot id for crawler page drill-down.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "bot": {
        "type": "string",
        "description": "Crawler bot id (e.g. googlebot, gptbot) → that bot's top crawled pages under `crawlerBotPages`."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "range": {
        "enum": [
          "7d",
          "30d",
          "90d"
        ],
        "type": "string",
        "description": "Time window; default 30d."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "include": {
        "type": "array",
        "items": {
          "enum": [
            "pages",
            "sources",
            "countries",
            "devices",
            "browsers",
            "os",
            "utm",
            "goals",
            "series",
            "crawlers",
            "experiments",
            "events",
            "all"
          ],
          "type": "string"
        },
        "description": "Full breakdown sections to add under `detail`: pages, sources, countries, devices, browsers, os, utm, goals, series, crawlers, experiments, events — or 'all'. Omit for the overview only."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 60 lines copy
• rename_site auth-required never probed

  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. Never published: the old slug 404s on the API and the old hostname is released (no 301; create_site can reuse it). Analytics history stays on the old slug. HTML absolute URLs are not rewritten — publish_site refreshes sitemap; find_replace if stored HTML must change.

  mcp-tool

  12345678910111213141516171819202122232425262728293031

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "newSlug",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "newSlug": {
        "type": "string",
        "minLength": 1,
        "description": "New site slug (lowercase hostname stem)"
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 31 lines copy
• get_draft_status auth-required never probed

  Pending draft changes: content keys and routes with status. May include requiredDecision (publish_confirm) before publish_site.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• discard_drafts auth-required never probed

  Discard unpublished drafts: all (omit key/keys/routes), one content key (key), or a selection (keys, routes). Destructive — check get_draft_status first.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string",
        "minLength": 1
      },
      "keys": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        }
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "routes": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        }
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 43 lines copy
• delete_site auth-required never probed

  Permanently delete site; confirmSlug must equal slug.

  mcp-tool

  1234567891011121314151617181920212223242526272829

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "confirmSlug",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "confirmSlug": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 29 lines copy
• bulk_put_content auth-required never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "content",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "title": {
        "type": "string"
      },
      "content": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "key",
            "body"
          ],
          "properties": {
            "key": {
              "type": "string",
              "minLength": 1
            },
            "body": {
              "type": "string"
            },
            "contentType": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "maxItems": 10,
        "minItems": 1
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 54 lines copy
• get_site_manifest auth-required never probed

  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.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "mode": {
        "enum": [
          "published",
          "draft"
        ],
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "limit": {
        "type": "integer",
        "maximum": 1000,
        "minimum": 1
      },
      "cursor": {
        "type": "string"
      },
      "routes": {
        "type": "boolean"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 43 lines copy
• find_replace auth-required never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "find",
      "replace",
      "context"
    ],
    "properties": {
      "find": {
        "type": "string",
        "minLength": 1
      },
      "keys": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        }
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "replace": {
        "type": "string"
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "expectPerKey": {
        "type": "integer",
        "minimum": 1
      }
    },
    "additionalProperties": false
  }

  arguments 45 lines copy
• graduate_site auth-required never probed

  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 true, this client sends true unless you pass strictDrafts:false — blocking on unpublished drafts or unrecovered KV content rows; or a KV snapshot that looks incomplete (e.g. a page deleted in the last couple of minutes). force:true overrides ONLY that last, incomplete-snapshot gate — never the backend or strictDrafts gates. The blocked response's `reason` names which gate fired, and `audit` (+ `audit.warnings`) is aggregate COUNTS only (published/route/pending-draft counts) — never row keys — so judge the size of the gap, not a row list, before forcing. The flip is one-way: anything outside the frozen snapshot is unreachable once it lands.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "force": {
        "type": "boolean",
        "description": "Proceed past the incomplete-KV-snapshot 409 only — not the unsupported-backend or strictDrafts blocks, which force does nothing for. Read the blocked response's `reason` + `audit` first; the flip is one-way, so rows outside the snapshot are unreachable afterwards. Default false."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "strictDrafts": {
        "type": "boolean",
        "description": "Block on unpublished drafts or unrecovered KV content rows (default true — publish/discard first, or pass false to proceed anyway)."
      }
    },
    "additionalProperties": false
  }

  arguments 33 lines copy
• apply_changeset auth-required never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "writes": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "key"
          ],
          "properties": {
            "key": {
              "type": "string",
              "minLength": 1
            },
            "body": {
              "type": "string"
            },
            "route": {
              "type": "object",
              "required": [
                "path",
                "input"
              ],
              "properties": {
                "path": {
                  "type": "string",
                  "minLength": 1
                },
                "input": {
                  "type": "object",
                  "properties": {
                    "nav": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "required": [
                              "menu"
                            ],
                            "properties": {
                              "menu": {
                                "type": "string",
                                "minLength": 1,
                                "description": "Menu this page joins — matches a <dotsy-nav menu=\"…\"> in the layout/fragment (e.g. \"primary\", \"footer\")."
                              },
                              "order": {
                                "type": "integer",
                                "description": "Sort position among siblings in this menu, ascending. Use gaps (10, 20, 30) to leave room for inserts."
                              },
                              "parent": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "Parent route path within this menu for a nested/dropdown item (e.g. \"/services\"). Omit for top level."
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "DEPRECATED — use put_menu_item / menu API. Menu memberships on the route row. Still accepted during transition and synced to menu items. See get_skill('nav')."
                    },
                    "vars": {
                      "anyOf": [
                        {
                          "type": "object",
                          "additionalProperties": {
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "title": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "layout": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "noindex": {
                      "type": [
                        "boolean",
                        "null"
                      ],
                      "description": "Exclude from sitemap/RSS; inject noindex meta (0.69)."
                    },
                    "purpose": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "navLabel": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "DEPRECATED — use put_menu_item / menu API. Menu link text for <dotsy-nav> (separate from title). Still accepted during transition and synced to menu items."
                    },
                    "contentKey": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Explicit content key (defaults to a path-derived key when omitted). null clears an explicit key back to that path default — same as omitting it, but usable on a PATCH to undo a prior set."
                    },
                    "experiment": {
                      "anyOf": [
                        {
                          "type": "object",
                          "required": [
                            "id",
                            "name",
                            "status",
                            "variants"
                          ],
                          "properties": {
                            "id": {
                              "type": "string",
                              "pattern": "^[a-z0-9-]+$",
                              "description": "Stable experiment slug — cookie namespace; unique per site forever."
                            },
                            "name": {
                              "type": "string",
                              "maxLength": 80,
                              "minLength": 1
                            },
                            "goalId": {
                              "type": "string",
                              "minLength": 1,
                              "description": "Optional Dotsy conversion goal; omit when tracking in external analytics."
                            },
                            "status": {
                              "enum": [
                                "draft",
                                "running",
                                "ended"
                              ],
                              "type": "string"
                            },
                            "endedAt": {
                              "type": "string"
                            },
                            "handsOff": {
                              "type": "boolean",
                              "description": "Hands-off mode (0.56e M4): the daily sweep may auto-promote a ≥95% winner or auto-end keep-A after 30 days. Prefer setting this via start_test; kept here so route PATCH round-trips (weights/settings updates) don't strip the flag."
                            },
                            "variants": {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "required": [
                                  "id",
                                  "weight",
                                  "contentKey"
                                ],
                                "properties": {
                                  "id": {
                                    "type": "string",
                                    "pattern": "^[a-z0-9-]+$",
                                    "description": "Variant arm id — default \"a\" / \"b\" on create."
                                  },
                                  "label": {
                                    "type": "string",
                                    "maxLength": 80
                                  },
                                  "weight": {
                                    "type": "integer",
                                    "maximum": 100,
                                    "minimum": 0
                                  },
                                  "contentKey": {
                                    "type": "string",
                                    "minLength": 1,
                                    "description": "Published body key (may be routeless)."
                                  }
                                },
                                "additionalProperties": false
                              },
                              "maxItems": 3,
                              "minItems": 2
                            },
                            "startedAt": {
                              "type": "string"
                            },
                            "changeNote": {
                              "type": "string",
                              "maxLength": 120,
                              "description": "One line on what the variant changes (0.56e M2). Kept here so route PATCH round-trips (weights/settings updates) don't strip it."
                            },
                            "hypothesis": {
                              "type": "string",
                              "maxLength": 200
                            }
                          },
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "redirectTo": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Redirect target, a root-relative path (/…). Required when purpose is \"redirect\". null clears it — only valid once purpose stops being \"redirect\" (a redirect route always needs a target)."
                    },
                    "preserveQuery": {
                      "type": [
                        "boolean",
                        "null"
                      ],
                      "description": "Append the visitor's original query string to the redirect target (default true on a redirect). null clears an explicit override."
                    },
                    "redirectStatus": {
                      "anyOf": [
                        {
                          "enum": [
                            301,
                            302,
                            308
                          ],
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "301 permanent / 302 or 308 temporary (default 301 on a redirect). null clears an explicit override."
                    }
                  },
                  "additionalProperties": false
                }
              },
              "additionalProperties": false
            },
            "ifMatch": {
              "type": "string"
            },
            "menuItems": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "sort",
                  "parent",
                  "label",
                  "kind",
                  "ref",
                  "menu"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ref": {
                    "type": "string"
                  },
                  "data": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  },
                  "html": {
                    "type": "string"
                  },
                  "kind": {
                    "enum": [
                      "page",
                      "url",
                      "anchor",
                      "mailto",
                      "group"
                    ],
                    "type": "string"
                  },
                  "menu": {
                    "type": "string",
                    "minLength": 1
                  },
                  "sort": {
                    "type": "integer"
                  },
                  "attrs": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1
                  },
                  "newTab": {
                    "type": "boolean",
                    "default": false
                  },
                  "parent": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "childShell": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "childTemplate": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            },
            "bodyStaging": {
              "type": "string",
              "pattern": "^stg_[a-zA-Z0-9_-]+$"
            },
            "contentType": {
              "type": "string"
            }
          },
          "additionalProperties": false
        },
        "default": [],
        "maxItems": 10
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "deletes": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        },
        "default": [],
        "maxItems": 50
      },
      "message": {
        "type": "string",
        "maxLength": 2000
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 392 lines copy
• get_structure_status auth-required never probed

  Flat vs structured page counts; informs user — do not auto-run analyze/apply while requiredDecision pending.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• decompose_analyze auth-required never probed

  Deprecated — use structure_site_analyze.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "full": {
        "type": "boolean",
        "description": "Return the full manifest incl. per-page HTML samples (default: compacted — etag/action/counts kept, samples truncated — to fit the token budget)."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "scope": {
        "enum": [
          "flat-only",
          "all"
        ],
        "type": "string",
        "description": "Default flat-only; analyze clusters flat keys only."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "persist": {
        "type": "boolean",
        "description": "First call: false (preview only). true only after user confirms editable/CMS mode."
      },
      "profileId": {
        "enum": [
          "webflow",
          "wordpress",
          "generic",
          "framer"
        ],
        "type": "string"
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "sampleLimit": {
        "type": "integer",
        "maximum": 50,
        "minimum": 1
      },
      "refreshManifest": {
        "type": "boolean",
        "description": "Replace persisted manifest when true."
      }
    },
    "additionalProperties": false
  }

  arguments 59 lines copy
• structure_site_apply auth-required never probed

  Rewrite flat pages to layout + fragments (draft). Do not call while requiredDecision pending — user must pick editable first.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "ifMatch",
      "context"
    ],
    "properties": {
      "keys": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        },
        "description": "Required when scope is keys."
      },
      "mode": {
        "enum": [
          "apply",
          "review-only"
        ],
        "type": "string",
        "description": "Default apply. Neither value is a dry run — review-only persists the same content/layout write as apply. Only pass review-only after a review_required error (low analyze confidence); it labels the result outcome \"review\" and defers primary-nav auto-wiring to a later apply call."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "scope": {
        "enum": [
          "flat-only",
          "all",
          "keys",
          "new-since-last"
        ],
        "type": "string"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "ifMatch": {
        "type": "string",
        "minLength": 1,
        "description": "Manifest etag from structure_site_analyze or get_structure_status."
      },
      "overrides": {
        "type": "object",
        "properties": {
          "forceSkipKeys": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "restructure": {
        "type": "boolean",
        "description": "Required true when scope all and site has structured pages."
      }
    },
    "additionalProperties": false
  }

  arguments 72 lines copy
• get_structure_result auth-required never probed

  Last structure apply job result (structuredKeys, conflicts, partial).

  mcp-tool

  1234567891011121314151617181920212223242526272829

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "full": {
        "type": "boolean",
        "description": "Return the full manifest/detail (default: compacted for the token budget)."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 29 lines copy
• adapt_site_apply auth-required never probed

  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.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "ifMatch",
      "adapters",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "force": {
        "type": "string",
        "const": "discard-undo",
        "description": "An undo record from a prior apply exists (409 adapt_undo_exists): defer-discard it — the prior record is dropped only when this apply SUCCEEDS; a partial-failure rollback reinstates it. Prefer adapt revert first."
      },
      "dryRun": {
        "type": "boolean",
        "description": "Full computation, would-write set + previews, ZERO writes, no undo."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "ifMatch": {
        "type": "string",
        "minLength": 1,
        "description": "The proposal etag from analyze (or GET …/adapt/proposal / status)."
      },
      "adapters": {
        "type": "array",
        "items": {
          "enum": [
            "nav",
            "collection"
          ],
          "type": "string"
        },
        "minItems": 1,
        "description": "Which analyzed adapters to apply."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 53 lines copy
• adapt_site_revert auth-required never probed

  Atomically restore everything the last adapt_site_apply wrote (fragments, the menu doc when the op touched it, index, member configs, routes).

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• get_adapt_status auth-required never probed

  Read adapt state: proposal summary + proposalEtag (+ applied/consumed flag), undo-record presence, active or queued job progress. Use to resume in a fresh session.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• list_content auth-required never probed

  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 `null`) unless you pass withSize:true, which forces measurement at a cost of one storage read per returned row. Only `size: null` + `missing: true` means the page's stored bytes are gone.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "limit": {
        "type": "integer",
        "maximum": 1000,
        "minimum": 1,
        "description": "Keys per page (default 50, max 1000)."
      },
      "cursor": {
        "type": "string",
        "description": "Resume from a prior response's nextCursor."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "withSize": {
        "type": "boolean",
        "description": "Force size/missing measurement on a page bigger than 100 rows (costs one storage read per returned row). Default false — rows in a ≤100-row page are measured either way."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 39 lines copy
• get_content auth-required never probed

  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.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "selector": {
        "type": "string"
      },
      "published": {
        "type": "boolean"
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 35 lines copy
• put_content auth-required never probed

  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.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "body",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string"
      },
      "body": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "contentType": {
        "type": "string",
        "minLength": 1
      }
    },
    "additionalProperties": false
  }

  arguments 37 lines copy
• patch_content auth-required never probed

  Edit one content key via ops[] (selector ops or replace-string). Stages draft; op shapes in schema.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "ops",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string"
      },
      "ops": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "op"
          ],
          "properties": {
            "op": {
              "enum": [
                "set-attr",
                "remove-attr",
                "replace-text",
                "remove-node",
                "insert-after",
                "replace-inner-html",
                "replace-outer-html",
                "replace-string"
              ],
              "type": "string"
            },
            "find": {
              "type": "string",
              "minLength": 1
            },
            "name": {
              "type": "string",
              "minLength": 1
            },
            "value": {
              "type": "string"
            },
            "expect": {
              "type": "integer",
              "minimum": 0
            },
            "replace": {
              "type": "string"
            },
            "selector": {
              "type": "string",
              "minLength": 1
            }
          },
          "additionalProperties": false
        }
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 77 lines copy
• batch_patch_content auth-required never probed

  patch_content on multiple keys; all-or-nothing validation. Preferred edit path for pages over 60KB. replace-string value/replace ≤60KB; whole call ≤80KB.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "items",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "items": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "key",
            "ops"
          ],
          "properties": {
            "key": {
              "type": "string",
              "minLength": 1
            },
            "ops": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "op"
                ],
                "properties": {
                  "op": {
                    "enum": [
                      "set-attr",
                      "remove-attr",
                      "replace-text",
                      "remove-node",
                      "insert-after",
                      "replace-inner-html",
                      "replace-outer-html",
                      "replace-string"
                    ],
                    "type": "string"
                  },
                  "find": {
                    "type": "string",
                    "minLength": 1
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1
                  },
                  "value": {
                    "type": "string"
                  },
                  "expect": {
                    "type": "integer",
                    "minimum": 0
                  },
                  "replace": {
                    "type": "string"
                  },
                  "selector": {
                    "type": "string",
                    "minLength": 1
                  }
                },
                "additionalProperties": false
              },
              "minItems": 1
            }
          },
          "additionalProperties": false
        },
        "maxItems": 50,
        "minItems": 1
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 93 lines copy
• delete_content auth-required never probed

  Delete content key (tombstone if published).

  mcp-tool

  1234567891011121314151617181920212223242526272829

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 29 lines copy
• rename_content auth-required never probed

  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 too (leaveRedirect, default true; no effect on a never-published page, or when movePath is false). Retry-safe: a part-way failure (409 rename_failed) rolls everything back, so resend the same call. Then publish_site.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "newSlug",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string",
        "description": "Current content key, e.g. dashboard.html"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "newSlug": {
        "type": "string",
        "minLength": 1,
        "description": "New filename stem; directory prefix preserved (blog/foo → blog/bar)"
      },
      "movePath": {
        "type": "boolean",
        "description": "false (default): delete routes bound to old key. true: move static route path to match slug."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "leaveRedirect": {
        "type": "boolean",
        "description": "With movePath:true on an already-published page, leave a 301 at the old path (default true). false removes the old path outright — old links break. No effect when movePath is false, or on a page that was never published."
      }
    },
    "additionalProperties": false
  }

  arguments 44 lines copy
• put_post auth-required never probed

  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.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "meta",
      "body",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string"
      },
      "body": {
        "type": "string"
      },
      "head": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "meta": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "url": {
            "type": "string"
          },
          "date": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "image": {
            "type": "string"
          },
          "title": {
            "type": "string",
            "description": "Post title — shown on the blog card/listing and used as the <title> unless seoTitle overrides it."
          },
          "author": {
            "type": "string"
          },
          "custom": {
            "type": "object",
            "additionalProperties": {}
          },
          "excerpt": {
            "type": "string"
          },
          "seoTitle": {
            "type": "string",
            "description": "SEO override for the <title>/og:title tags only. The blog card and listing always show `title`; empty or absent inherits `title`."
          },
          "visibleAt": {
            "$ref": "#/properties/meta/properties/date"
          },
          "collections": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "dateDisplay": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 94 lines copy
• inspect_collection auth-required never probed

  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 published post with unpublished edits is status published with hasChanges:true (never draft) and shows its staged title/date/tags/author; scheduled = future visibleAt. Never-published drafts come from staged content (no extra reads, no publish needed to see them); published/scheduled come from the index. limit defaults to 50, clamped 1-200. Omit all four for just the base inspect (no items[]).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "prefix",
      "context"
    ],
    "properties": {
      "q": {
        "type": "string",
        "description": "Case-insensitive title search within items[]."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "limit": {
        "type": "integer",
        "maximum": 200,
        "minimum": 1,
        "description": "Items per page (default 50, max 200)."
      },
      "cursor": {
        "type": "string",
        "description": "Resume from a prior response's nextCursor."
      },
      "prefix": {
        "type": "string",
        "description": "Collection id or prefix, e.g. \"posts\" or \"blog/\" — use the key exactly as list_collections returned it."
      },
      "status": {
        "enum": [
          "all",
          "published",
          "scheduled",
          "draft"
        ],
        "type": "string",
        "description": "Filter items[] by status (see the tool description for what each means). Providing this (or q/cursor/limit) is what makes the response include items[]."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 54 lines copy
• list_collections auth-required never probed

  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.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• new_post_template auth-required never probed

  Read-only scaffold for a new post — suggested key/path, membership meta, blank or duplicate body. Then put_post (+ optional put_route).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "collection",
      "context"
    ],
    "properties": {
      "mode": {
        "enum": [
          "blank",
          "duplicate"
        ],
        "type": "string",
        "description": "blank (default) or duplicate full body"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "collection": {
        "type": "string",
        "description": "Collection id or prefix, e.g. \"posts\" or \"blog/\""
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "templateKey": {
        "type": "string",
        "description": "Exemplar content key; default = most recent member"
      }
    },
    "additionalProperties": false
  }

  arguments 42 lines copy
• reindex_collection auth-required never probed

  Build/finish collection indexes after publish returns collectionDataPending or collectionSqlPending.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• preview_page auth-required never probed

  Verify-only composed HTML check; home preview may include requiredDecision — ask mirror vs editable before structure_*.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "path": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "variant": {
        "type": "string",
        "description": "A/B variant arm to compose (e.g. \"b\") — same as ?dotsy-variant= on the public URL."
      },
      "contains": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Assert substrings present in composed HTML."
      },
      "selector": {
        "type": "string",
        "description": "Return matched elements only (tag/attrs/text)."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "notContains": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Assert absent — e.g. `<dotsy-`, `<paige-` for unresolved template tags."
      }
    },
    "additionalProperties": false
  }

  arguments 50 lines copy
• verify_page auth-required never probed

  Pre-publish lint (tags, assets, layout). Pair with preview_page — see get_skill('verify').

  mcp-tool

  1234567891011121314151617181920212223242526272829303132

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "paths": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Routes to check; omit to verify every route on the site."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 32 lines copy
• start_edit_session auth-required never probed

  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 '/'.

  mcp-tool

  12345678910111213141516171819202122232425262728

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "path": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 28 lines copy
• get_site_outline auth-required never probed

  Site shape: every layout and section with its page count 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', 'what does this section reach', 'where does this menu show' — without listing every page. Read-only; indexing mirrors list_pages (a freshly imported/graduated site may still be indexing).

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• patch_route auth-required never probed

  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" in the SAME call — the check looks only at what's sent, not the route's stored purpose, so a PATCH that sets redirectTo without repeating purpose: "redirect" (even on a route that's already a redirect) 400s invalid_body.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "path",
      "context"
    ],
    "properties": {
      "nav": {
        "anyOf": [
          {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "menu"
              ],
              "properties": {
                "menu": {
                  "type": "string",
                  "minLength": 1,
                  "description": "Menu this page joins — matches a <dotsy-nav menu=\"…\"> in the layout/fragment (e.g. \"primary\", \"footer\")."
                },
                "order": {
                  "type": "integer",
                  "description": "Sort position among siblings in this menu, ascending. Use gaps (10, 20, 30) to leave room for inserts."
                },
                "parent": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Parent route path within this menu for a nested/dropdown item (e.g. \"/services\"). Omit for top level."
                }
              },
              "additionalProperties": false
            }
          },
          {
            "type": "null"
          }
        ],
        "description": "DEPRECATED — use put_menu_item / menu API. Menu memberships on the route row. Still accepted during transition and synced to menu items. See get_skill('nav')."
      },
      "path": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "vars": {
        "anyOf": [
          {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          {
            "type": "null"
          }
        ]
      },
      "title": {
        "type": [
          "string",
          "null"
        ]
      },
      "layout": {
        "type": [
          "string",
          "null"
        ]
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "noindex": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "Exclude from sitemap/RSS; inject noindex meta (0.69)."
      },
      "purpose": {
        "type": [
          "string",
          "null"
        ]
      },
      "navLabel": {
        "type": [
          "string",
          "null"
        ],
        "description": "DEPRECATED — use put_menu_item / menu API. Menu link text for <dotsy-nav> (separate from title). Still accepted during transition and synced to menu items."
      },
      "contentKey": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "description": "Explicit content key (defaults to a path-derived key when omitted). null clears an explicit key back to that path default — same as omitting it, but usable on a PATCH to undo a prior set."
      },
      "experiment": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "id",
              "name",
              "status",
              "variants"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[a-z0-9-]+$",
                "description": "Stable experiment slug — cookie namespace; unique per site forever."
              },
              "name": {
                "type": "string",
                "maxLength": 80,
                "minLength": 1
              },
              "goalId": {
                "type": "string",
                "minLength": 1,
                "description": "Optional Dotsy conversion goal; omit when tracking in external analytics."
              },
              "status": {
                "enum": [
                  "draft",
                  "running",
                  "ended"
                ],
                "type": "string"
              },
              "endedAt": {
                "type": "string"
              },
              "handsOff": {
                "type": "boolean",
                "description": "Hands-off mode (0.56e M4): the daily sweep may auto-promote a ≥95% winner or auto-end keep-A after 30 days. Prefer setting this via start_test; kept here so route PATCH round-trips (weights/settings updates) don't strip the flag."
              },
              "variants": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "weight",
                    "contentKey"
                  ],
                  "properties": {
                    "id": {
                      "type": "string",
                      "pattern": "^[a-z0-9-]+$",
                      "description": "Variant arm id — default \"a\" / \"b\" on create."
                    },
                    "label": {
                      "type": "string",
                      "maxLength": 80
                    },
                    "weight": {
                      "type": "integer",
                      "maximum": 100,
                      "minimum": 0
                    },
                    "contentKey": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Published body key (may be routeless)."
                    }
                  },
                  "additionalProperties": false
                },
                "maxItems": 3,
                "minItems": 2
              },
              "startedAt": {
                "type": "string"
              },
              "changeNote": {
                "type": "string",
                "maxLength": 120,
                "description": "One line on what the variant changes (0.56e M2). Kept here so route PATCH round-trips (weights/settings updates) don't strip it."
              },
              "hypothesis": {
                "type": "string",
                "maxLength": 200
              }
            },
            "additionalProperties": false
          },
          {
            "type": "null"
          }
        ]
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "redirectTo": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1
          },
          {
            "type": "null"
          }
        ],
        "description": "Redirect target, a root-relative path (/…). Required when purpose is \"redirect\". null clears it — only valid once purpose stops being \"redirect\" (a redirect route always needs a target)."
      },
      "preserveQuery": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "Append the visitor's original query string to the redirect target (default true on a redirect). null clears an explicit override."
      },
      "redirectStatus": {
        "anyOf": [
          {
            "enum": [
              301,
              302,
              308
            ],
            "type": "number"
          },
          {
            "type": "null"
          }
        ],
        "description": "301 permanent / 302 or 308 temporary (default 301 on a redirect). null clears an explicit override."
      }
    },
    "additionalProperties": false
  }

  arguments 253 lines copy
• rename_page auth-required never probed

  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); 400 reserved_route (to is under /__dotsy/) or invalid_body (missing/malformed from or to); 422 rename_same_path (from equals to already), rename_pattern_route (from or to contains a :param segment — pattern routes can't be renamed this way), rename_redirect_route (from is itself a different redirect — edit its redirectTo instead); 409 rename_experiment_running (an A/B test is running on from — end it first) or rename_target_exists (to is already a different route — unless to already serves the exact content from would, which is treated as already done and returns 200). Then publish_site.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "from",
      "to",
      "context"
    ],
    "properties": {
      "to": {
        "type": "string",
        "minLength": 1,
        "description": "New route path, e.g. /new-page"
      },
      "from": {
        "type": "string",
        "minLength": 1,
        "description": "Current route path, e.g. /old-page"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "leaveRedirect": {
        "type": "boolean",
        "description": "Leave a 301 from the old path to the new one (default true). false removes the old path outright — old links break."
      }
    },
    "additionalProperties": false
  }

  arguments 41 lines copy
• delete_route auth-required never probed

  Remove a route by path.

  mcp-tool

  1234567891011121314151617181920212223242526272829

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "path",
      "context"
    ],
    "properties": {
      "path": {
        "type": "string"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 29 lines copy
• list_goals auth-required never probed

  List site conversion goals (pageview paths and form submits). Required before start_test.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• put_goals auth-required never probed

  Create or replace all site conversion goals (≤50). Required before start_test when no goal exists.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "goals",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "goals": {
        "type": "array",
        "items": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "id",
                "label",
                "type",
                "pathPattern"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 64,
                  "minLength": 1
                },
                "type": {
                  "type": "string",
                  "const": "pageview"
                },
                "label": {
                  "type": "string",
                  "maxLength": 80,
                  "minLength": 1
                },
                "pathPattern": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1,
                  "description": "Match path exactly or prefix with trailing * (e.g. \"/thanks\" or \"/blog/*\")."
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "required": [
                "id",
                "label",
                "type",
                "formId"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 64,
                  "minLength": 1
                },
                "type": {
                  "type": "string",
                  "const": "form"
                },
                "label": {
                  "type": "string",
                  "maxLength": 80,
                  "minLength": 1
                },
                "formId": {
                  "type": "string",
                  "maxLength": 100,
                  "minLength": 1
                }
              },
              "additionalProperties": false
            },
            {
              "type": "object",
              "required": [
                "id",
                "label",
                "type",
                "eventName"
              ],
              "properties": {
                "id": {
                  "type": "string",
                  "maxLength": 64,
                  "minLength": 1
                },
                "type": {
                  "type": "string",
                  "const": "event"
                },
                "label": {
                  "type": "string",
                  "maxLength": 80,
                  "minLength": 1
                },
                "eventName": {
                  "enum": [
                    "download",
                    "cta_click"
                  ],
                  "type": "string",
                  "description": "Built-in client event name (0.47.1)."
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "maxItems": 50
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 131 lines copy
• start_test auth-required never probed

  Start a same-URL A/B test (draft or live source). Rules → get_skill('verify') § A/B.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "path",
      "goalId",
      "source",
      "context"
    ],
    "properties": {
      "name": {
        "type": "string",
        "maxLength": 80
      },
      "path": {
        "type": "string",
        "minLength": 1
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "goalId": {
        "type": "string",
        "minLength": 1
      },
      "source": {
        "enum": [
          "draft",
          "live"
        ],
        "type": "string"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "weights": {
        "type": "array",
        "items": {
          "type": "integer",
          "maximum": 100,
          "minimum": 0
        }
      },
      "handsOff": {
        "type": "boolean",
        "description": "Hands-off mode (0.56e M4): Dotsy finishes the test WITHOUT further user instruction — the LIVE SITE may change later on its own (a ≥95% winner is auto-promoted, old page kept as a draft; or after 30 days with no clear winner the test auto-ends keeping the control). Only set when the user explicitly asked for hands-off / auto-finish."
      },
      "changeNote": {
        "type": "string",
        "maxLength": 120,
        "description": "One line on what the variant changes, shown on the test card (≤120 chars)."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "hypothesis": {
        "type": "string",
        "maxLength": 200
      }
    },
    "additionalProperties": false
  }

  arguments 68 lines copy
• promote_experiment auth-required never probed

  Promote a winning A/B variant to live — explicit user instruction only; see get_skill('verify') § A/B.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "experimentId",
      "variantId",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "variantId": {
        "type": "string",
        "minLength": 1,
        "description": "Winning variant arm id (usually \"b\")."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "experimentId": {
        "type": "string",
        "minLength": 1
      },
      "loserDisposition": {
        "enum": [
          "discard",
          "keep_draft"
        ],
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 43 lines copy
• delete_draft_test auth-required never probed

  Remove a draft A/B test (releases variant bodies; does not publish).

  mcp-tool

  123456789101112131415161718192021222324252627282930

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "experimentId",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "experimentId": {
        "type": "string",
        "minLength": 1
      }
    },
    "additionalProperties": false
  }

  arguments 30 lines copy
• set_experiment_note auth-required never probed

  Record what was learned from an ended A/B test (≤500 chars; null clears).

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "experimentId",
      "note",
      "context"
    ],
    "properties": {
      "note": {
        "anyOf": [
          {
            "type": "string",
            "maxLength": 500
          },
          {
            "type": "null"
          }
        ],
        "description": "The learning, in plain words (≤500 chars, multiline ok) — null clears it."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "experimentId": {
        "type": "string",
        "minLength": 1
      }
    },
    "additionalProperties": false
  }

  arguments 43 lines copy
• get_menu auth-required never probed

  Read a menu's draft items and etag; menu rules → get_skill('nav').

  mcp-tool

  123456789101112131415161718192021222324252627282930

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "menu",
      "context"
    ],
    "properties": {
      "menu": {
        "type": "string",
        "minLength": 1
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 30 lines copy
• put_menu_item auth-required never probed

  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 names an item always updates that exact item, even if another item links the same page.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "menu",
      "id",
      "sort",
      "parent",
      "label",
      "kind",
      "ref",
      "context"
    ],
    "properties": {
      "id": {
        "type": "string",
        "minLength": 1
      },
      "ref": {
        "type": "string"
      },
      "data": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      },
      "html": {
        "type": "string"
      },
      "kind": {
        "enum": [
          "page",
          "url",
          "anchor",
          "mailto",
          "group"
        ],
        "type": "string"
      },
      "menu": {
        "type": "string",
        "minLength": 1
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "sort": {
        "type": "integer"
      },
      "attrs": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      },
      "label": {
        "type": "string",
        "minLength": 1
      },
      "newTab": {
        "type": "boolean",
        "default": false
      },
      "parent": {
        "type": [
          "string",
          "null"
        ]
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "childShell": {
        "type": [
          "string",
          "null"
        ]
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "childTemplate": {
        "type": "string"
      }
    },
    "additionalProperties": false
  }

  arguments 94 lines copy
• delete_menu_item auth-required never probed

  Remove one item from a menu (page stays live).

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "menu",
      "id",
      "context"
    ],
    "properties": {
      "id": {
        "type": "string",
        "minLength": 1
      },
      "menu": {
        "type": "string",
        "minLength": 1
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 35 lines copy
• reorder_menu auth-required never probed

  Set final menu order. Pass ifMatch from get_menu; stale → 409 with current items.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "menu",
      "orderedIds",
      "context"
    ],
    "properties": {
      "menu": {
        "type": "string",
        "minLength": 1
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "ifMatch": {
        "type": "string"
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "orderedIds": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        },
        "minItems": 1
      }
    },
    "additionalProperties": false
  }

  arguments 42 lines copy
• get_menu_doc auth-required never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "source": {
        "enum": [
          "draft",
          "live"
        ],
        "type": "string",
        "description": "Which doc to read. Default draft."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 33 lines copy
• put_menu_doc auth-required never probed

  Replace the whole menu doc (ifMatch from get_menu_doc required).

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "doc",
      "ifMatch",
      "context"
    ],
    "properties": {
      "doc": {
        "type": "object",
        "additionalProperties": {
          "type": "object",
          "required": [
            "items"
          ],
          "properties": {
            "items": {
              "type": "array",
              "items": {
                "type": "object",
                "required": [
                  "sort",
                  "parent",
                  "label",
                  "kind",
                  "ref",
                  "id",
                  "menu"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "minLength": 1
                  },
                  "ref": {
                    "type": "string"
                  },
                  "data": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  },
                  "html": {
                    "type": "string"
                  },
                  "kind": {
                    "enum": [
                      "page",
                      "url",
                      "anchor",
                      "mailto",
                      "group"
                    ],
                    "type": "string"
                  },
                  "menu": {
                    "type": "string",
                    "minLength": 1
                  },
                  "sort": {
                    "type": "integer"
                  },
                  "attrs": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  },
                  "label": {
                    "type": "string",
                    "minLength": 1
                  },
                  "newTab": {
                    "type": "boolean",
                    "default": false
                  },
                  "parent": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "childShell": {
                    "type": [
                      "string",
                      "null"
                    ]
                  },
                  "childTemplate": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            },
            "shell": {
              "type": [
                "string",
                "null"
              ]
            },
            "template": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "additionalProperties": false
        }
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "ifMatch": {
        "type": "string",
        "description": "Whole-doc etag from get_menu_doc. Required (sent as If-Match)."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 135 lines copy
• list_assets auth-required never probed

  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.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "limit": {
        "type": "integer",
        "maximum": 1000,
        "minimum": 1
      },
      "cursor": {
        "type": "string"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 33 lines copy
• bulk_put_assets auth-required never probed

  Upload 1–200 CMS assets; key = path after /assets/. Optional bodySha256 verifies submitted bytes before write; response sha256 is stored bytes (JS/CSS match; WebP rasters may differ). Uploaded files are live in the editor and draft preview at once; the published site picks them up at the next publish.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "items",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "items": {
        "type": "array",
        "items": {
          "type": "object",
          "required": [
            "key"
          ],
          "properties": {
            "key": {
              "type": "string",
              "minLength": 1,
              "description": "Path after /assets/ on the site — e.g. photos/hero.webp or style.css. Do not prefix with assets/ or /. Uploaded files are live in the editor and draft preview at once; the published site picks them up at the next publish."
            },
            "intent": {
              "enum": [
                "hero",
                "column",
                "inline",
                "logo"
              ],
              "type": "string"
            },
            "bodyBase64": {
              "type": "string"
            },
            "bodySha256": {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$",
              "description": "Optional SHA-256 of the submitted upload bytes (decoded bodyBase64 or raw PUT body). Mismatch returns body_sha256_mismatch before any write. Response/get_asset sha256 is the stored blob (WebP after IMAGES optimization for rasters; unchanged for JS/CSS/SVG)."
            },
            "contentType": {
              "type": "string",
              "minLength": 1
            },
            "importFromUrl": {
              "type": "string",
              "format": "uri"
            }
          },
          "additionalProperties": false
        },
        "maxItems": 200,
        "minItems": 1
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 70 lines copy
• delete_asset auth-required never probed

  Delete a static asset by key. The editor and draft preview drop it at once; the published site drops it at the next publish.

  mcp-tool

  12345678910111213141516171819202122232425262728293031

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "key",
      "context"
    ],
    "properties": {
      "key": {
        "type": "string",
        "minLength": 1,
        "description": "Path after /assets/ on the site — e.g. photos/hero.webp or style.css. Do not prefix with assets/ or /. Uploaded files are live in the editor and draft preview at once; the published site picks them up at the next publish."
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 31 lines copy
• start_site auth-required never probed

  Start one draft site with no Dotsy account. Returns slug + guestToken — pass guestToken on every later tool call until claim_site.

  mcp-tool

  1234567891011121314151617181920212223

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "context"
    ],
    "properties": {
      "title": {
        "type": "string",
        "maxLength": 200
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "purpose": {
        "type": "string",
        "maxLength": 2000
      }
    },
    "additionalProperties": false
  }

  arguments 23 lines copy
• claim_site auth-required never probed

  Move the guest draft onto your signed-in Dotsy account. Requires OAuth Connect; pass the guestToken from start_site.

  mcp-tool

  123456789101112131415161718192021

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "context",
      "guestToken"
    ],
    "properties": {
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site (required). Pass the pgg_ value returned by start_site."
      }
    },
    "additionalProperties": false
  }

  arguments 21 lines copy
• list_skills auth-required never probed

  Paige build skills (id + whenToUse). Pull get_skill on demand — do not duplicate in tool text.

  mcp-tool

  123456789101112131415

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "context"
    ],
    "properties": {
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      }
    },
    "additionalProperties": false
  }

  arguments 15 lines copy
• get_skill auth-required never probed

  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.

  mcp-tool

  1234567891011121314151617181920

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "id",
      "context"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Skill id or synonym from list_skills, e.g. intake, clone, list, menu"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      }
    },
    "additionalProperties": false
  }

  arguments 20 lines copy
• get_activity auth-required never probed

  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.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "slug",
      "context"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Event id — returns diff for this change instead of the list."
      },
      "key": {
        "type": "string",
        "description": "Content key when id is set (default first key in the event)."
      },
      "who": {
        "enum": [
          "all",
          "people",
          "agents"
        ],
        "type": "string",
        "description": "Default all."
      },
      "slug": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "actor": {
        "type": "string",
        "minLength": 1,
        "description": "Actor id or me."
      },
      "limit": {
        "type": "integer",
        "maximum": 20,
        "minimum": 1,
        "description": "Page size (default 20)."
      },
      "since": {
        "type": "string",
        "description": "ISO date (default 7 days, plan retention floor)."
      },
      "state": {
        "enum": [
          "needs_review",
          "reverted"
        ],
        "type": "string",
        "description": "needs_review = agent drafts awaiting a person's publish."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 65 lines copy
• revert_change auth-required never probed

  Undo one activity event by staging the prior version as draft only — call publish_site to go live. Respects AI access.

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738394041424344

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "slug",
      "id",
      "context"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "Activity event id from get_activity."
      },
      "keys": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        },
        "maxItems": 50,
        "description": "Undo only these keys of the change. Default: every key."
      },
      "slug": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "reason": {
        "type": "string",
        "maxLength": 200,
        "description": "Why — shown next to 'Reverted by …'. Visible to everyone on the site."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 44 lines copy
• add_custom_domain auth-required never probed

  Connect apex and/or www on a paid plan; starts a DNS connect session.

  mcp-tool

  123456789101112131415161718192021222324252627282930313233343536373839

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "hosts": {
        "type": "array",
        "items": {
          "type": "string",
          "minLength": 1
        },
        "maxItems": 2,
        "minItems": 1,
        "description": "1–2 hostnames: apex (example.com) and/or www (www.example.com)."
      },
      "domain": {
        "type": "string",
        "description": "Bare domain when hosts omitted — apex expands to apex + www; a subdomain connects as-is."
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 39 lines copy
• get_custom_domain_connect auth-required never probed

  Current connect session and nextAction (browser URL or manual DNS guide).

  mcp-tool

  1234567891011121314151617181920212223242526272829

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "sessionId": {
        "type": "string",
        "description": "Connect session id from add_custom_domain; omit to resume pending."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 29 lines copy
• reapply_custom_domain_oauth auth-required never probed

  Re-apply DNS with stored Cloudflare OAuth grant (no browser).

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• wait_for_custom_domain auth-required never probed

  Poll one hostname until it is connected or the timeout is reached.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "host",
      "context"
    ],
    "properties": {
      "host": {
        "type": "string",
        "minLength": 1,
        "description": "Hostname to wait for, e.g. www.example.com"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      },
      "timeoutSec": {
        "type": "integer",
        "maximum": 600,
        "minimum": 1,
        "description": "Max seconds to wait (default 300, max 600)."
      },
      "intervalSec": {
        "type": "integer",
        "maximum": 60,
        "minimum": 10,
        "description": "Seconds between polls (default 30, min 10, max 60)."
      }
    },
    "additionalProperties": false
  }

  arguments 43 lines copy
• set_primary_custom_domain auth-required never probed

  Set the canonical host (301 target) when multiple hostnames are connected.

  mcp-tool

  12345678910111213141516171819202122232425262728293031

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "host",
      "context"
    ],
    "properties": {
      "host": {
        "type": "string",
        "minLength": 1,
        "description": "Connected hostname to make primary"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 31 lines copy
• list_custom_domains auth-required never probed

  List all custom hostnames and connection status for the site.

  mcp-tool

  12345678910111213141516171819202122232425

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "context"
    ],
    "properties": {
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 25 lines copy
• remove_custom_domain auth-required never probed

  Remove one custom hostname from the site.

  mcp-tool

  12345678910111213141516171819202122232425262728293031

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "host",
      "context"
    ],
    "properties": {
      "host": {
        "type": "string",
        "minLength": 1,
        "description": "Hostname to remove"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 31 lines copy
• list_form_submissions auth-required never probed

  List form submissions (metadata + bounded field preview — not full PII). Works on kv and do-sqlite backends.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site",
      "form",
      "context"
    ],
    "properties": {
      "q": {
        "type": "string",
        "description": "Search reply-to email (indexed)"
      },
      "form": {
        "type": "string",
        "minLength": 1,
        "description": "Form id from dotsy-config, e.g. contact"
      },
      "site": {
        "type": "string",
        "description": "Site slug, e.g. acme-studio"
      },
      "toMs": {
        "type": "integer"
      },
      "limit": {
        "type": "integer",
        "maximum": 100,
        "minimum": 1
      },
      "cursor": {
        "type": "string"
      },
      "fromMs": {
        "type": "integer"
      },
      "context": {
        "type": "string",
        "minLength": 1,
        "description": "One sentence: why you are calling this tool and what you are trying to accomplish. Stored on the site's activity log and visible to everyone on the site — never put secrets or personal data here."
      },
      "guestToken": {
        "type": "string",
        "minLength": 20,
        "description": "Guest token from start_site. Send it on every call until claim_site. Omit when this chat is already signed in to Dotsy."
      }
    },
    "additionalProperties": false
  }

  arguments 49 lines copy
• list_my_sites auth-required never probed

  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 another workspace's sites without switching the dashboard session.

  mcp-tool

  1234567891011121314

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "workspace": {
        "type": [
          "string",
          "null"
        ],
        "description": "Workspace org id or slug (see get_account_context memberships). Only for multi-workspace users; omit otherwise. Ignored for pga_ keys (fixed workspace)."
      }
    },
    "additionalProperties": false
  }

  arguments 14 lines copy
• list_pages auth-required never probed

  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 verify-only checks (use preview_page). Pass view:'pages' to group by layout instead — adds layout/noLayout/q filters, what each page places, and indexing progress; use that for 'what pages use this layout' or 'is this page indexed yet', not for route settings. Paginated — pass cursor (from nextCursor) for more; partial:true means this page is a window, not the full route set.

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940414243

  {
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
      "site"
    ],
    "properties": {
      "q": {
        "type": "string",
        "description": "Only with view:'pages'. Case-insensitive substring match on path or title."
      },
      "site": {
        "type": "string",
        "description": "Site slug."
      },
      "view": {
        "enum": [
          "pages"
        ],
        "type": "string",
        "description": "pages: group by layout — enables layout/noLayout/q below, adds page-structure fields and indexing progress. Omit for the default per-route listing."
      },
      "limit": {
        "type": "integer",
        "maximum": 1000,
        "minimum": 1,
        "description": "Pages per page (server default applies when omitted)."
      },
      "cursor": {
        "type": "string",
        "description": "Resume from a prior response's nextCursor."
      },
      "layout": {
        "type": "string",
        "description": "Only with view:'pages'. Layout file key (e.g. layouts/store.html, or bare 'store') — only pages using it. Exclusive with noLayout."
      },
      "noLayout": {
        "type": "boolean",
        "description": "Only with view:'pages'. Only pages with no layout (routeless keys included). Exclusive with layout."
      }
    },
    "additionalProperties": false
  }

  arguments 43 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.