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 21, 03:37 UTC
docs: drop experimental labels from Custom MCP (PLEN-4880)
Custom MCP APIs are no longer experimental (platform #14866) and the SDKs now expose composio.customToolkits / composio.custom_toolkits (@composio/core 0.30.0, composio 0.33.0). Remove the experimental frontmatter, keyword and callout, and point samples at the new namespace. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01H6YzWpsJUx7GVXrFfgStg6
Bharath committed
Nov 17, 2026 at 17:27 UTC
91ad65ad73a06fa77f24a9baddc07a4bb5996f19
1 file changed
+12
-17
docs/content/docs/extending-sessions/custom-mcp.mdx
+12
-17
@@ -1,16 +1,11 @@
1
---
2
title: Custom MCP
3
description: Use tools from a remote MCP server in Composio sessions
4
-keywords: [custom mcp, bring your own mcp, remote mcp, custom toolkits, end user mcp, private toolkit, experimental, dcr, cimd, discovery, revocation]
5
-experimental: true
4
+keywords: [custom mcp, bring your own mcp, remote mcp, custom toolkits, end user mcp, private toolkit, dcr, cimd, discovery, revocation]
5
---
6
7
Custom MCP lets you add your own remote MCP server to Composio and use its tools in sessions, next to Composio's toolkits. A Custom MCP toolkit is either shared with every user in your project or private to one user, so your users can add their own MCP servers too.
8
10
-<Callout type="warn">
11
-Custom MCP is experimental. The APIs may change.
12
-</Callout>
13
-
9
This is different from [Local Tools and Toolkits](/docs/extending-sessions/local-tools-and-toolkits), which run inside your app. A Custom MCP server runs on its own public HTTPS URL.
10
11
## How it works
@@ -21,7 +16,7 @@ This is different from [Local Tools and Toolkits](/docs/extending-sessions/local
16
4. Composio **syncs** the tools automatically.
17
5. **Use** the toolkit in a session.
18
24
-Use the SDK (`composio.experimental.custom_toolkits` in Python, `composio.experimental.customToolkits` in TypeScript) or the API. See the API reference for [create](/reference/api-reference/toolkits/postCustomToolkits), [update](/reference/api-reference/toolkits/patchCustomToolkitsBySlug), [sync](/reference/api-reference/toolkits/postCustomToolkitsSync), and [delete](/reference/api-reference/toolkits/deleteCustomToolkitsBySlug). `upsert()` is deprecated; use `create()` and `update()`. See [Move from upsert](#move-from-upsert).
19
+Use the SDK (`composio.custom_toolkits` in Python, `composio.customToolkits` in TypeScript) or the API. See the API reference for [create](/reference/api-reference/toolkits/postCustomToolkits), [update](/reference/api-reference/toolkits/patchCustomToolkitsBySlug), [sync](/reference/api-reference/toolkits/postCustomToolkitsSync), and [delete](/reference/api-reference/toolkits/deleteCustomToolkitsBySlug). `upsert()` is deprecated; use `create()` and `update()`. See [Move from upsert](#move-from-upsert).
20
21
## Create a toolkit
22
@@ -30,7 +25,7 @@ Pass your MCP server's URL as `mcp_url`, how to authenticate, and `user_id`. Use
25
<Tabs groupId="language" items={['Python', 'TypeScript', 'API']} persist>
26
<Tab value="Python">
27
```python
33
-result = composio.experimental.custom_toolkits.create(
28
+result = composio.custom_toolkits.create(
29
name="Acme",
30
mcp_url="https://mcp.acme.com/mcp",
31
auth_schemes=[{"mode": "NO_AUTH"}],
@@ -45,7 +40,7 @@ print(result.slug) # CUSTOM_ACME
40
import { Composio } from '@composio/core';
41
const composio = new Composio();
42
// ---cut---
48
-const result = await composio.experimental.customToolkits.create({
43
+const result = await composio.customToolkits.create({
44
name: 'Acme',
45
mcpUrl: 'https://mcp.acme.com/mcp',
46
authSchemes: [{ mode: 'NO_AUTH' }],
@@ -98,7 +93,7 @@ Set `user_id` to a user's ID to make the toolkit private: only that user's sessi
93
<Tabs groupId="language" items={['Python', 'TypeScript', 'API']} persist>
94
<Tab value="Python">
95
```python
101
-result = composio.experimental.custom_toolkits.create(
96
+result = composio.custom_toolkits.create(
97
name="Acme",
98
mcp_url="https://mcp.acme.com/mcp",
99
auth_schemes=[
@@ -121,7 +116,7 @@ if result.connect_link is not None:
116
import { Composio } from '@composio/core';
117
const composio = new Composio();
118
// ---cut---
124
-const result = await composio.experimental.customToolkits.create({
119
+const result = await composio.customToolkits.create({
120
name: 'Acme',
121
mcpUrl: 'https://mcp.acme.com/mcp',
122
authSchemes: [
@@ -194,7 +189,7 @@ Sync again only if that first sync fails or the server's tools change. Pass an a
189
<Tabs groupId="language" items={['Python', 'TypeScript', 'API']} persist>
190
<Tab value="Python">
191
```python
197
-result = composio.experimental.custom_toolkits.sync(
192
+result = composio.custom_toolkits.sync(
193
"CUSTOM_ACME",
194
connected_account_id="ca_custom_acme",
195
)
@@ -207,7 +202,7 @@ print(result.version, result.synced_count)
202
import { Composio } from '@composio/core';
203
const composio = new Composio();
204
// ---cut---
210
-const result = await composio.experimental.customToolkits.sync('CUSTOM_ACME', {
205
+const result = await composio.customToolkits.sync('CUSTOM_ACME', {
206
connectedAccountId: 'ca_custom_acme',
207
});
208
@@ -233,7 +228,7 @@ Update changes `name`, `logo_file`, or the API key field's label (`api_key_field
228
<Tabs groupId="language" items={['Python', 'TypeScript', 'API']} persist>
229
<Tab value="Python">
230
```python
236
-result = composio.experimental.custom_toolkits.update("CUSTOM_ACME", name="Acme (prod)")
231
+result = composio.custom_toolkits.update("CUSTOM_ACME", name="Acme (prod)")
232
233
print(result.success) # True
234
```
@@ -243,7 +238,7 @@ print(result.success) # True
238
import { Composio } from '@composio/core';
239
const composio = new Composio();
240
// ---cut---
246
-const result = await composio.experimental.customToolkits.update('CUSTOM_ACME', {
241
+const result = await composio.customToolkits.update('CUSTOM_ACME', {
242
name: 'Acme (prod)',
243
});
244
@@ -267,7 +262,7 @@ Delete removes the toolkit and its tools, auth configs, and connected accounts.
262
<Tabs groupId="language" items={['Python', 'TypeScript', 'API']} persist>
263
<Tab value="Python">
264
```python
270
-result = composio.experimental.custom_toolkits.delete("CUSTOM_ACME")
265
+result = composio.custom_toolkits.delete("CUSTOM_ACME")
266
267
print(result.deleted, result.revoke_job_ids)
268
```
@@ -277,7 +272,7 @@ print(result.deleted, result.revoke_job_ids)
272
import { Composio } from '@composio/core';
273
const composio = new Composio();
274
// ---cut---
280
-const result = await composio.experimental.customToolkits.delete('CUSTOM_ACME');
275
+const result = await composio.customToolkits.delete('CUSTOM_ACME');
276
277
console.log(result.deleted, result.revokeJobIds);
278
```