diff --git a/docs/pages/api-reference/liveblocks-client.mdx b/docs/pages/api-reference/liveblocks-client.mdx
index 8b361f48081..30409b934b1 100644
--- a/docs/pages/api-reference/liveblocks-client.mdx
+++ b/docs/pages/api-reference/liveblocks-client.mdx
@@ -874,7 +874,7 @@ const myTool = defineAiTool()({
 <Banner>
 
 Note that the function should be called like this `defineAiTool()({ ... })`
-(double-parens). This allows TypeScript’s inference to work correctly.
+(double-parens). This allows TypeScript’s inference to work correctly. For the best type inference experience, TypeScript 5.3 or higher is recommended. While Liveblocks supports TypeScript 5.0+, full type inference for `defineAiTool()` requires TypeScript 5.3+.
 
 </Banner>