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.

docs: consolidate MCP pages into Single Toolkit MCP

Sushmithamallesheaee9c6d4e8d
diff --git a/docs/content/docs/mcp/index.mdx b/docs/content/docs/mcp/index.mdx
new file mode 100644
index 000000000..a63b13838
--- /dev/null
+++ b/docs/content/docs/mcp/index.mdx
@@ -0,0 +1,355 @@
+---
+title: Single Toolkit MCP
+description: Create MCP servers for specific toolkits
+keywords: [mcp, model context protocol, single toolkit]
+---
+
+<Callout type="info">
+For most use cases, we recommend using [Tool Router](/docs/quickstart) which provides dynamic tool access without pre-configuring servers.
+</Callout>
+
+## Install the SDK
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```bash
+pip install composio
+```
+ </Tab>
+ <Tab value="TypeScript">
+```bash
+npm install @composio/core
+```
+ </Tab>
+</Tabs>
+
+## Create an MCP server
+
+<Steps>
+ <Step>
+ ### Initialize Composio
+
+ <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```python
+from composio import Composio
+
+composio = Composio(api_key="YOUR_API_KEY")
+```
+ </Tab>
+ <Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+
+const composio = new Composio({
+ apiKey: process.env.COMPOSIO_API_KEY
+});
+```
+ </Tab>
+ </Tabs>
+ </Step>
+
+ <Step>
+ ### Create server configuration
+
+ <Callout type="warn">
+ **Before you begin:** [Create an auth configuration](/docs/auth-configuration/custom-auth-configs) for your toolkit.
+ </Callout>
+
+ <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```python
+server = composio.mcp.create(
+ name="my-gmail-server",
+ toolkits=[{
+ "toolkit": "gmail",
+ "auth_config": "ac_xyz123"
+ }],
+ allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]
+)
+
+print(f"Server created: {server.id}")
+```
+ </Tab>
+ <Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });
+// ---cut---
+const server = await composio.mcp.create("my-gmail-server", {
+ toolkits: [
+ {
+ authConfigId: "ac_xyz123",
+ toolkit: "gmail"
+ }
+ ],
+ allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]
+});
+
+console.log(`Server created: ${server.id}`);
+```
+ </Tab>
+ </Tabs>
+
+ <Callout type="info">
+ You can also create and manage MCP configs from the [Composio dashboard](https://platform.composio.dev?next_page=/mcp-configs).
+ </Callout>
+ </Step>
+
+ <Step>
+ ### Generate user URLs
+
+ <Callout type="warn">
+ Users must authenticate with the toolkits configured in your MCP server first. See [authentication](/docs/authentication) for details.
+ </Callout>
+
+ <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```python
+instance = composio.mcp.generate(user_id="user-123", mcp_config_id=server.id)
+
+print(f"MCP Server URL: {instance['url']}")
+```
+ </Tab>
+ <Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });
+const server = { id: 'my-gmail-server' };
+// ---cut---
+const instance = await composio.mcp.generate("user-123", server.id);
+
+console.log("MCP Server URL:", instance.url);
+```
+ </Tab>
+ </Tabs>
+ </Step>
+
+ <Step>
+ ### Use with AI providers
+
+ <Tabs items={['OpenAI (Python)', 'Anthropic (Python)', 'Mastra (TypeScript)']}>
+ <Tab value="OpenAI (Python)">
+```python
+from openai import OpenAI
+
+client = OpenAI(api_key="your-openai-api-key")
+
+mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID"
+
+response = client.responses.create(
+ model="gpt-5",
+ tools=[{
+ "type": "mcp",
+ "server_label": "composio-server",
+ "server_url": mcp_server_url,
+ "require_approval": "never",
+ }],
+ input="What are my latest emails?",
+)
+
+print(response.output_text)
+```
+ </Tab>
+ <Tab value="Anthropic (Python)">
+```python
+from anthropic import Anthropic
+
+client = Anthropic(api_key="your-anthropic-api-key")
+
+mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID"
+
+response = client.beta.messages.create(
+ model="claude-sonnet-4-5",
+ max_tokens=1000,
+ messages=[{"role": "user", "content": "What are my latest emails?"}],
+ mcp_servers=[{
+ "type": "url",
+ "url": mcp_server_url,
+ "name": "composio-mcp-server"
+ }],
+ betas=["mcp-client-2025-04-04"]
+)
+
+print(response.content)
+```
+ </Tab>
+ <Tab value="Mastra (TypeScript)">
+```typescript
+import { MCPClient } from "@mastra/mcp";
+import { openai } from "@ai-sdk/openai";
+import { Agent } from "@mastra/core/agent";
+
+const MCP_URL = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?user_id=YOUR_USER_ID";
+
+const client = new MCPClient({
+ id: "mcp-client",
+ servers: {
+ composio: { url: new URL(MCP_URL) },
+ }
+});
+
+const agent = new Agent({
+ id: "assistant",
+ name: "Assistant",
+ model: openai("gpt-4-turbo"),
+ tools: await client.getTools()
+});
+
+const res = await agent.generate("What are my latest emails?");
+console.log(res.text);
+```
+ </Tab>
+ </Tabs>
+ </Step>
+</Steps>
+
+## Server management
+
+### List servers
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```python
+servers = composio.mcp.list()
+print(f"Found {len(servers['items'])} servers")
+
+# Filter by toolkit
+gmail_servers = composio.mcp.list(toolkits="gmail", limit=20)
+```
+ </Tab>
+ <Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+const servers = await composio.mcp.list({ limit: 10, page: 1 });
+console.log(`Found ${servers.items.length} servers`);
+
+// Filter by toolkit
+const gmailServers = await composio.mcp.list({ toolkits: ["gmail"] });
+```
+ </Tab>
+</Tabs>
+
+### Get server details
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```python
+server = composio.mcp.get("mcp_server_id")
+print(f"Server: {server.name}")
+```
+ </Tab>
+ <Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+const server = await composio.mcp.get("mcp_server_id");
+console.log(`Server: ${server.name}`);
+```
+ </Tab>
+</Tabs>
+
+### Update a server
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```python
+updated = composio.mcp.update(
+ server_id="mcp_server_id",
+ name="updated-name",
+ allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]
+)
+```
+ </Tab>
+ <Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+const updated = await composio.mcp.update("mcp_server_id", {
+ name: "updated-name",
+ allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]
+});
+```
+ </Tab>
+</Tabs>
+
+### Delete a server
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```python
+result = composio.mcp.delete("mcp_server_id")
+if result['deleted']:
+ print("Server deleted")
+```
+ </Tab>
+ <Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+const result = await composio.mcp.delete("mcp_server_id");
+if (result.deleted) {
+ console.log("Server deleted");
+}
+```
+ </Tab>
+</Tabs>
+
+### Multi-toolkit servers
+
+Combine multiple services in a single MCP server:
+
+<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
+ <Tab value="Python">
+```python
+server = composio.mcp.create(
+ name="productivity-suite",
+ toolkits=[
+ {"toolkit": "gmail", "auth_config": "ac_gmail"},
+ {"toolkit": "slack", "auth_config": "ac_slack"},
+ {"toolkit": "github", "auth_config": "ac_github"}
+ ],
+ allowed_tools=[
+ "GMAIL_FETCH_EMAILS",
+ "SLACK_SEND_MESSAGE",
+ "GITHUB_CREATE_ISSUE"
+ ]
+)
+```
+ </Tab>
+ <Tab value="TypeScript">
+```typescript
+import { Composio } from '@composio/core';
+const composio = new Composio({ apiKey: 'your_api_key' });
+// ---cut---
+const server = await composio.mcp.create("productivity-suite", {
+ toolkits: [
+ { authConfigId: "ac_gmail", toolkit: "gmail" },
+ { authConfigId: "ac_slack", toolkit: "slack" },
+ { authConfigId: "ac_github", toolkit: "github" }
+ ],
+ allowedTools: [
+ "GMAIL_FETCH_EMAILS",
+ "SLACK_SEND_MESSAGE",
+ "GITHUB_CREATE_ISSUE"
+ ]
+});
+```
+ </Tab>
+</Tabs>
+
+## Next steps
+
+<Cards>
+ <Card title="Providers" href="/docs/providers">
+ Use with Anthropic, OpenAI, and other frameworks
+ </Card>
+ <Card title="Quickstart" href="/docs/quickstart">
+ Build an agent with Tool Router (recommended)
+ </Card>
+</Cards>
diff --git a/docs/content/docs/mcp/mcp-quickstart.mdx b/docs/content/docs/mcp/mcp-quickstart.mdx
deleted file mode 100644
index a13177f19..000000000
--- a/docs/content/docs/mcp/mcp-quickstart.mdx
+++ /dev/null
@@ -1,272 +0,0 @@
----
-title: Quickstart
-description: Create your first MCP server
-keywords: [mcp, model context protocol]
----
-
-[Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) is an open-source standard for connecting AI applications to external tools. All the 500+ tools available in Composio are also available as MCP servers.
-
-Composio lets you create MCP servers that handle authentication (OAuth, API keys), generate unique URLs for each user, and control which tools are exposed. You can combine multiple toolkits in a single server.
-
-<Callout type="info">
-Composio MCP servers only support Streamable HTTP transport.
-</Callout>
-
-## Install the SDK
-
-First, install the Composio SDK for your preferred language:
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```bash
-pip install composio
-```
- </Tab>
- <Tab value="TypeScript">
-```bash
-npm install @composio/core
-```
- </Tab>
-</Tabs>
-
-## Create an MCP server
-
-<Steps>
- <Step>
- ### Initialize Composio
-
- <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-from composio import Composio
-
-# Initialize Composio
-composio = Composio(api_key="YOUR_API_KEY")
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-
-// Initialize Composio
-const composio = new Composio({
- apiKey: process.env.COMPOSIO_API_KEY
-});
-```
- </Tab>
- </Tabs>
- </Step>
-
- <Step>
- ### Create server configuration
-
- <Callout type="warn">
- **Before you begin:** [Create an auth configuration](/docs/authenticating-tools#creating-an-auth-config) for your toolkit.
- </Callout>
-
- Create an MCP server with your auth config. You can also set list of specific tools to enable across all toolkits.
-
- <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-# Create MCP server with multiple toolkits
-server = composio.mcp.create(
- name="mcp-config-73840", # Pick a unique name for your MCP server
- toolkits=[
- {
- "toolkit": "gmail",
- "auth_config": "ac_xyz123" # Your Gmail auth config ID
- },
- {
- "toolkit": "googlecalendar",
- "auth_config": "ac_abc456" # Your Google Calendar auth config ID
- }
- ],
- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL", "GOOGLECALENDAR_EVENTS_LIST"]
-)
-
-print(f"Server created: {server.id}")
-print(server.id)
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });
-// ---cut---
-// Create MCP server with multiple toolkits
-const server = await composio.mcp.create("mcp-config-73840", { // Pick a unique name for your MCP server
- toolkits: [
- {
- authConfigId: "ac_xyz123", // Your Gmail auth config ID
- toolkit: "gmail"
- },
- {
- authConfigId: "ac_abc456", // Your Google Calendar auth config ID
- toolkit: "googlecalendar"
- }
- ],
- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL", "GOOGLECALENDAR_EVENTS_LIST"]
-});
-
-console.log(`Server created: ${server.id}`);
-console.log(server.id);
-```
- </Tab>
- </Tabs>
-
- <Callout type="info">
- **Alternative:** You can also create and manage MCP configs directly from the [Composio dashboard → MCP Configs](https://platform.composio.dev?next_page=/mcp-configs).
- </Callout>
- </Step>
-
- <Step>
- ### Generate user URLs
-
- <Callout type="warn">
- **Before generating URLs:** Users must authenticate with the toolkits configured in your MCP server. See [hosted authentication](/docs/authenticating-tools#hosted-authentication-connect-link) for how to connect user accounts.
- </Callout>
-
- Get server URLs for your users to connect:
-
- <Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-# Generate server instance for user
-instance = composio.mcp.generate(user_id="user-73840", mcp_config_id=server.id) # Use the user ID for which you created the connected account
-
-print(f"MCP Server URL: {instance['url']}")
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: process.env.COMPOSIO_API_KEY });
-const server = { id: 'mcp-config-73840' };
-// ---cut---
-// Generate server instance for user
-const instance = await composio.mcp.generate("user-73840", server.id); // Use the user ID for which you created the connected account
-
-console.log("MCP Server URL:", instance.url);
-```
- </Tab>
- </Tabs>
-
- <Callout type="info">
- If users haven't authenticated, the MCP server will still generate a URL but tools requiring authentication won't work until the user connects their accounts.
- </Callout>
- </Step>
-
- <Step>
- ### Use with AI providers
-
- Use the MCP server URL with your AI provider:
-
- <Tabs items={['OpenAI (Python)', 'Anthropic (Python)', 'Mastra (TypeScript)']}>
- <Tab value="OpenAI (Python)">
-```python
-from openai import OpenAI
-
-# Initialize OpenAI client
-client = OpenAI(api_key="your-openai-api-key")
-
-# Use the MCP server URL you generated
-mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID"
-
-# Use MCP with OpenAI Responses API
-response = client.responses.create(
- model="gpt-5",
- tools=[
- {
- "type": "mcp",
- "server_label": "composio-server",
- "server_description": "Composio MCP server for Gmail and Calendar integrations",
- "server_url": mcp_server_url,
- "require_approval": "never",
- },
- ],
- input="What meetings do I have tomorrow? Also check if I have any urgent emails",
-)
-
-print("OpenAI MCP Response:", response.output_text)
-```
- </Tab>
- <Tab value="Anthropic (Python)">
-```python
-from anthropic import Anthropic
-
-# Initialize Anthropic client
-client = Anthropic(api_key="your-anthropic-api-key")
-
-# Use the MCP server URL you generated
-mcp_server_url = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID"
-
-# Use MCP with Anthropic (beta feature)
-response = client.beta.messages.create(
- model="claude-sonnet-4-5",
- system="You are a helpful assistant with access to various tools through MCP. Use these tools to help the user. Do not ask for confirmation before using the tools.",
- max_tokens=1000,
- messages=[{
- "role": "user",
- "content": "What meetings do I have tomorrow? Also check if I have any urgent emails"
- }],
- mcp_servers=[{
- "type": "url",
- "url": mcp_server_url,
- "name": "composio-gmail-calendar-mcp-server"
- }],
- betas=["mcp-client-2025-04-04"] # Enable MCP beta
-)
-
-print(response.content)
-```
- </Tab>
- <Tab value="Mastra (TypeScript)">
-```typescript
-import { MCPClient } from "@mastra/mcp";
-import { openai } from "@ai-sdk/openai";
-import { Agent } from "@mastra/core/agent";
-
-// Use the MCP server URL you generated
-const MCP_URL = "https://backend.composio.dev/v3/mcp/YOUR_SERVER_ID?include_composio_helper_actions=true&user_id=YOUR_USER_ID";
-
-export const client = new MCPClient({
- id: "docs-mcp-client",
- servers: {
- composio: { url: new URL(MCP_URL) },
- }
-});
-
-export const agent = new Agent({
- id: "assistant",
- name: "Assistant",
- description: "Helpful AI with MCP tools",
- instructions: "Use the MCP tools to answer.",
- model: openai("gpt-4-turbo"),
- tools: await client.getTools()
-});
-
-(async () => {
- const res = await agent.generate("What meetings do I have tomorrow? Also check if I have any urgent emails");
- console.log(res.text);
-})();
-```
- </Tab>
- </Tabs>
- </Step>
-</Steps>
-
-## Next steps
-
-<Cards>
- <Card title="Server management" href="/docs/mcp/mcp-server-management">
- Create and manage MCP servers
- </Card>
- <Card title="Providers" href="/docs/providers">
- Use with Anthropic, OpenAI, and other frameworks
- </Card>
-</Cards>
-
-<Callout type="info">
-Need help? Join our [Discord](https://discord.com/invite/composio) or [raise an issue on GitHub](https://github.com/ComposioHQ/composio/issues/new?labels=bug).
-</Callout>
diff --git a/docs/content/docs/mcp/mcp-server-management.mdx b/docs/content/docs/mcp/mcp-server-management.mdx
deleted file mode 100644
index 404b3294a..000000000
--- a/docs/content/docs/mcp/mcp-server-management.mdx
+++ /dev/null
@@ -1,309 +0,0 @@
----
-title: Server management
-description: Create, update, and manage MCP servers
-keywords: [create server, update server, delete server]
----
-
-This guide covers all server management operations for MCP servers.
-
-## Create a server
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-server = composio.mcp.create(
- name="my-gmail-server",
- toolkits=[{
- "toolkit": "gmail",
- "auth_config": "ac_xyz123"
- }],
- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"]
-)
-
-print(f"Created server: {server.id}")
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const server = await composio.mcp.create(
- "my-gmail-server",
- {
- toolkits: [
- {
- authConfigId: "ac_xyz123",
- toolkit: "gmail"
- }
- ],
- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEND_EMAIL"],
- manuallyManageConnections: false
- }
-);
-
-console.log(`Created server: ${server.id}`);
-```
- </Tab>
-</Tabs>
-
-## List servers
-
-Find and filter your MCP servers.
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-# List all servers
-servers = composio.mcp.list()
-print(f"Found {len(servers['items'])} servers")
-
-# Filter by toolkit
-gmail_servers = composio.mcp.list(
- toolkits="gmail",
- limit=20
-)
-
-# Filter by name
-production_servers = composio.mcp.list(
- name="production"
-)
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-// List all servers
-const servers = await composio.mcp.list({
- limit: 10,
- page: 1,
- authConfigs: [],
- toolkits: []
-});
-console.log(`Found ${servers.items.length} servers`);
-
-// Filter by toolkit
-const gmailServers = await composio.mcp.list({
- limit: 20,
- page: 1,
- authConfigs: [],
- toolkits: ["gmail"]
-});
-
-// Filter by name
-const productionServers = await composio.mcp.list({
- limit: 10,
- page: 1,
- authConfigs: [],
- toolkits: [],
- name: "production"
-});
-```
- </Tab>
-</Tabs>
-
-## Get server details
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-# Get by ID
-server = composio.mcp.get("mcp_server_id")
-print(f"Server name: {server.name}")
-print(f"Toolkits: {server.toolkits}")
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-// Get by ID
-const server = await composio.mcp.get("mcp_server_id");
-
-console.log(`Server: ${server.name}`);
-console.log(`Toolkits: ${server.toolkits}`);
-```
- </Tab>
-</Tabs>
-
-## Update a server
-
-Modify server configuration, tools, or auth configs.
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-updated = composio.mcp.update(
- server_id="mcp_server_id",
- name="updated-name",
- allowed_tools=["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"]
-)
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const updated = await composio.mcp.update(
- "mcp_server_id",
- {
- name: "updated-name",
- toolkits: [
- {
- toolkit: "gmail",
- authConfigId: "ac_new_config"
- }
- ],
- allowedTools: ["GMAIL_FETCH_EMAILS", "GMAIL_SEARCH_EMAILS"],
- manuallyManageConnections: false
- }
-);
-
-console.log(updated);
-```
- </Tab>
-</Tabs>
-
-## Delete a server
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-result = composio.mcp.delete("mcp_server_id")
-if result['deleted']:
- print("Server deleted successfully")
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const result = await composio.mcp.delete("mcp_server_id");
-if (result.deleted) {
- console.log("Server deleted successfully");
-}
-```
- </Tab>
-</Tabs>
-
-## Multi-toolkit servers
-
-Combine multiple services in a single MCP server.
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-server = composio.mcp.create(
- name="productivity-suite",
- toolkits=[
- {"toolkit": "gmail", "auth_config": "ac_gmail"},
- {"toolkit": "slack", "auth_config": "ac_slack"},
- {"toolkit": "github", "auth_config": "ac_github"}
- ],
- allowed_tools=[
- "GMAIL_FETCH_EMAILS",
- "SLACK_SEND_MESSAGE",
- "GITHUB_CREATE_ISSUE"
- ]
-)
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-const server = await composio.mcp.create(
- "productivity-suite",
- {
- toolkits: [
- {
- authConfigId: "ac_gmail",
- toolkit: "gmail"
- },
- {
- authConfigId: "ac_slack",
- toolkit: "slack"
- },
- {
- authConfigId: "ac_github",
- toolkit: "github"
- }
- ],
- allowedTools: [
- "GMAIL_FETCH_EMAILS",
- "SLACK_SEND_MESSAGE",
- "GITHUB_CREATE_ISSUE"
- ],
- manuallyManageConnections: false
- }
-);
-```
- </Tab>
-</Tabs>
-
-## Generate user URLs
-
-After creating a server, generate unique URLs for each user.
-
-<Tabs groupId="language" items={['Python', 'TypeScript']} persist>
- <Tab value="Python">
-```python
-# Generate instance for user
-instance = server.generate("[email protected]")
-
-print(f"URL: {instance['url']}")
-print(f"Tools: {instance['allowed_tools']}")
-
-# Chat-based authentication is enabled by default
-# Set manually_manage_connections=True to disable it:
-instance_manual = server.generate(
- manually_manage_connections=True
-)
-```
- </Tab>
- <Tab value="TypeScript">
-```typescript
-import { Composio } from '@composio/core';
-const composio = new Composio({ apiKey: 'your_api_key' });
-// ---cut---
-// Generate instance for user
-const instance = await composio.mcp.generate(
- "mcp_server_id"
-);
-
-console.log("URL:", instance.url);
-console.log("Tools:", instance.allowedTools);
-
-// Chat-based authentication is enabled by default
-// Set manuallyManageConnections: true to disable it:
-const instanceManual = await composio.mcp.generate(
- "mcp_server_id",
- { manuallyManageConnections: true }
-);
-```
- </Tab>
-</Tabs>
-
-<Callout type="info">
-**Chat-based authentication:**
-- **TypeScript**: Enabled by default (set `manuallyManageConnections=false` or omit it)
-- **Python**: Enabled by default (set `manually_manage_connections=False` or omit it)
-
-When enabled, the agent can authenticate users dynamically during conversation if they're missing required connections. Set `manuallyManageConnections=true` (TypeScript) or `manually_manage_connections=True` (Python) to disable it.
-</Callout>
-
-## Best practices
-
-- **Use descriptive names** - Makes servers easy to find
-- **Limit tools appropriately** - Only include necessary tools
-- **Reuse servers** - Don't create duplicates for same configuration
-- **Store server IDs** - Keep track of created server IDs
diff --git a/docs/content/docs/mcp/meta.json b/docs/content/docs/mcp/meta.json
index 7d2b3692a..344c6ae22 100644
--- a/docs/content/docs/mcp/meta.json
+++ b/docs/content/docs/mcp/meta.json
@@ -1,7 +1,6 @@
{
"title": "MCP",
"pages": [
- "mcp-quickstart",
- "mcp-server-management"
+ "index"
]
}