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
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.mdxindex 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 authenticationimage: "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 needed3. 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>```pythonsession = 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 filediff --git a/fern/snippets/tool-router/python/in-chat-auth.py b/fern/snippets/tool-router/python/in-chat-auth.pyindex 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 osfrom 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.tsindex 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();