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.

in chat

Sushmithamalleshd9edb90bd689
diff --git a/fern/pages/src/tool-router/using-in-chat-authentication.mdx b/fern/pages/src/tool-router/using-in-chat-authentication.mdx
index cdeda11cf..ef6259ff5 100644
--- a/fern/pages/src/tool-router/using-in-chat-authentication.mdx
+++ b/fern/pages/src/tool-router/using-in-chat-authentication.mdx
@@ -1,5 +1,5 @@
---
-title: Using in-chat authentication
+title: Using In-chat authentication
image: "https://og.composio.dev/api/og?title=Using%20In-chat%20Authentication"
description: "Let your agent prompt users to connect accounts during conversation"
keywords: "tool router, authentication, in-chat, MANAGE_CONNECTIONS"
@@ -9,22 +9,25 @@ In-chat authentication lets your agent prompt users to connect accounts during c
## How it works
-1. Agent searches for tools via `COMPOSIO_SEARCH_TOOLS`
-2. `COMPOSIO_MANAGE_CONNECTIONS` checks connection status, returns Connect Link URL if needed
+1. Agent searches for tools via the `COMPOSIO_SEARCH_TOOLS` meta-tool
+2. The `COMPOSIO_MANAGE_CONNECTIONS` meta-tool checks connection status, returns Connect Link URL if needed
3. User authenticates, confirms in chat, agent continues
## Configuration
-In-chat auth is enabled by default. The `COMPOSIO_MANAGE_CONNECTIONS` meta-tool is included automatically.
+By just creating a session with default configs, you are enabling in-chat auth. The `manage_connections` parameter defaults to `True`, which includes the `COMPOSIO_MANAGE_CONNECTIONS` meta-tool automatically:
<CodeGroup>
```python
session = await composio.create(
user="user_123",
+ manage_connections=True, # default
)
```
```typescript
-const { mcp } = await composio.create("user_123");
+const session = await composio.create("user_123", {
+ manageConnections: true, // default
+});
```
</CodeGroup>
@@ -50,50 +53,16 @@ const { mcp } = await composio.create("user_123", {
```
</CodeGroup>
-### Disabling in-chat auth
-
-To manage authentication outside of chat, disable the `COMPOSIO_MANAGE_CONNECTIONS` tool:
-
-<CodeGroup>
-```python
-session = await composio.create(
- user="user_123",
- manage_connections=False,
-)
-```
-```typescript
-const { mcp } = await composio.create("user_123", {
- manageConnections: false,
-});
-```
-</CodeGroup>
-
-See [Manually authenticating users](/tool-router/manually-authenticating-users) for the alternative approach.
-
## Examples
<CodeGroup>
-<CodeGroupItem title="OpenAI Agents SDK (Python)">
-<SnippetCode src="fern/snippets/tool-router/python/in-chat-auth.py" />
-</CodeGroupItem>
-<CodeGroupItem title="Vercel AI SDK (TypeScript)">
-<SnippetCode src="fern/snippets/tool-router/typescript/in-chat-auth.ts" />
-</CodeGroupItem>
+<SnippetCode src="fern/snippets/tool-router/python/quickstart-openai.py" title="Python" />
+<SnippetCode src="fern/snippets/tool-router/typescript/quickstart-openai.ts" title="TypeScript" />
</CodeGroup>
-### Example conversation
-
-```
-You: Star the composio repo on GitHub
-
-Agent: I'll help you star the Composio repo. Let me search for the right tools.
-
-I found the tool to star repositories, but I need you to connect your GitHub
-account first. Please click the link below to authorize:
-https://connect.composio.dev/link/ln_abc123
-
-You: Done
+What this looks like when you run the code:
-Agent: Done! I've starred ComposioHQ/composio.
```
+Assistant: What would you like me to do today?
+> Star the composio repo on GitHub
\ No newline at end of file
diff --git a/fern/snippets/tool-router/python/in-chat-auth.py b/fern/snippets/tool-router/python/in-chat-auth.py
index 7ba361500..082fe416e 100644
--- a/fern/snippets/tool-router/python/in-chat-auth.py
+++ b/fern/snippets/tool-router/python/in-chat-auth.py
@@ -1,44 +1,38 @@
-import asyncio
+import os
from composio import Composio
-from agents import Agent, Runner, HostedMCPTool
-
-composio = Composio(api_key="your-composio-api-key")
-
-async def chat():
- print("Creating Tool Router session...")
- session = await composio.create("pg-user-550e8400-e29b-41d4")
- print(f"Tool Router session created: {session.mcp.url}")
-
- agent = Agent(
- name="GitHub Assistant",
- instructions="Help users with their GitHub repositories.",
- tools=[
- HostedMCPTool(
- tool_config={
- "type": "mcp",
- "server_label": "composio",
- "server_url": session.mcp.url,
- "require_approval": "never",
- "headers": {
- "x-api-key": "your-composio-api-key",
- },
- }
- )
- ],
- )
-
- print("Chat with your agent. Type 'exit' to quit.\n")
-
- while True:
- user_input = input("You: ")
- if user_input.lower() == "exit":
- break
-
- result = await Runner.run(
- agent,
- user_input,
+from agents import Agent, Runner, HostedMCPTool, ModelSettings
+
+composio_api_key = os.environ.get("COMPOSIO_API_KEY")
+user_id = "user_123" # Your user's unique identifier
+
+composio = Composio()
+session = composio.create(user_id=user_id)
+
+agent = Agent(
+ name="Personal Assistant",
+ instructions="You are a helpful personal assistant. Use Composio tools to take action.",
+ model="gpt-5.1",
+ model_settings= ModelSettings(
+ reasoning={"effort": "low"},
+ ),
+ tools=[
+ HostedMCPTool(
+ tool_config={
+ "type": "mcp",
+ "server_label": "composio",
+ "server_url": session.mcp.url,
+ "require_approval": "never",
+ "headers": {"x-api-key": composio_api_key},
+ }
)
+ ],
+)
- print(f"Agent: {result.final_output}\n")
+print("Assistant: What would you like me to do today?\n")
-asyncio.run(chat())
+while True:
+ user_input = input("> ")
+ if user_input == "exit":
+ break
+ result = Runner.run_sync(starting_agent=agent, input=user_input)
+ print(f"Assistant: {result.final_output}\n")
diff --git a/fern/snippets/tool-router/typescript/in-chat-auth.ts b/fern/snippets/tool-router/typescript/in-chat-auth.ts
index 8e0ceaab3..5525ae384 100644
--- a/fern/snippets/tool-router/typescript/in-chat-auth.ts
+++ b/fern/snippets/tool-router/typescript/in-chat-auth.ts
@@ -1,60 +1,37 @@
-import { openai } from "@ai-sdk/openai";
-import { experimental_createMCPClient as createMCPClient } from "@ai-sdk/mcp";
import { Composio } from "@composio/core";
-import { generateText } from "ai";
-import * as readline from "readline";
-
-const composio = new Composio({ apiKey: "your-composio-api-key" });
-
-async function chat() {
- console.log("Creating Tool Router session...");
- const { mcp } = await composio.create("pg-user-550e8400-e29b-41d4");
- console.log(`Tool Router session created: ${mcp.url}`);
-
- const client = await createMCPClient({
- transport: {
- type: "http",
- url: mcp.url,
+import { Agent, run, hostedMcpTool } from "@openai/agents";
+import { createInterface } from "readline/promises";
+
+const composioApiKey = process.env.COMPOSIO_API_KEY;
+const userId = "user-1234"; // Your user's unique identifier
+
+const composio = new Composio({ apiKey: composioApiKey });
+const { mcp } = await composio.create(userId);
+
+const agent = new Agent({
+ name: "Personal Assistant",
+ instructions: "You are a helpful personal assistant. Use Composio tools to take action.",
+ model: "gpt-5.1",
+ modelSettings: {
+ reasoning: { effort: "low" },
+ },
+ tools: [
+ hostedMcpTool({
+ serverLabel: "composio",
+ serverUrl: mcp.url,
headers: {
- "x-api-key": "your-composio-api-key",
+ "x-api-key": composioApiKey,
},
- },
- });
-
- const tools = await client.tools();
- const messages: { role: "user" | "assistant"; content: string }[] = [];
-
- const rl = readline.createInterface({
- input: process.stdin,
- output: process.stdout,
- });
-
- console.log("Chat with your agent. Type 'exit' to quit.\n");
-
- const prompt = () => {
- rl.question("You: ", async (input) => {
- if (input.toLowerCase() === "exit") {
- rl.close();
- return;
- }
-
- messages.push({ role: "user", content: input });
-
- const { text } = await generateText({
- model: openai("gpt-4o"),
- tools,
- messages,
- maxSteps: 5,
- });
-
- console.log(`Agent: ${text}\n`);
- messages.push({ role: "assistant", content: text });
-
- prompt();
- });
- };
-
- prompt();
+ }),
+ ],
+});
+
+const rl = createInterface({ input: process.stdin, output: process.stdout });
+console.log("Assistant: What would you like me to do today?\n");
+while (true) {
+ const input = await rl.question("> ");
+ if (input === "exit") break;
+ const result = await run(agent, input);
+ console.log(`Assistant: ${result.finalOutput}\n`);
}
-
-chat();
+rl.close();