MCP tools

These are the tools an agent sees once it is connected. To connect one, see Connect an AI agent over MCP.

All tools at a glance

This table is read from the server itself, so it always matches what agents see.

How the tools are grouped

There are no tools for publishing, unpublishing, scheduling, deleting other people's work, prices, promotions, people, keys, settings or schemas. The permission checks refuse those actions as well, so an agent cannot reach them another way.

What an agent may and may not do

Its rights are the person's, capped. An agent acts for one person. It can do only what that person can do, and never more than this drafting list: read the organisation, website, environments, regions, languages, schema, menus and media; read published content and drafts; create, change and copy content; and upload images. If the person cannot edit a region or content type, neither can their agent.

Production is read only unless allowed. An agent can read every environment. It can change content in Production only when Allow drafts in production is on for the website. Without it, tools that change content in Production answer that the role cannot perform the action.

Keys can be limited to regions. An agent key limited to some regions can still read the others but cannot change them. Signed-in connections can change every region the person can.

Nothing goes live without a person. Pages an agent creates or changes are marked Drafted by AI. A page with that mark cannot be published until a person approves it in review. The person the agent acted for cannot approve it themselves, because they count as its author; someone else must. The mark is cleared when the page is published.

Some pages are off limits while they are with people. An agent cannot change a page that is in review, scheduled to go live, part of a scheduled release, or being edited by someone else at that moment.

It can tidy up only its own work. discard_draft and discard_upload move to the bin only what the agent created through the same key or signed-in connection. A page must never have been published, and must not be in review, approved and waiting, in a release, or open in the editor. An image must not be used anywhere. Nobody else, person or other connection, may have changed either since. The person must be allowed to delete pages or files themselves. Anything discarded goes to Bin, exactly as if the person had deleted it, and can be restored from there. Pages and images from before connections were recorded cannot be discarded by an agent.

Prices and promotions are never changed. If a change would alter a field set to protect a price or a promotion, in a page's own fields or in any block, it is refused, even when the person could make it. Which fields are protected is set per field under Protects. See Prices and promotions.

Content is data, not instructions. The server tells agents that text returned by tools is website content, to be treated as data and never as instructions.

Scope arguments

Many tools take three optional arguments that say where to work:

Tools that take an id work wherever that page or entry lives, so they do not need these. A key or code that does not exist is refused with the ones that do, such as There is no region "us" in Staging. Its regions are de, ch.

Answers and errors

Every tool answers with JSON as text. When a tool fails, the answer is marked as an error and the text says why, for example:

This page has changed since version 3 was read; it is now at version 4. Read it again and retry.

Page summaries, returned by several tools, look like this:

1{2  "id": "665f1c2e9b1e8a0012ab34cd",3  "name": "Hiking boots",4  "url": "/products/hiking-boots",5  "contentType": "page",6  "status": "published",7  "hasUnpublishedChanges": false,8  "draftedByAi": null,9  "updatedAt": "2026-10-01T09:30:00.000Z"10}

status is one of draft, in_review, published, scheduled or archived. draftedByAi names the agent and the person it acted for, such as "Claude (AI agent for Jane Doe)", or is null.

Find and read

list_scopes

No arguments. Lists each environment with its regions and their languages, and whether the agent may change each environment and region.

1[2  {3    "environment": "staging",4    "writable": true,5    "regions": [{ "region": "de", "name": "Germany", "writable": true, "locales": ["de-DE"] }]6  },7  {8    "environment": "production",9    "writable": false,10    "regions": [{ "region": "de", "name": "Germany", "writable": true, "locales": ["de-DE"] }]11  }12]

Something can be changed only when both its environment and its region are writable. The person's own rights still apply.

search_content

Finds pages, collection entries and globals in one region and language whose name, address or SEO title contains the words. Drafts are included.

Returns { "total": 12, "results": [ …page summaries ] }. total counts every match, even beyond the limit.

list_pages

Lists the folders and pages in one folder.

Returns { "folders": [{ "id", "name", "slug" }], "pages": [ …page summaries ] }. Use a folder's id to list inside it.

get_page

Reads one page or entry in full.

Returns the name, address, status, content type, folder, the draft's fields, blocks and SEO, the draft and published versions, and docVersion. Pass docVersion back when changing the page, so a newer change by someone else is never overwritten.

get_navigation

Reads the menus of one region and language. Takes the scope arguments.

1[2  {3    "id": "6660a3f19b1e8a0012ab3600",4    "key": "main",5    "name": "Main menu",6    "kind": "header",7    "items": [8      {9        "label": "Products",10        "kind": "content",11        "visible": true,12        "href": null,13        "page": { "id": "665f1c2e9b1e8a0012ab34cd", "name": "Products", "url": "/products", "live": true },14        "children": []15      }16    ]17  }18]

Menus for every region and language are included, as well as those made for this one. page is the page a link opens, { "id", "missing": true } when that page has been deleted, or null for a link to an address. Agents cannot change menus: a person does that under Library › Navigation, and the change is live at once, with no draft or review. When a page has no links to it, say so in the review note so a person can add it to a menu.

get_schema

No arguments. Returns every content type with its fields and allowed blocks, and every block (component) that is not deprecated, with its fields and child slots. It also gives the shape of a block:

{ id?: string, type: <component key>, fields: { <field key>: value }, children: { <slot name>: [blocks] } }

Agents should read the schema before drafting, so drafts are valid. A field with showWhen applies only while the named field holds that value, such as a button's plan only when kind is signUp; leave it out otherwise. To link to a page, a link field takes { "kind": "content", "contentId": "<page id>" }, with the id from list_pages or search_content, so the link follows the page when it moves.

Draft

create_draft

Creates a page or entry as a draft. It is never live until a person publishes it.

Returns the page summary. Landing pages, popups, banners and shop products are refused here; use draft_special_content.

The address is made from the folder and the slug, so a page named Home at the top level gets /home. Only a person can give a page another address, such as / for the home page, with URL override in the editor. To find the home page, look for the page whose url is /. See Edit a page.

update_draft

Changes a page's name, fields or blocks in its draft.

Returns the page summary and the new docVersion. If someone changed the page since it was read, nothing is saved and the answer gives the version it is now at, such as This page has changed since version 3 was read; it is now at version 4. Read the page again to see the other change, then redo yours with that version.

Field values are checked when the draft is saved, in the page's own fields and in every block: fields the type or block does not have, choices that are not on the list, and text or numbers outside their limits or pattern. Every problem is returned in one answer, such as Some fields are invalid: components[a1b2].fields.heading …, each with its path, so they can all be fixed at once. Values that were saved before and have not changed are left alone. Blocks of a type the website does not have are all named in one answer, with the types it does have. Required fields may be left empty in a draft, but the page cannot be published until they are filled.

update_seo_fields

Writes a page's meta title, description and Open Graph text to its draft. Only the SEO fields given change; give null to clear one.

Returns the page summary, the new docVersion and the draft's SEO. Entries with no website address have no SEO and are refused.

draft_special_content

Drafts the wording of landing pages (landingPage), popups (popup), banners (banner) and shop products (shopProduct): headlines, body text, FAQs, descriptions, benefits and directions.

Only wording may change. Schedules, targeting, tracking, styles, prices, codes, addresses and catalogue IDs are left to people, and existing blocks cannot be removed or turned into other blocks. A change that touches any of these is refused with a list of what was not allowed, such as Only wording can be drafted here. Background is a set-up field, not wording, so an agent cannot change it.

Returns the summary and the new docVersion.

copy_to_region

Copies pages to another region or language as linked drafts, ready to adapt.

Returns how many folders and pages were copied, and the target. The folders the pages sit in are created in the target if needed. Copies are unpublished drafts marked Drafted by AI, so they need a person's approval like any other agent draft. Adapt them with update_draft, then send them for review. The target must be writable for the agent, and must be a different region or language from the source. There is no tool for copying a page within the same language; a person does that with Duplicate in the content list.

Images

upload_media

Uploads an image into the AI uploads folder of the media library, which is created if it does not exist.

Language codes must be ones the website has, in any environment or region; list_scopes lists them. Others are refused with the codes the website has, and nothing is uploaded.

Returns the image's details, including its id to use in fields and blocks. JPEG and PNG images are converted to WebP for the website. The answer then shows the new mimeType with convertedFrom, the type that was sent, and a short note:

{ "id": "6660a3f19b1e8a0012ab3700", "filename": "hiking-boots.webp", "mimeType": "image/webp", "convertedFrom": "image/png", "note": "Converted from image/png to image/webp for the website." }

If the same image is already in the library, that one is returned instead of a copy. When it is live on pages the agent may not change, its text is left as it was and the answer says so in textNotChanged.

set_image_text

Sets an image's alt text, title or caption by language. Nothing else about the image changes.

Only the languages given change; the others are kept. An empty string or null removes that language. Language codes must be ones the website has, in any environment or region; others are refused with the codes the website has, such as "nb-NO" is not a language of this site. Use de-CH.

Images belong to the media library, not to a page's draft, and are shared by every environment: new image text is not reviewed and is used at once wherever the image appears, including published pages. So when an image is live on a page in Production and the website does not allow agent drafts there, or live in a region the agent's key may not change, the change is refused and a person makes it under Library › Media.

Checks

get_seo_issues

The SEO dashboard for one region and language: the health score and every issue grouped by type, with the pages affected. Takes the scope arguments.

run_page_checks

Runs the SEO checks and the pre-publish checks, such as missing alt text and image consent, on a page's draft. Takes id.

1{2  "seoScore": 82,3  "seoIssues": [ … ],4  "publishBlockers": [5    { "kind": "required", "path": "components[a1b2].fields.heading", "message": "…" },6    { "kind": "missing_alt", "mediaId": "6660a3f19b1e8a0012ab3700", "filename": "hiking-boots.webp", "message": "…" }7  ]8}

publishBlockers lists what stops the page being published: required for an empty required field, on the page or in a block; invalid for a saved value the schema no longer accepts; and missing_alt, missing_subtitles or consent for images and videos. Agents should fix what they can before sending a page for review: fields with update_draft, alt text with set_image_text.

Review

add_comment

Comments on a review.

submit_for_review

Sends a page's draft to the review queue with a note.

{ "reviewId": "6660a3f19b1e8a0012ab3511", "status": "pending", "steps": ["Review"] }

steps names the sign-offs the page needs, which depend on the content type and region, such as Review, and Brand when a brand block changes. A newer submission replaces an open review of the same page. While the review is open, agents cannot change the page. When the last step is approved, the page is published if the approver can publish; otherwise it waits for someone who can. A page with no unpublished changes is refused with There are no changes to review.

Tidy up

discard_draft

Moves a page or entry that the agent created through this connection to the bin, such as a test page or a draft that is no longer wanted. Landing pages, popups and banners count too.

{ "id": "665f1c2e9b1e8a0012ab34cd", "name": "Test page", "inTrash": true, "note": "Moved to the bin, exactly as if a person had deleted it. A person can restore it from the bin." }

It is refused, with the reason, when:

• another key or connection, or a person, created it
• it has ever been published, in this or any earlier state, or is scheduled to go live
• it is in review, or approved and waiting to be published
• it is in a release
• someone has it open in the editor
• a person or another connection has changed it since it was created
• the person cannot delete pages, or this type of entry, themselves
• the agent may only read where the page lives, such as Production without Allow drafts in production

A copy the agent makes with copy_to_region counts as created by it. A copy a person makes of an agent's draft does not.

discard_upload

Moves an image that the agent uploaded through this connection to the bin.

Returns the same shape as discard_draft. It is refused when the image is used anywhere: in a page's draft or live version, in a page in the bin, in an earlier published version of a page, or in the website's settings. The answer lists where, such as "hiking-boots.webp" is in use, so it cannot be discarded. It is used in: Hiking boots (staging, de). Remove it from those drafts first, or leave it for a person. It is also refused when someone else uploaded it, when a person or another connection has changed it, and when the person cannot delete files themselves. If upload_media returned an image that was already in the library, that image is not the agent's and cannot be discarded.

Typical workflows

Draft a new page

1. get_schema to learn the content types and blocks.
2. list_pages to find the folder, such as Services.
3. create_draft with the content type, name, fields, blocks and SEO.
4. run_page_checks and fix what it finds with get_page and update_draft.
5. submit_for_review with a note.

Update an existing page and send it for review

1. search_content with query: "hiking boots" to find /products/hiking-boots.
2. get_page for its fields, blocks and docVersion.
3. update_draft with the changed fields and blocks and that docVersion.
4. update_seo_fields if the title or description should change.
5. submit_for_review with what changed and why.

Find pages that need work

1. get_seo_issues for the region and language.
2. For each page affected, get_page, then update_seo_fields or update_draft.
3. submit_for_review for each page changed.

Copy and translate

1. list_scopes to find the target region and language.
2. copy_to_region with the page ids and the target.
3. search_content in the target to find the copies.
4. get_page and update_draft to translate or adapt each copy.
5. submit_for_review for each copy.

Change the wording of a banner or popup

1. search_content with contentType: "banner" or "popup".
2. get_page for its fields and docVersion.
3. draft_special_content with id, docVersion and only the text fields that change.
4. submit_for_review.

Clean up after a test

1. create_draft and upload_media as usual, for example a page named Test page and an image.
2. If the page uses the image, take it out of the page with update_draft before you discard anything: an image on a page in the bin still counts as in use.
3. discard_draft with the page id. Do not send test pages for review: a page in review cannot be discarded.
4. discard_upload with the image id.

Both go to Bin, where a person can restore them.

Limits

Errors tools return

Connection errors, such as 401, 403 and 429, are explained in Connect an AI agent over MCP.

What is recorded

• On the page and the image: the Drafted by AI mark, with the agent's name and the person it acted for, and which key or connection created a page or uploaded an image.
• In review: each review an agent sends names the agent and the person.
• In the audit log: every change an agent makes is recorded under the organisation's Audit log, with the agent shown as, for example, Claude (AI agent for Jane Doe), or Claude (AI agent for Jane Doe, signed in) for a signed-in connection, and the time, IP address and client. This covers pages created, changed, copied and discarded, images uploaded, changed and discarded, folders created, reviews sent and comments.
• Keys and settings: creating and revoking agent keys, signing in, and changing the AI agent switches are recorded too.
• On the key: Last used on Configuration › AI agents.

Reading content is not recorded.