Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
docs: clarify that all toolkits are available by default in sessions
Sushmitha Mallesh63bf1a4b4c92
diff --git a/docs/content/docs/common-faq.mdx b/docs/content/docs/common-faq.mdxindex 4d4f14b9e..10cd10448 100644--- a/docs/content/docs/common-faq.mdx+++ b/docs/content/docs/common-faq.mdx@@ -28,6 +28,38 @@ If you don't have an agent, you can [execute tools directly](/docs/tools-direct/You can browse all toolkits on the [Toolkits page](/toolkits) in the docs or in the [Composio dashboard](https://platform.composio.dev?next_page=/marketplace). Both list every supported app along with available auth schemes and tools.</Accordion>+<Accordion title="What toolkits are available by default in a session?">+All toolkits in the Composio catalog are available by default. When you create a session without specifying a `toolkits` parameter, your agent can discover and use any toolkit through `COMPOSIO_SEARCH_TOOLS`.++To restrict which toolkits are available, pass `toolkits` when creating the session:++<Tabs groupId="language" items={['Python', 'TypeScript']} persist>+<Tab value="Python">+```python+# Only GitHub and Gmail+session = composio.create(user_id="user_123", toolkits=["github", "gmail"])++# Everything except Linear and Jira+session = composio.create(user_id="user_123", toolkits={"disable": ["linear", "jira"]})+```+</Tab>+<Tab value="TypeScript">+```typescript+import { Composio } from '@composio/core';+const composio = new Composio({ apiKey: 'your_api_key' });+// ---cut---+// Only GitHub and Gmail+const session = await composio.create("user_123", { toolkits: ["github", "gmail"] });++// Everything except Linear and Jira+const session2 = await composio.create("user_123", { toolkits: { disable: ["linear", "jira"] } });+```+</Tab>+</Tabs>++You can also list the toolkits available in a session with `session.toolkits()`. See [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).+</Accordion>+<Accordion title="The tool I need doesn't exist. How do I request one?">You can request new tools or toolkits on the [tool request board](https://request.composio.dev/boards/tool-requests). The team reviews requests regularly.</Accordion>diff --git a/docs/content/docs/configuring-sessions.mdx b/docs/content/docs/configuring-sessions.mdxindex 43bcc5127..be79c7180 100644--- a/docs/content/docs/configuring-sessions.mdx+++ b/docs/content/docs/configuring-sessions.mdx@@ -22,6 +22,8 @@ const session = await composio.create("user_123");</Tab></Tabs>+By default, a session has access to **all toolkits** in the Composio catalog. Your agent can discover and use any of them through `COMPOSIO_SEARCH_TOOLS`. Use the options below to restrict or customize what's available.+## Enabling toolkitsRestrict the session to specific toolkits:diff --git a/docs/content/docs/quickstart.mdx b/docs/content/docs/quickstart.mdxindex 82bb993f1..e829cee00 100644--- a/docs/content/docs/quickstart.mdx+++ b/docs/content/docs/quickstart.mdx@@ -826,6 +826,10 @@ readline.close();</QuickstartFlow>+<Callout type="info">+By default, sessions have access to **all available toolkits** in the Composio catalog. Your agent can discover and use any of them through `COMPOSIO_SEARCH_TOOLS`. To restrict which toolkits are available, see [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).+</Callout>+## Next steps<Cards>diff --git a/docs/content/docs/tools-and-toolkits.mdx b/docs/content/docs/tools-and-toolkits.mdxindex 05ef97119..4897fdafd 100644--- a/docs/content/docs/tools-and-toolkits.mdx+++ b/docs/content/docs/tools-and-toolkits.mdx@@ -68,6 +68,16 @@ A **tool** is an individual action your agent can execute. Each tool has an inpuIf you know exactly which tools you need, you can [execute them directly](/docs/tools-direct/executing-tools) without meta tools.</Callout>+## Default toolkit access++<Accordions>+<Accordion title="What toolkits can my agent access by default?">+All of them. When you create a session without specifying a `toolkits` parameter, every toolkit in the Composio catalog is discoverable through `COMPOSIO_SEARCH_TOOLS`. The agent searches for relevant tools at runtime — it doesn't load them all into context at once.++To restrict which toolkits are available, pass `toolkits` when creating the session. See [Enable and disable toolkits](/docs/toolkits/enable-and-disable-toolkits).+</Accordion>+</Accordions>+## AuthenticationTools execute with the user's authenticated credentials. When a user connects their GitHub account, all GitHub tools run with their permissions.