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: polish custom tools references
Dhawal Upadhyay committed
Mar 25, 2026 at 15:24 UTC
d7e7e3a883ffc10ae75127a4ea4c8202f62be31f
1 file changed
+7
-5
docs/content/docs/toolkits/custom-tools-and-toolkits.mdx
+7
-5
@@ -227,10 +227,14 @@ For more best practices, see [How to Build Tools for AI Agents: A Field Guide](h
227
228
Use `session.customTools()` / `session.customToolkits()` in TypeScript or `session.custom_tools()` / `session.custom_toolkits()` in Python to list registered tools and toolkits. Registered tool slugs include their final `LOCAL_` prefix, and toolkit-scoped tools also include the toolkit slug.
229
230
+Reference: [TypeScript ToolRouterSession](/reference/sdk-reference/typescript/tool-router-session) · [Python SDK Reference](/reference/sdk-reference/python)
231
+
232
## Programmatic execution
233
234
Use `session.execute()` to run custom tools directly, outside of an agent loop (e.g. `session.execute("GET_USER_PROFILE")`). Custom tools execute in-process; remote tools are sent to the backend automatically.
235
236
+Reference: [Tool Router API Reference](/reference/api-reference/tool-router) · [TypeScript ToolRouterSession](/reference/sdk-reference/typescript/tool-router-session) · [Python SDK Reference](/reference/sdk-reference/python)
237
+
238
## SessionContext
239
240
Every custom tool's `execute` function receives `(input, ctx)`. The `ctx` object provides:
@@ -250,14 +254,12 @@ Every custom tool's `execute` function receives `(input, ctx)`. The `ctx` object
254
| Method | Description |
255
|--------|-------------|
256
| `ctx.user_id` | The user ID for the current session. |
253
-| `ctx.proxy_execute(...)` | Authenticated HTTP request via Composio's auth layer. Params: `toolkit`, `endpoint`, `method`, `body=None`, `parameters=[{"type": "query" \| "header", "name": ..., "value": ...}]`. |
257
+| `ctx.proxy_execute(...)` | Authenticated HTTP request via Composio's auth layer. Params: `toolkit`, `endpoint`, `method`, `body=None`, `parameters=[{"in": "query" \| "header", "name": ..., "value": ...}]`. |
258
| `ctx.execute(tool_slug, arguments)` | Execute any Composio native tool from within your custom tool. |
259
260
</Tab>
261
</Tabs>
262
259
-## Related reference
263
+In Python, `parameters` dictionaries accept both `in` and `type`; this guide uses `in` to match the TypeScript examples.
264
261
-- [Tool Router API Reference](/reference/api-reference/tool-router)
262
-- [TypeScript ToolRouterSession Reference](/reference/sdk-reference/typescript/tool-router-session)
263
-- [Python SDK Reference](/reference/sdk-reference/python)
265
+Reference: [TypeScript SessionContextImpl](/reference/sdk-reference/typescript/session-context-impl) · [Python SDK Reference](/reference/sdk-reference/python)