@devries-cameron20 / composio-1 / commits / 91ad65ad7
Fork 0

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: 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 ```