Agents and API

What an agent or a script can do on a Libretto site: one operation registry under the admin, the MCP server and the CLI.

Updated

Start here #

Agents work on a Libretto site through the MCP server. Claude Code, Cursor, Codex and any other MCP client connect to it with a token for one site.

Using Claude Code? Follow Connect Claude to Libretto: it installs the Libretto plugin, which connects Claude Code with your token and teaches it to edit, check and publish safely.

  1. In the admin sidebar, open Persone e accessi › Agenti e accessi MCP (People & access › Agents & MCP access).
  2. Make a token: a name, the site, 30 or 90 days. Copy it: it is shown once.
  3. Set up your client. For Claude Code, install the plugin instead of the command the screen shows (Connect Claude to Libretto); for Cursor, Codex and the others, see MCP server.

The token acts for you, on that site, with your role. Revoke it on the same screen when you no longer need it.

When something blocks your agent, it reports it to the platform owner with report_issue: see Report a problem on MCP server.

The operations below are the same for every way in.

161 operations in 35 domains, 10 MCP tools and 10 CLI commands.

Operation domains

DomainOperationsPage
History operations2/agents/operations/history
Preset operations7/agents/operations/preset
Site component operations5/agents/operations/component
Effect operations3/agents/operations/effect
Catalogue operations3/agents/operations/catalog
Region operations1/agents/operations/region
Page tree operations3/agents/operations/tree
Content import operations1/agents/operations/content
Design system operations20/agents/operations/design-system
Page operations6/agents/operations/page
Navigation operations5/agents/operations/navigation
Blog operations2/agents/operations/blog
Article operations4/agents/operations/article
Media operations11/agents/operations/media
Site operations4/agents/operations/site
Access operations2/agents/operations/access
Settings operations2/agents/operations/settings
Breakpoint operations1/agents/operations/breakpoints
Layout operations1/agents/operations/layout
API configuration operations2/agents/operations/api-config
Environment operations2/agents/operations/environment
Brand operations13/agents/operations/brand
Motion operations7/agents/operations/motion
Font operations5/agents/operations/font
Publication operations6/agents/operations/publication
Collection operations5/agents/operations/collection
Collection item operations10/agents/operations/item
Form operations6/agents/operations/form
Form submission operations3/agents/operations/submission
Member operations6/agents/operations/member
Member role operations3/agents/operations/member-role
Ticket operations2/agents/operations/ticket
Domain operations4/agents/operations/domain
Maintenance operations2/agents/operations/maintenance
External effect operations2/agents/operations/external

Generated from the operation registry and the MCP tool catalogue (source b681f1b8555000d8).

Something wrong on this page? Write to docs@librettocms.com.

Libretto docs

Colophon. These docs are a Libretto site: 68 pages in two languages, 20 guide pages imported from Markdown and 41 reference pages generated from the operation registry. Set in Softcore, with code in IBM Plex Mono. Its outline:

/ Libretto docs /start Get started /start/request-access Request access /start/workspace Your workspace /start/first-site Your first site /start/invite-a-client Invite a client /start/connect-claude Connect Claude to Libretto /build Build /build/first-page Build a page /build/layers-and-canvas Layers and canvas /build/site-components Site components /design-system Design system /design-system/tokens Colours, space and themes /design-system/components Components and variants /design-system/fonts Typography and fonts /motion Motion /motion/scenes Scenes and recipes /motion/image-sequences Image sequences /motion/reduced-motion Reduced motion /publish Publish /publish/languages Site languages /publish/versions Publish and versions /publish/members-and-forms Members and forms /publish/domains Domains /handover Hand a site to a client /glossary Glossary /agents Agents and API /agents/mcp MCP server /agents/cli CLI /agents/batches Batches /agents/errors Errors and findings /agents/operations Operations /search Search