Changelog#
1.0.0a4 (2026-11-01)#
New features:#
Bug fixes:#
The MCP instructions and the skill now tell a model to create a
Documentfor a section, becauseFolderusually cannot be added. @ericof #26
Internal:#
Checked the links to the sample data script and to PyPI, now that both exist. @ericof
Documentation:#
Rewrote the documentation for newcomers: a landing page with three paths, tutorials that end in a real result, an example for every service, a safety page for assistants, a glossary, and a troubleshooting guide. Commands and transcripts now run against a real site, with
make docs-check. @ericof #26
1.0.0a3 (2026-10-30)#
New features:#
Added MCP resources to the MCP server: the site root, content items, content types and their schemas, and the blocks of the site, at
plone://<site>/...URIs.--toollimits them too. @ericof #24
Bug fixes:#
Fixed
client.block_typesand theblock_typestool failing with a401once the token expired: the client now logs in again and repeats the request. The documentation now names Volto 19.6.0 as the first release with@blocks-schema, and the integration tests run against a real Volto server. @ericof #23
1.0.0a2 (2026-10-28)#
New features:#
Added a
portal_typeargument to thecreate_pageMCP tool, so a page can be created as a content type with blocks other thanDocument. @ericof #12Added a warning when a profile’s credentials are rejected: a profile with a username or token that the site answers as anonymous now makes
plone-client mcpwarn at startup,site_inforeportcredentials_rejected, andinfoandprofile testreport it with exit code 4, with the command that fixes the secret. @ericof #13Added
filesandlead_imagetocreate_page, in the operation, the MCP tool and thecreate-pagecommand (--file,--lead,--no-lead), so a page can carry uploaded files and a lead image, stored the way the type expects. @ericof #14Added MCP tools for services the client already wrapped:
get_workflowlists the transitions an item can run now,get_vocabularyreturns the valid values of a choice field,get_translations,link_translation, andunlink_translationmanage translations, andget_working_copy,check_out,check_in, andcancel_working_copymanage working copies. @ericof #17Added the
--tooloption toplone-client mcp, which offers only the tools named, so the model reads a shorter list of tools. A tool the server would not offer, such as a misspelled one or a tool that changes a read-only site, stops the command with exit code 3. @ericof #17Added MCP tools to edit the blocks of a page without resending all of them:
list_blocksshows their ids and types,add_blocksinserts blocks after a given block or at a position,update_blockchanges one block,remove_blocksdeletes blocks, andset_blocksreplaces them while keeping the title and description blocks. They also work on blocks inside grids and other containers. Blocks can now be given as a list, each with an@type, to these tools and tocreate_contentandupdate_content: ids and the layout are made for you, a stringhrefbecomes a list of links, and a block without@typeis refused before anything is sent. The same steps are in the library asoperations.add_blocks,update_block,remove_blocks, andset_blocks, with the helpersblocks.normalize,tidy,locate,outline, andprepare. @ericof #17Added
plone-client mcp --http, which serves the MCP server over streamable HTTP for assistants that connect to a URL. Every request needs a bearer token, made withplone-client mcp-token generateand kept in the keyring, or given inPLONE_CLIENT_MCP_TOKEN. The server listens on127.0.0.1:8000unless given--hostand--port, and the sites’ own credentials stay in its profiles. @ericof #18Added a choice of the block types that Markdown and HTML become, such as code blocks or tables as text: a
blockstable in a profile sets them for a site, and--blocksoncreate-pageandupload-tree, theblocksargument of the MCP toolscreate_pageandupload_tree, orblocks_settingin Python changes them for one call. An unknown block type or option is refused before any request is sent. Themarkdownextra now needscollective.html2blocks1.0.0b1 or later. @ericof #20
Bug fixes:#
The MCP tools
run_transition,move_content, andcall_serviceno longer tell clients that they are idempotent: running them twice does not give the same result, so clients should not retry them on their own. @ericof #17MCP tools that work on the same site now run one at a time. Assistants that call several tools at once could mix the requests that two operations reported, or lose a block edit made at the same moment. @ericof
1.0.0a1 (2026-10-27)#
Breaking changes:#
Rewrote the client on
httpx: onePloneClientper site, with the managers as attributes and paths, site URLs,uid:<UID>andresolveuidlinks accepted wherever an item is expected.AsyncPloneClient,PloneClientConfigand the methods for services thatplone.restapidoes not provide were removed, and Python 3.11 is now the minimum. @ericof
New features:#
Added
plone_client.operations, tasks that send several requests in the right order: create an item with files and images inside it and set its lead image, create a page from Markdown or HTML, upload a local folder keeping its structure, and copy or move items with a report. Each operation honorsdry_runandread_only, returns every request it sent, and raisesPloneOperationErrorwith what was already created when it stops part way. The commandscreate-page,create-with-files, andupload-treerun them from the command line. @ericof #9Added an MCP server,
plone-client mcp, in the newmcpextra: it serves the selected profile over standard input and output, or several sites at once with--site,--group, or--all, offering the everyday reads, the high-level operations, and one tool for any otherplone.restapiservice; changes to read-only profiles are refused. Profiles can now be gathered into named groups in the configuration file, managed withplone-client profile groups,group-set, andgroup-remove. @ericof #9Added
blocks.block,blocks.container,blocks.grid, andblocks.teaser, to build blocks of any type, including add-on blocks and blocks that hold others, such as a grid of four teasers.blocks.textnow builds its paragraph withcollective.html2blockswhen themarkdownextra is installed, and collapses runs of whitespace either way. @ericof #9Added
client.block_typesand theblock-typescommand, which list the blocks of a Volto site and describe their data from the@blocks-schemaservice of the Volto server, reached through the newfrontend_urlsetting. Sites without that service get the documentation of Volto’s core blocks instead. The newmarkdownextra converts Markdown and HTML to blocks withcollective.html2blocks, on Python 3.12 or later. @ericof #9Added
plone_client.blocks, helpers to build Volto blocks and to walk them and their links. @ericofAdded
read_onlyanddry_runmodes toPloneClient, so a script can refuse or preview every change it would make to a site. @ericofAdded an agent skill that teaches coding agents such as Claude Code to work with Plone sites through the command line, installed with
plone-client skill install. @ericofAdded named connection profiles to work with several sites, with passwords kept in the operating system keyring, an environment variable or a command such as a password manager, read-only profiles, a
.plone-client.tomlfile that selects the profile of a project, and timeout, retry, and TLS settings per profile or shared by all of them, including a custom CA bundle. @ericofAdded the
plone-clientcommand line, installed with thecliextra: read, search, create, change, publish, move, upload and download content, and manage users, groups, the registry and aliases, with JSON output and exit codes meant for scripts and agents. @ericofGrouped the command line help into panels: commands that read, change, or upload content, site administration, advanced requests, and configuration; each command group splits its subcommands into Browse and Write panels. In a terminal the panels are drawn as boxes; when the output goes to a pipe or a file, as for coding agents, the help is plain text with the same groups. @ericof
Bug fixes:#
Fixed the requests for copying, moving and ordering content, changing the registry, group membership, undoing transactions and uploading files with TUS, which did not match what
plone.restapiexpects. @ericof
Internal:#
Added a
make releasecommand that releases the package with zest.releaser and publishes it with uv. @ericofLicensed the package under the GPLv2, like Plone. @ericof
Moved continuous integration and linting to
uvandmaketargets, and added the towncrier change log check and Dependabot. @ericofUpdated locked dependencies with security fixes: anyio, certifi, idna, Pygments, requests, soupsieve, and urllib3. @ericof
Documentation:#
Documented the MCP server, the high-level operations, and the block types: how to connect an assistant, how to create content in one step, how to build any block, a reference of the MCP tools, and an explanation of when to use the MCP server, the command line, or the agent skill. @ericof #9
Fixed the links to the
plone.restapidocumentation. @ericofRewrote the documentation following the Plone documentation style and the Diátaxis framework, with the Plone Sphinx theme: tutorials, how-to guides with runnable examples, reference including a compatibility grid with Plone and
plone.restapiversions and a map to the functions of@plone/client, and explanation. @ericof
Tests#
Added unit tests that check every request against the
plone.restapidocumentation, and integration tests against Plone 6.0, 6.1, and 6.2 in Docker. @ericofFixed the agent skill tests on Windows, where paths use backslashes and the home directory comes from
USERPROFILE. @ericof