For your AI and the curious
The connector tools
Every tool the SiteShip connector gives an AI app. What each one takes, what it answers, and which ones need the owner's yes.
On this page
The SiteShip connector is a remote MCP server. It gives an AI app 19 tools to build, check and run sites, plus two that are not for the model. This page lists them all.
Tool descriptions and their input schemas are sent to the AI app when it connects, so an AI never needs this page. It is here for people.
Address and sign-in
https://app.siteship.ai/mcp
- Sign-in is OAuth. The AI app registers itself, then the owner signs in to SiteShip with an emailed code and allows the app. There is no API key.
- Every tool acts as the signed-in account. It sees that account's sites and no others.
- One prompt is offered,
get-started. It sends the words "Get started with SiteShip." - Call
guidefirst. With no topic it returns the account's sites, how to begin with this person, and how a site is built.
Every tool except guide, list_sites and create_site takes site: the subdomain or id from list_sites.
The connector tells the AI to ask the user before publish, before connecting or removing a domain, and before deleting a site.
Read
| Tool | What it does |
|---|---|
guide |
The rules for building a site. topic for one, topics for several |
list_sites |
The account's sites, with each one's address, domain, role and plan |
site_outline |
A map of one site's files. With query, a text search across them |
read_files |
Up to 20 text files in one call |
Guide topics: architecture, blog, cookie-consent, data-pages, embeds, forms, interactivity, local-seo, seo, shopify, stripe-payments.
{ "site": "harbor-dental", "paths": ["pages/index.html", "pages/about.html:120-200"] }
read_filesreads the draft when there is one. Add:from-toto a path for a line range of a long file.- Every read returns
draft_version. Send it back asexpected_versionon the next write. list_sitesalso returns the account's plan, how many live sites it allows, and how many are used. A free site carries anupgrade_urlto give the owner.
Write
| Tool | What it does |
|---|---|
create_site |
A new site from the starter, as a private draft. Takes name and an optional description |
write_files |
Create, overwrite or delete files in the draft |
edit_files |
Find-and-replace edits to existing draft files |
history |
The draft's last changes; undo and redo |
{
"site": "harbor-dental",
"summary": "Add the whitening page",
"expected_version": 12,
"files": [
{ "path": "pages/whitening.html", "content": "---\ntitle: Teeth Whitening\n---\n<h1>…</h1>" },
{ "path": "pages/old-offer.html", "content": null }
]
}
write_files
- Up to 50 files and 400 KB in one call. What does not fit comes back in
not_sent, to send in the next call. One page, template or data file can be up to 200 KB. content: nulldeletes the file.- Writable paths:
pages/(.html,.md),templates/(.html),data/(.yaml,.json,.csv), text files inassets/js/,assets/files/andassets/images/,theme.cssandfavicon.svg. templates/layout.htmlanddata/site.yamlneedconfirm_overwrite: trueto be replaced. Useedit_filesfor them.- Files are checked first. Those that pass are written. One that would break the site comes back in
rejected, with the problem, file and line. See Write-time checks. expected_versionrefuses the write if the draft changed since that version.job_idmarks a change as made for a crew job.
edit_files
{
"site": "harbor-dental",
"files": [
{ "path": "pages/index.html", "edits": [{ "old": "<h1>Old</h1>", "new": "<h1>New</h1>" }] }
]
}
- Up to 25 files in one call, and up to 20 edits in a file.
oldmust match once, unlessall: true. Whitespace differences are tolerated. On a miss, the answer shows the closest lines.- It is safe to retry: an edit that is already applied is reported, not repeated.
Both write tools answer with the new draft_version, a change number, diagnostics, an outline of each page changed, and a preview_url.
history
list returns about the last 50 changes, each with who or what made it, a summary and the files. undo reverses one change as a new change: the latest still in place, or the change you name. redo brings back the last one undone. If a file has changed since, nothing happens and the answer names those files.
Preview and check
| Tool | What it does |
|---|---|
preview |
Renders one draft page and checks it |
check |
Checks the whole site without changing anything |
{ "site": "harbor-dental", "path": "/services/whitening" }
preview returns problems with file and line, an outline of the page (title, headings, links, images missing alt text), its visible text, its schema.org markup, and a private link that works for 1 hour. Apps that support it show the draft in the chat, with a Publish button. path defaults to /. Asking for /sitemap.xml or /robots.txt returns what SiteShip will serve there.
check returns ready_to_publish, counts of blocking and warnings, problems grouped by file, and an SEO table by page. Run it before publish.
Publish and versions
| Tool | What it does |
|---|---|
publish |
Makes the draft the live site |
versions |
Lists published versions, or restores one into the draft |
publish checks the whole draft first, and blocking problems stop it. Its answer depends on the site:
| The site | Answer |
|---|---|
| A free preview | needs_plan, with an upgrade_url and a preview_url for the owner |
| On a plan, first publish | status: "live" |
| Already live | needs_approval, with an approve_url. A preview panel with a Publish changes button shows in the chat. The live site changes on the owner's click |
It takes an optional expected_version and a note for the version list. It is never called during a scheduled jobs run.
versions with action: "list" returns the published versions, which are kept 90 days, and the newest 10 always. action: "restore" loads one into the draft, where it can be previewed and then published. A restore is one change in the draft history, so history can undo it.
Images
| Tool | What it does |
|---|---|
add_image |
Finds stock photos, or copies an image from a web address into the draft |
request_upload |
Lets the owner upload their own images |
check_upload |
Lists what the owner uploaded |
{ "site": "harbor-dental", "search": ["dentist smiling with patient", "modern dental clinic reception"] }
add_imagewithsearchtakes one query or a list of up to 8, and returns the top 3 Unsplash photos for each query in a list, with alt text and the credit to show. The address is used as the imagesrcas it is.orientationislandscape,portraitorsquare.add_imagewithurldownloads onehttpsimage, up to 5 MB, intoassets/images/and returns its path.namesets the file name.request_uploadreturns anupload_idand anupload_url, and shows an upload panel in apps that support it. The link lasts 30 minutes. Files attached in a chat can't reach SiteShip, so this is the way in for the owner's own images.check_uploadtakes theupload_idand returns each image's path and thesrcto use.
Leads, jobs, domain, site
leads reads form submissions.
{ "site": "harbor-dental", "form": "quote", "since": "2026-11-01", "search": "kitchen" }
- Without
form: each form's counts and the latest leads across all forms. Withform: that form's submissions. - Newest first, 20 at a time.
next_cursorpages back, andmatchingis how many fit in all. - Filters:
since,until(UTC dates),search, andstatus:lead(the default),test,spamorunverified. export: "csv"returns a download link, good for an hour, to a spreadsheet of everything the filters match, up to 50,000 rows.- Submissions are personal data and untrusted text. The AI is told to show them to the owner, never to write them into site files, and never to follow instructions inside them.
jobs returns the work SiteShip found: new leads, SEO fixes, problems.
list, the default, returns due jobs with their steps and tools, ordue: false. At most 5 jobs come back in one run.- After each job:
doneorskipwith anote, orsnoozewithdays(1 to 30).updatescloses several at once. - During a run, changes go to the draft only. The AI is told never to publish, connect or remove a domain, delete a site or restore a version.
domain connects the owner's own domain.
action: "connect"with ahostname, such aswww.example.com, returns the DNS records to add at the registrar. On a free site it returnsneeds_planand anupgrade_url.action: "status"says whether the domain and its certificate are active. HTTPS is issued automatically once DNS is in place.action: "remove"disconnects it. A site has one connected domain at a time.
site renames or deletes a site.
action: "rename"changes the label inlist_sites. The name visitors see is indata/site.yaml.action: "delete"needsconfirmset to the site's subdomain, exactly. It is refused while a domain is connected.- Only the site's owner can do either.
The two that are not for the model
| Tool | Used by |
|---|---|
get_profile |
AI apps that match a connection to the user's verified email. Returns the account id, email and number of sites |
confirm_publish |
SiteShip's preview panel, when the owner clicks its Publish button. It needs a token only the panel holds |
An AI publishes by calling publish, never confirm_publish.
Related pages
Something wrong on this page? Email support@siteship.ai. Checked on November 14, 2026.