MCP: website content (CMS)
Five tools on the MCP server at https://api.erreos.com/mcp read and edit a workspace’s website content in the CMS. Call list_workspaces first and use a workspace whose areas include site.
Access
Section titled “Access”A call needs all three:
- A credential holding the tool’s scope:
cms:readfor the three reads,cms:writefor the two writes. It is one of:- An OAuth grant, when a person connects Claude or ChatGPT and allows “See your website content” or “Edit and publish your website content” on the consent screen. See Connect Claude and ChatGPT.
- An
erre_mk_key, issued from the command line by the Erre OS team for an agency agent. On that key,content:readandcontent:writeare the social planner’s tools, not the CMS.
- The person behind the credential has joined the workspace named by
workspace. - Their role reaches the CMS: owners and admins always, anyone else through the CMS permission on their role. Writes also need the workspace’s plan to include the CMS.
| Tool | Scope | Hint | Does |
|---|---|---|---|
list_site_collections |
cms:read |
read-only | collection keys, labels, fields (type, required, options, items) |
list_site_entries |
cms:read |
read-only | entries by status (default published), title search, cursor |
get_site_entry |
cms:read |
read-only | draft and live state by id or slug, body as Markdown, revision |
save_site_entry_draft |
cms:write |
not destructive | create a draft, or change one; never touches the live site |
publish_site_entry |
cms:write |
destructive | put the draft on the site, same rules as the Publish button |
Rules worth knowing
Section titled “Rules worth knowing”- Read before you write. Changing an existing entry needs the
revisionfromget_site_entry. If anyone saved or published since, the save is refused and the agent reads again. fieldsis a patch. Only the keys sent change;nullclears one. Values are tagged the wayget_site_entryreturns them, for example{"type":"text","value":"…"}.- No media. Image, file and gallery values can be kept or cleared, not pointed at a new URL. Uploads stay in Erre OS.
- Publish is the app’s publish. A required field that is empty refuses it, and so does a slug another live entry serves.
- A value that does not fit its field is refused. Most refusals come back as a sentence naming the field; one caught by the argument validator comes back as “Tool execution failed”, because the gateway hides validator detail.