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.

toolrouter

Sushmithamalleshefe7ad87af47
diff --git a/fern/pages/src/tool-router/authentication-flows.mdx b/fern/pages/src/tool-router/authentication-flows.mdx
new file mode 100644
index 000000000..406dccf1e
--- /dev/null
+++ b/fern/pages/src/tool-router/authentication-flows.mdx
@@ -0,0 +1,10 @@
+---
+title: Authentication Flows
+image: "https://og.composio.dev/api/og?title=Authentication Flows"
+description: "Master in-chat and programmatic authentication patterns for production-ready Tool Router applications."
+keywords: "authentication, oauth, in-chat auth, programmatic auth, session authorize, callback urls"
+subtitle: "Production-ready authentication patterns"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/framework-examples.mdx b/fern/pages/src/tool-router/framework-examples.mdx
new file mode 100644
index 000000000..fb8823883
--- /dev/null
+++ b/fern/pages/src/tool-router/framework-examples.mdx
@@ -0,0 +1,10 @@
+---
+title: Framework Examples
+image: "https://og.composio.dev/api/og?title=Framework Examples"
+description: "Integration examples for OpenAI, Anthropic, Vercel AI SDK, LangChain, and other popular frameworks."
+keywords: "framework examples, openai integration, anthropic, vercel ai, langchain, crewai, mastra"
+subtitle: "Real-world examples for every major AI framework"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/mcp-integration.mdx b/fern/pages/src/tool-router/mcp-integration.mdx
new file mode 100644
index 000000000..eb2c908b4
--- /dev/null
+++ b/fern/pages/src/tool-router/mcp-integration.mdx
@@ -0,0 +1,10 @@
+---
+title: MCP Integration
+image: "https://og.composio.dev/api/og?title=MCP Integration"
+description: "Universal compatibility with Claude Desktop, Continue.dev, and any MCP client through Tool Router."
+keywords: "mcp integration, claude desktop, continue dev, mcp server, universal compatibility"
+subtitle: "Framework-agnostic integration via Model Context Protocol"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/meta-tools.mdx b/fern/pages/src/tool-router/meta-tools.mdx
new file mode 100644
index 000000000..480d5c153
--- /dev/null
+++ b/fern/pages/src/tool-router/meta-tools.mdx
@@ -0,0 +1,10 @@
+---
+title: Meta-Tools
+image: "https://og.composio.dev/api/og?title=Tool Router Meta-Tools"
+description: "Discover the 4 intelligent meta-tools: SEARCH_TOOLS, EXECUTE, WORKBENCH, and MANAGE_CONNECTIONS."
+keywords: "meta-tools, search tools, execute tools, workbench, manage connections, tool router"
+subtitle: "Four meta-tools to rule them all"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/native-sdk.mdx b/fern/pages/src/tool-router/native-sdk.mdx
new file mode 100644
index 000000000..49914bb2f
--- /dev/null
+++ b/fern/pages/src/tool-router/native-sdk.mdx
@@ -0,0 +1,10 @@
+---
+title: Native SDK
+image: "https://og.composio.dev/api/og?title=Native SDK Integration"
+description: "Production features including file upload/download, execution hooks, and performance optimization."
+keywords: "native sdk, typescript sdk, python sdk, file upload, execution hooks, production features"
+subtitle: "Direct SDK integration for production applications"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/overview.mdx b/fern/pages/src/tool-router/overview.mdx
new file mode 100644
index 000000000..af89338e6
--- /dev/null
+++ b/fern/pages/src/tool-router/overview.mdx
@@ -0,0 +1,8 @@
+---
+title: Tool Router
+image: "https://og.composio.dev/api/og?title=Tool%20Router"
+description: ""
+keywords: ""
+subtitle: ""
+hide-nav-links: false
+---
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/permissions.mdx b/fern/pages/src/tool-router/permissions.mdx
new file mode 100644
index 000000000..58c387c71
--- /dev/null
+++ b/fern/pages/src/tool-router/permissions.mdx
@@ -0,0 +1,10 @@
+---
+title: Permissions
+image: "https://og.composio.dev/api/og?title=Tool Router Permissions"
+description: "Control read/write permissions and action-level blocking for enterprise-grade security."
+keywords: "permissions, security, read-only mode, write permissions, action blocking, enterprise security"
+subtitle: "Fine-grained control over tool access and actions"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/quick-start.mdx b/fern/pages/src/tool-router/quick-start.mdx
deleted file mode 100644
index e0cacfdfc..000000000
--- a/fern/pages/src/tool-router/quick-start.mdx
+++ /dev/null
@@ -1,240 +0,0 @@
----
-title: Tool Router Quick Start
-image: "https://og.composio.dev/api/og?title=Tool%20Router%20Quick%20Start" # image for socials
-keywords: ''
-subtitle: 'Learn how to use tool router to route tool calls to the correct tool.'
-hide-nav-links: false
----
-
-
-Tool Router automatically discovers, authenticates, and executes the right tools for any task. It's an experimental feature that handles the entire workflow—from finding relevant tools across 500+ integrations to managing authentication and parallel execution.
-
-This is what powers complex agentic products like [Rube](https://rube.app).
-
-## Quick start
-
-<Steps toc={true}>
- <Step title="Install SDKs">
- Install the Composio SDK and OpenAI Agents SDK:
-
- <CodeGroup>
-
- ```bash Python
- pip install composio_openai_agents openai-agents
- ```
-
- ```bash TypeScript
- pnpm install @composio/core @composio/openai-agents @openai/agents
- ```
-
- </CodeGroup>
-
- Get your Composio API key from [settings](https://platform.composio.dev/?next_page=/settings) and set it as an environment variable:
-
- ```bash
- export COMPOSIO_API_KEY="your-api-key"
- ```
- </Step>
-
- <Step title="Create Tool Router session">
- Initialize Composio and create a session for your user:
-
- <Tip icon="info">
- **Authentication is handled automatically**
-
- Tool Router provides auth URLs when needed. For production, consider [pre-configuring authentication](/docs/authenticating-tools).
- </Tip>
-
- <CodeGroup>
-
- <SnippetCode
- src="fern/snippets/tool-router/python/quickstart.py"
- startLine={1}
- endLine={16}
- title="Python"
- />
-
- <SnippetCode
- src="fern/snippets/tool-router/typescript/quickstart.ts"
- startLine={1}
- endLine={18}
- title="TypeScript"
- />
-
- </CodeGroup>
-
- This generates a secure MCP endpoint URL that your AI agent will use to access Tool Router.
-
- <Tip icon="info">
- **What are sessions?**
-
- Sessions are designed for security. Each presigned URL contains user authentication credentials and should never be stored long-term or exposed to the client. Generate a new URL for each conversation.
- </Tip>
- </Step>
-
- <Step title="Set up your agent">
- Configure an OpenAI agent with the Tool Router MCP endpoint:
-
- <CodeGroup>
-
- <SnippetCode
- src="fern/snippets/tool-router/python/quickstart.py"
- startLine={17}
- endLine={33}
- title="Python"
- />
-
- <SnippetCode
- src="fern/snippets/tool-router/typescript/quickstart.ts"
- startLine={20}
- endLine={30}
- title="TypeScript"
- />
-
- </CodeGroup>
- </Step>
-
- <Step title="Run your agent">
- Execute the agent with a task:
-
- <CodeGroup>
-
- <SnippetCode
- src="fern/snippets/tool-router/python/quickstart.py"
- startLine={34}
- endLine={42}
- title="Python"
- />
-
- <SnippetCode
- src="fern/snippets/tool-router/typescript/quickstart.ts"
- startLine={32}
- endLine={41}
- title="TypeScript"
- />
-
- </CodeGroup>
- </Step>
-</Steps>
-
-### Visualizing Tool Router in MCP Inspector
-
-You can inspect the session URL in any MCP client. Here's what it looks like in the MCP Inspector:
-
-<Frame>
- <img src="../../../assets/images/tool-router/inspector.jpeg" alt="Tool Router Inspector" />
-</Frame>
-
-## How Tool Router works
-
-The Tool Router executes a three-phase workflow:
-
-**1. Discovery**
-Searches across all available tools to find ones matching your task. Returns relevant toolkits with their descriptions, schemas, and connection status.
-
-**2. Authentication**
-Checks if the user has an active connection to the required toolkit. If not, creates an auth config and returns a connection URL using [Auth Link](/docs/authenticating-tools#hosted-authentication-connect-link). The user completes authentication through this link.
-
-**3. Execution**
-Loads authenticated tools into context and executes them. Supports parallel execution across multiple tools for efficiency.
-
-These phases are orchestrated through a set of meta tools, which handle search, planning, connection management, execution, and remote workbench.
-
-<Warning>
-**Experimental Feature**
-
-Tool Router is under active development. The meta tools, their schemas, parameters, and behaviors are subject to change as we iterate and improve the functionality. We recommend not using these tools individually.
-</Warning>
-
-## Works with any MCP client
-
-The session URL you created is a standard MCP endpoint. Use it with any framework that supports MCP:
-
-<Info>
-Tool Router uses Streamable HTTP transport for MCP communication. Make sure your MCP client supports HTTP transport (most do).
-</Info>
-
-<CardGroup cols={2}>
- <Card
- title="Vercel AI SDK"
- icon={<img src="../../../assets/images/vercel-logo.svg" width="24" height="24" />}
- href="https://ai-sdk.dev/cookbook/next/mcp-tools#mcp-tools"
- >
- Use experimental_createMCPClient with StreamableHTTPClientTransport to integrate with Next.js apps
- </Card>
- <Card
- title="Claude"
- icon={<img src="../../../assets/images/anthropic-logo.svg" width="24" height="24" />}
- href="https://docs.claude.com/en/docs/agents-and-tools/remote-mcp-servers"
- >
- Connect remote MCP servers through Anthropic's MCP connector API
- </Card>
- <Card
- title="LangChain"
- icon={<img src="../../../assets/images/langgraph-logo.svg" width="24" height="24" />}
- href="https://docs.langchain.com/oss/python/langchain/mcp"
- >
- Load Tool Router tools using langchain_mcp_adapters for Python workflows
- </Card>
-</CardGroup>
-
-<Note>
-The necessary scaffolding will be integrated into existing provider abstractions before Tool Router is generally available.
-</Note>
-
-## Customization
-
-### Restricting toolkits
-
-Control which toolkits are available by specifying them during session creation. This limits which apps your users can access.
-
-<CodeGroup>
-```python
-session = composio.experimental.tool_router.create_session(
- user_id="[email protected]",
- toolkits=["github", "slack", "gmail"]
-)
-```
-
-```typescript
-const session = await composio.experimental.toolRouter.createSession(
- {
- toolkits: ["github", "slack", "gmail"]
- }
-);
-```
-</CodeGroup>
-
-
-### Manual connection management
-
-For advanced use cases, you can manually manage connections:
-
-<CodeGroup>
-```python
-session = composio.experimental.tool_router.create_session(
- user_id="[email protected]",
- toolkits=[{"toolkit": "gmail", "auth_config_id": "ac_nnn"}],
- manually_manage_connections=True
-)
-```
-
-```typescript
-const session = await composio.experimental.toolRouter.createSession(
- {
- toolkits: [{ toolkit: 'gmail', authConfigId: 'ac_nnn' }],
- manuallyManageConnections: true
- }
-);
-```
-</CodeGroup>
-
-When you pass the auth config ID, you can use regular Composio functions to connect accounts and check authentication status.
-
-## Feedback
-
-This is still very experimental and work in progress, and you can expect the contracts to change and improve as we iterate on this. That said, we would love to hear your feedback on this.
-
-Give us feedback on this GitHub discussion [here](https://github.com/ComposioHQ/composio/discussions/2011).
diff --git a/fern/pages/src/tool-router/quickstart.mdx b/fern/pages/src/tool-router/quickstart.mdx
new file mode 100644
index 000000000..48b7383d9
--- /dev/null
+++ b/fern/pages/src/tool-router/quickstart.mdx
@@ -0,0 +1,10 @@
+---
+title: Quickstart
+image: "https://og.composio.dev/api/og?title=Tool Router Quickstart"
+description: "Get started with Tool Router in 5 minutes. Build an email analyzer that works with both MCP and Native SDK."
+keywords: "tool router quickstart, composio quickstart, mcp integration, native sdk, email analyzer"
+subtitle: "Build your first Tool Router application in 5 minutes"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/sessions.mdx b/fern/pages/src/tool-router/sessions.mdx
new file mode 100644
index 000000000..961b32997
--- /dev/null
+++ b/fern/pages/src/tool-router/sessions.mdx
@@ -0,0 +1,10 @@
+---
+title: Sessions
+image: "https://og.composio.dev/api/og?title=Tool Router Sessions"
+description: "Learn about ephemeral, user-scoped execution contexts that power Tool Router's intelligent orchestration."
+keywords: "tool router sessions, ephemeral sessions, user context, execution environment, session management"
+subtitle: "Ephemeral, isolated execution contexts for your AI agents"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/toolkit-management.mdx b/fern/pages/src/tool-router/toolkit-management.mdx
new file mode 100644
index 000000000..b8c7a9f1e
--- /dev/null
+++ b/fern/pages/src/tool-router/toolkit-management.mdx
@@ -0,0 +1,10 @@
+---
+title: Toolkit Management
+image: "https://og.composio.dev/api/og?title=Toolkit Management"
+description: "Complete control over toolkit configuration, discovery, and management in Tool Router sessions."
+keywords: "toolkit management, toolkit configuration, toolkit discovery, auth configs, connection management"
+subtitle: "Configure and control your toolkits with precision"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/understanding-tool-router.mdx b/fern/pages/src/tool-router/understanding-tool-router.mdx
new file mode 100644
index 000000000..65b06c6fe
--- /dev/null
+++ b/fern/pages/src/tool-router/understanding-tool-router.mdx
@@ -0,0 +1,10 @@
+---
+title: Understanding Tool Router
+image: "https://og.composio.dev/api/og?title=Understanding Tool Router"
+description: "Learn why 4 meta-tools beat 800+ individual tools for context management, token efficiency, and intelligent execution."
+keywords: "meta-tools, tool router architecture, context management, token optimization, intelligent routing"
+subtitle: "Why meta-tools are the future of AI tool orchestration"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file
diff --git a/fern/pages/src/tool-router/white-labeling.mdx b/fern/pages/src/tool-router/white-labeling.mdx
new file mode 100644
index 000000000..f32213fd7
--- /dev/null
+++ b/fern/pages/src/tool-router/white-labeling.mdx
@@ -0,0 +1,10 @@
+---
+title: White-Labeling
+image: "https://og.composio.dev/api/og?title=White-Labeling Tool Router"
+description: "Use custom OAuth credentials and branded authentication screens for your Tool Router applications."
+keywords: "white-label, custom oauth, branded auth, custom credentials, enterprise branding"
+subtitle: "Your brand, your auth, your way"
+hide-nav-links: false
+---
+
+{/* Content will be written by the user */}
\ No newline at end of file