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 22, 02:00 UTC
docs: add MCP caveat, trim content
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Dhawal Upadhyay committed
Mar 19, 2026 at 14:10 UTC
93331ac92313855914bbc336c2552341c7e351d7
1 file changed
+12
-11
docs/content/docs/toolkits/custom-tools-and-toolkits.mdx
+12
-11
@@ -8,11 +8,15 @@ keywords: [custom tools, custom toolkits, beta, experimental, local tools, proxy
8
Custom tools are experimental. The `experimental_` prefix and `experimental` session option may change in future releases. TypeScript only.
9
</Callout>
10
11
+<Callout type="info">
12
+Custom tools work with **native tools** (`session.tools()`). MCP support is coming soon.
13
+</Callout>
14
+
15
Custom tools let you define local tools that run in-process alongside remote Composio tools within a session.
16
17
## Standalone tool
18
15
-A tool with no Composio-managed authentication — just input and an execute function:
19
+A tool with no Composio-managed authentication:
20
21
```ts
22
// @noErrors
@@ -33,7 +37,7 @@ const getUser = experimental_createTool("GET_USER", {
37
38
## Extension tool
39
36
-A tool that inherits authentication from an existing Composio toolkit via `extendsToolkit`. The second argument to `execute` is a `SessionContext` that lets you make authenticated API calls or invoke other tools:
40
+Inherits authentication from an existing Composio toolkit via `extendsToolkit`. The second argument to `execute` is a `SessionContext` for authenticated API calls:
41
42
```ts
43
// @noErrors
@@ -63,16 +67,14 @@ const createDraft = experimental_createTool("CREATE_DRAFT", {
67
68
### SessionContext
69
66
-The `ctx` object passed to extension tools provides:
67
-
70
| Method | Description |
71
|--------|-------------|
70
-| `ctx.proxyExecute(params)` | Make authenticated HTTP requests through Composio's auth layer. Params: `toolkit`, `endpoint`, `method`, `body?`, `parameters?` (array of `{ in: "query" \| "header", name, value }`). |
72
+| `ctx.proxyExecute(params)` | Authenticated HTTP request via Composio's auth layer. Params: `toolkit`, `endpoint`, `method`, `body?`, `parameters?` (array of `{ in: "query" \| "header", name, value }`). |
73
| `ctx.execute(toolSlug, args)` | Execute any Composio native tool from within your custom tool. |
74
75
## Custom toolkit
76
75
-Group related tools under a namespace with `experimental_createToolkit`. Tools inside a toolkit must **not** use `extendsToolkit` — they inherit the toolkit identity instead:
77
+Group related tools under a namespace. Tools inside a toolkit must **not** use `extendsToolkit` — they inherit the toolkit identity instead:
78
79
```ts
80
// @noErrors
@@ -98,7 +100,7 @@ const roleManager = experimental_createToolkit("ROLE_MANAGER", {
100
101
## Binding to a session
102
101
-Pass custom tools and toolkits via the `experimental` option when creating a session:
103
+Pass custom tools and toolkits via the `experimental` option:
104
105
```ts
106
// @noErrors
@@ -119,7 +121,6 @@ const tools = await session.tools(); // Includes both remote and custom tools
121
122
## Slug rules
123
122
-- Tool slugs are automatically prefixed with `LOCAL_` (e.g. `GET_USER` becomes `LOCAL_GET_USER`)
123
-- Toolkit tools get both prefixes (e.g. `LOCAL_ROLE_MANAGER_SET_ROLE`)
124
-- Final slug must not exceed 60 characters
125
-- Slugs cannot start with `LOCAL_` or `COMPOSIO_`
124
+- Slugs are auto-prefixed with `LOCAL_` (e.g. `GET_USER` → `LOCAL_GET_USER`, `LOCAL_ROLE_MANAGER_SET_ROLE`)
125
+- Max 60 characters after prefixing
126
+- Cannot start with `LOCAL_` or `COMPOSIO_`