Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

docs: elevate direct tools preset section

Dhawal Upadhyay6877f5983361
diff --git a/docs/content/changelog/05-07-26-toolrouter-preload-direct-tools.mdx b/docs/content/changelog/05-07-26-toolrouter-preload-direct-tools.mdx
index f5bc70803..84447e9df 100644
--- a/docs/content/changelog/05-07-26-toolrouter-preload-direct-tools.mdx
+++ b/docs/content/changelog/05-07-26-toolrouter-preload-direct-tools.mdx
@@ -4,12 +4,13 @@ description: "Sessions can now expose frequently used tools directly from sessio
date: "2026-05-07"
---
-Sessions now support preloading known tools into `session.tools()` and the
-session MCP tool list. This works for Composio-managed tools, while SDK custom
-tools can be exposed directly from `session.tools()` with `preload: true`.
+Sessions now support preloading frequently used tools into `session.tools()` and
+the session MCP tool list, so agents can call them without searching each time.
+This works for Composio-managed tools, while SDK custom tools can be exposed
+directly from `session.tools()` with `preload: true`.
-Use preloading for small, stable tool sets. Keep the preloaded set focused,
-generally fewer than 20 tools, to avoid context bloat.
+Keep the preloaded set focused, generally fewer than 20 tools, to avoid context
+bloat.
### SDK versions
diff --git a/docs/content/docs/configuring-sessions.mdx b/docs/content/docs/configuring-sessions.mdx
index 8ec9df0c9..069935819 100644
--- a/docs/content/docs/configuring-sessions.mdx
+++ b/docs/content/docs/configuring-sessions.mdx
@@ -176,7 +176,7 @@ Use the `preload.tools = "all"` shortcut (`preload={"tools": "all"}` in Python,
session filters. The `all` shorthand works for both Composio tools and SDK
custom tools.
-### Direct tools preset
+## Direct tools preset
The direct tools preset preloads every tool allowed by session filters into the
session's tool list and disables session meta tools by default. This can be