diff --git a/docs/api/mcp/index.mdx b/docs/api/mcp/index.mdx
index 56e9a787d..c37047ef6 100644
--- a/docs/api/mcp/index.mdx
+++ b/docs/api/mcp/index.mdx
@@ -187,6 +187,10 @@ Perform exact keyword searches with boolean operators and filters.
 
 **Features:** Boolean AND/OR operators, regex patterns
 
+<Callout type="info">
+The `sg_keyword_search` MCP tool currently returns structured content wrapped in an extra content field. This mismatch can trigger validation errors in strict MCP clients, such as the Python MCP client. A fix is planned for a future release; for now, affected clients can manually unwrap the content field as a workaround.
+</Callout>
+
 #### `sg_nls_search`
 
 Semantic search with flexible linguistic matching.