@devries-cameron20 / composio Mirror · read-only / commits / 93331ac92
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.

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