diff --git a/CHANGELOG.md b/CHANGELOG.md index e17a324..ff04c9d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +## [2.18.1] - 2026-11-12 + +### Changed + +- The MCP `create_note` tool says that articles live at `/article/` with a slug made from the title, so AI clients leave `slug` out unless they want a specific one + ## [2.18.0] - 2026-11-12 A tidier admin area. diff --git a/docs/design/v2.18.1/2026-11-12-mcp-slug-docs.md b/docs/design/v2.18.1/2026-11-12-mcp-slug-docs.md new file mode 100644 index 0000000..22713c0 --- /dev/null +++ b/docs/design/v2.18.1/2026-11-12-mcp-slug-docs.md @@ -0,0 +1,9 @@ +# v2.18.1: MCP create_note describes article URLs and slugs + +Documentation-only follow-up to ADR-077 (v2.17.x). The MCP `create_note` +tool description now says that a title makes the post an article at +`/article/`, that articles get their slug from the title and other +notes from the time, and that `slug` is only needed for a specific slug. +AI clients read tool descriptions to decide which arguments to send, so +this keeps them from making up a slug the title would already give. +No behaviour change. diff --git a/starpunk/__init__.py b/starpunk/__init__.py index 0536eeb..07c24fe 100644 --- a/starpunk/__init__.py +++ b/starpunk/__init__.py @@ -468,5 +468,5 @@ def create_app(config=None): # Package version (Semantic Versioning 2.0.0) # See docs/standards/versioning-strategy.md for details -__version__ = "2.18.0" -__version_info__ = (2, 18, 0) +__version__ = "2.18.1" +__version_info__ = (2, 18, 1) diff --git a/starpunk/mcp_server/tools.py b/starpunk/mcp_server/tools.py index 3180c94..fe7fb5b 100644 --- a/starpunk/mcp_server/tools.py +++ b/starpunk/mcp_server/tools.py @@ -232,9 +232,11 @@ def register_tools(server: MCPServer, app: Flask) -> None: ) -> dict: """Create a note (Markdown). It is a draft unless draft is false; publishing makes it public and crossposts it to the syndicate_to - targets. A title makes it an article; summary is its short summary, - shown on the homepage and in feeds and crossposts. At most one of like_of, - repost_of and bookmark_of. published_at is an ISO 8601 date.""" + targets. A title makes it an article, at /article/; summary is its + short summary, shown on the homepage and in feeds and crossposts. The + slug is made from the title for articles and from the time for other + notes, so leave slug out unless a specific one is wanted. At most one of + like_of, repost_of and bookmark_of. published_at is an ISO 8601 date.""" info = _token_info() _require(info, "create", "draft")