Skip to content

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.

A call needs all three:

  1. A credential holding the tool’s scope: cms:read for the three reads, cms:write for 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:read and content:write are the social planner’s tools, not the CMS.
  2. The person behind the credential has joined the workspace named by workspace.
  3. 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
  • Read before you write. Changing an existing entry needs the revision from get_site_entry. If anyone saved or published since, the save is refused and the agent reads again.
  • fields is a patch. Only the keys sent change; null clears one. Values are tagged the way get_site_entry returns 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.