@devries-cameron20 / composio Mirror · read-only / commits / 9e6d118f2
Fork 0

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

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 22, 13:15 UTC

docs: update welcome page cards and terminology fixes

- Add "How tools work" card linking to tools-and-toolkits concept - Move Authentication to Features section - Update "tool router" terminology to "session" across docs Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Sushmithamallesh committed Jan 26, 2026 at 18:52 UTC 9e6d118f27d000d22b2a8446b4f44874e0ecd7ee
9 files changed +31 -25
docs/content/docs/authenticating-users/in-chat-authentication.mdx
+1 -1
@@ -129,7 +129,7 @@ const composio = new Composio({ provider: new OpenAIAgentsProvider() });
129
130 // Unique identifier of the user
131 const userId = "user_123";
132 -// Create a tool router session for the user
132 +// Create a session for the user
133 const session = await composio.create(userId);
134 const tools = await session.tools();
135
docs/content/docs/authenticating-users/manually-authenticating.mdx
+1 -1
@@ -81,7 +81,7 @@ toolkits.items.forEach((toolkit) => {
81
82 ## Disabling in-chat auth
83
84 -By default, Tool Router includes the `COMPOSIO_MANAGE_CONNECTIONS` meta-tool that prompts users to authenticate during chat. To disable this and handle auth entirely in your UI:
84 +By default, sessions include the `COMPOSIO_MANAGE_CONNECTIONS` meta-tool that prompts users to authenticate during chat. To disable this and handle auth entirely in your UI:
85
86 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
87 <Tab value="Python">
docs/content/docs/debugging-info.mdx
+3 -3
@@ -28,14 +28,14 @@ The identifiers with `pr_` (project) and `ok_` (organization) prefixes let us qu
28
29 ## Getting Help
30
31 -import { MessageCircle, Github, Bug, Mail } from 'lucide-react';
31 +import { MessageCircle, Bug, Mail, Grip } from 'lucide-react';
32
33 <Cards>
34 <Card title="Join Discord" href="https://discord.gg/composio" icon={<MessageCircle />}>
35 Get basic support from the community and Composio team
36 </Card>
37 - <Card title="GitHub Discussions" href="https://github.com/ComposioHQ/composio/discussions" icon={<Github />}>
38 - Request new tools and share feedback
37 + <Card title="Request Tools" href="https://request.composio.dev" icon={<Grip />}>
38 + Request new tools and toolkits
39 </Card>
40 <Card title="File an Issue" href="https://github.com/ComposioHQ/composio/issues" icon={<Bug />}>
41 Report SDK issues and bugs
docs/content/docs/index.mdx
+12 -6
@@ -19,18 +19,18 @@ Composio powers 800+ toolkits, tool search, context management, authentication,
19 href="https://platform.composio.dev/auth?next_page=%2Ftool-router"
20 description="Try Composio in your browser"
21 />
22 + <Card
23 + icon={<BookOpen />}
24 + title="How tools work"
25 + href="/docs/tools-and-toolkits"
26 + description="Meta tools, context management, and execution"
27 + />
28 <Card
29 icon={<Wrench />}
30 title="Toolkits"
31 href="/toolkits"
32 description="Browse 800+ integrations"
33 />
28 - <Card
29 - icon={<Key />}
30 - title="Authentication"
31 - href="/docs/authentication"
32 - description="OAuth, API keys, and custom auth flows"
33 - />
34 </Cards>
35
36 ## For AI tools
@@ -60,6 +60,12 @@ Composio works with any AI framework. Pick your preferred SDK:
60 ## Features
61
62 <Cards>
63 + <Card
64 + icon={<Key />}
65 + title="Authentication"
66 + href="/docs/authentication"
67 + description="OAuth, API keys, and custom auth flows"
68 + />
69 <Card
70 icon={<Zap />}
71 title="Triggers"
docs/content/docs/managing-multiple-connected-accounts.mdx
+2 -2
@@ -10,7 +10,7 @@ Users can connect multiple accounts for the same toolkit (e.g., personal and wor
10
11 When multiple accounts are connected for the same toolkit:
12 - Each session can only use **one account per toolkit** at a time
13 -- Tool Router uses the **most recently connected account** by default
13 +- Sessions use the **most recently connected account** by default
14 - You can override this by explicitly selecting an account
15 - Each account maintains its own authentication and permissions
16
@@ -64,7 +64,7 @@ Store the account IDs returned after connection to explicitly select accounts la
64
65 ## Selecting a specific account for a session
66
67 -Each Tool Router session can only use one account per toolkit at a time. To use a specific account in a session, pass it in the session config:
67 +Each session can only use one account per toolkit at a time. To use a specific account in a session, pass it in the session config:
68
69 <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
70 <Tab value="Python">
docs/content/docs/providers/vercel.mdx
+6 -6
@@ -10,7 +10,7 @@ The Vercel provider for Composio formats the Composio tools and adds this `execu
10
11 ## Usage with Tools
12
13 -Use Composio Tool Router as a native tool with the Vercel AI SDK.
13 +Use Composio as a native tool with the Vercel AI SDK.
14
15 ### Installation
16
@@ -20,7 +20,7 @@ npm install @composio/core @composio/vercel ai @ai-sdk/anthropic
20
21 ### Usage
22
23 -Create a Tool Router session and use it as a native tool with Vercel AI SDK:
23 +Create a session and use it as a native tool with Vercel AI SDK:
24
25 <Callout type="info">
26 - Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).
@@ -71,7 +71,7 @@ console.log("Tip: If prompted to authenticate, complete the auth flow and run ag
71
72 ## Usage with MCP
73
74 -Use Composio Tool Router with the Vercel AI SDK for a fully managed MCP experience.
74 +Use Composio with the Vercel AI SDK for a fully managed MCP experience.
75
76 ### Installation
77
@@ -81,7 +81,7 @@ npm install dotenv @composio/core ai @ai-sdk/anthropic @ai-sdk/mcp
81
82 ### Usage
83
84 -Use Tool Router with Vercel AI SDK's `streamText` for completions:
84 +Use Composio with Vercel AI SDK's `streamText` for completions:
85
86 <Callout type="info">
87 - Set `COMPOSIO_API_KEY` environment variable with your API key from [Settings](https://platform.composio.dev/?next_page=/settings).
@@ -102,10 +102,10 @@ const composio = new Composio();
102 // Unique identifier of the user
103 const userId = "user_123";
104
105 -// Create a tool router session for the user
105 +// Create a session for the user
106 const { mcp } = await composio.create(userId);
107
108 -// Create an MCP client to connect to the Composio tool router
108 +// Create an MCP client to connect to the Composio MCP server
109 const client = await createMCPClient({
110 transport: {
111 type: "http",
docs/content/docs/single-toolkit-mcp.mdx
+2 -2
@@ -5,7 +5,7 @@ keywords: [mcp, model context protocol, single toolkit]
5 ---
6
7 <Callout type="info">
8 -For most use cases, we recommend using [Tool Router](/docs/quickstart). Tool Router provides dynamic tool access and a much better MCP experience with context management handled by us.
8 +For most use cases, we recommend using the [quickstart](/docs/quickstart). This provides dynamic tool access and a much better MCP experience with context management handled by us.
9 </Callout>
10
11 ## Install the SDK
@@ -318,6 +318,6 @@ if (result.deleted) {
318 Use with Anthropic, OpenAI, and other frameworks
319 </Card>
320 <Card title="Quickstart" href="/docs/quickstart">
321 - Build an agent with Tool Router (recommended)
321 + Build an agent (recommended)
322 </Card>
323 </Cards>
docs/content/docs/using-custom-auth-configuration.mdx
+3 -3
@@ -4,7 +4,7 @@ description: Set up auth configs for toolkits without Composio managed authentic
4 keywords: [custom credentials, no managed auth]
5 ---
6
7 -Some toolkits don't have Composio managed authentication and require you to provide your own credentials. When Tool Router tries to use these toolkits, it will throw an error asking you to create an auth config.
7 +Some toolkits don't have Composio managed authentication and require you to provide your own credentials. When sessions try to use these toolkits, an error will be thrown asking you to create an auth config.
8
9 <Steps>
10 <Step>
@@ -31,7 +31,7 @@ For detailed instructions on getting credentials for specific toolkits, see [Cus
31 </Step>
32
33 <Step>
34 -### Use in Tool Router
34 +### Use in your session
35
36 Pass your auth config ID when creating a session:
37
@@ -60,6 +60,6 @@ const session = await composio.create("user_123", {
60 </Tab>
61 </Tabs>
62
63 -Tool Router will now use your auth config when users connect to this toolkit.
63 +Your session will now use this auth config when users connect to this toolkit.
64 </Step>
65 </Steps>
docs/content/docs/white-labeling-authentication.mdx
+1 -1
@@ -43,7 +43,7 @@ For detailed instructions with screenshots, see [Custom auth configs](/docs/cust
43 </Step>
44
45 <Step>
46 -### Use in Tool Router
46 +### Use in your session
47
48 Pass your auth config ID in the session:
49