This is an automated email from the ASF dual-hosted git repository.
Croway pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 6a8c9919d604 CAMEL-26782: Upgrade guide - camel-ai-tool-starter MCP
hints in 4.22.3
6a8c9919d604 is described below
commit 6a8c9919d604a1f1906b6d71490525e861638d15
Author: croway <[email protected]>
AuthorDate: Thu Nov 12 12:10:48 2026 +0100
CAMEL-26782: Upgrade guide - camel-ai-tool-starter MCP hints in 4.22.3
From 4.22.3 the camel-ai-tool-starter no longer publishes MCP hints a tool
does not set as false (apache/camel-spring-boot#2086). Note what this means
for MCP clients and how to keep advertising a hint.
---
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
index 319d126ce652..b7790ca6a050 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
@@ -31,6 +31,18 @@ now reject the invocation before the tool route runs.
Previously, these argument
required-argument check and then be discarded by the reserved-name filter,
leaving the route without
a required value. Rename these parameters and update their `parameter.*` or
`argSchema` declarations.
+=== camel-ai-tool-starter - MCP hints that are not configured are no longer
published
+
+With `camel-ai-tool-starter`, a tool whose route sets none of the MCP hints
`readOnlyHint`, `destructiveHint`,
+`idempotentHint` and `openWorldHint` was published with each of them set to
`false`, because the starter copied the
+documented default `false` onto the component. These hints, and
`returnDirect`, are now left unset unless they are
+configured, so the MCP `tools/list` response omits them, as it does without
Spring Boot.
+
+Under the MCP specification an omitted `destructiveHint` or `openWorldHint`
means `true`, so an MCP client may now
+treat such a tool as destructive and open-world. To keep advertising a tool as
read-only or non-destructive, configure
+the hint on the endpoint, for example `ai-tool:myTool?destructiveHint=false`,
or for all tools with
+`camel.component.ai-tool.destructive-hint=false`.
+
=== camel-as2 - server/listen - signature and MIC over the message as received
The signature of a `multipart/signed` message is now verified over the signed
part exactly as it was received, its
