@devries-cameron20 / composio-1 / commits / ab904216f
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.

fix(sdk): adopt composio-client 2.1.0 (#5236)

This PR: - incorporates the automated dependency update from https://github.com/ComposioHQ/composio/pull/5235 and the validated migration from https://github.com/ComposioHQ/composio/pull/5234. - updates the shared TypeScript SDK/CLI catalog and both Python client pins to published `composio-client` 2.1.0, including regenerated pnpm/uv locks. - preserves TypeScript's public `appUrl` input while sending the required `mcp_url` field for custom toolkit create/upsert requests. - updates Python fixtures/docstrings and Custom MCP documentation for the renamed wire input, with API schemas refreshed through the existing production fetcher. - includes SDK patch changesets and the CLI release note. Client 2.1.0 is the explicitly approved one-time breaking exception in https://github.com/ComposioHQ/composio-client/pull/133, released by https://github.com/ComposioHQ/composio-client/pull/134. Python custom-toolkit callers must use `mcp_url` instead of `app_url`. Validation: the core SDK typechecks against the published npm client and all 18 custom toolkit tests pass. Docs API snippet and code example checks pass. [Release acceptance](https://github.com/ComposioHQ/composio-client/actions/runs/42023805494) passed the complete TypeScript SDK/CLI and Python SDK typechecks, example checks and unit tests against this migration, plus the installed Effect subpath and production live-contract checks. Fresh npm Promise/Effect and PyPI consumers verified client 2.1.0 after publication. --------- Co-authored-by: sdkrelease[bot] <294075132+sdkrelease[bot]@users.noreply.github.com>

Alberto Schiabel committed Nov 6, 2026 at 15:23 UTC ab904216fce3db2d6df7f0a8b0f1d1e5e8ea05f3
15 files changed +261 -57
.changeset/composio-client-update.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/core': patch
3 +---
4 +
5 +Update @composio/client to 2.1.0 to include the latest API changes.
.changeset/custom-toolkit-mcp-url.md new
+5
@@ -0,0 +1,5 @@
1 +---
2 +'@composio/core': patch
3 +---
4 +
5 +Send custom toolkit URLs as `mcp_url` for the Platform API rename while preserving the public TypeScript `appUrl` input.
docs/content/docs/extending-sessions/custom-mcp.mdx
+9 -9
@@ -25,14 +25,14 @@ Use the SDK (`composio.experimental.custom_toolkits` in Python, `composio.experi
25
26 ## Create a toolkit
27
28 -Pass your MCP server's URL as `app_url`, how to authenticate, and `user_id`. Use `"all"` to share the toolkit with every user in your project:
28 +Pass your MCP server's URL as `mcp_url`, how to authenticate, and `user_id`. Use `"all"` to share the toolkit with every user in your project:
29
30 <Tabs groupId="language" items={['Python', 'TypeScript', 'API']} persist>
31 <Tab value="Python">
32 ```python
33 result = composio.experimental.custom_toolkits.create(
34 name="Acme",
35 - app_url="https://mcp.acme.com/mcp",
35 + mcp_url="https://mcp.acme.com/mcp",
36 auth_schemes=[{"mode": "NO_AUTH"}],
37 user_id="all",
38 )
@@ -62,7 +62,7 @@ curl -X POST https://backend.composio.dev/api/v3.1/custom/toolkits \
62 -H "Content-Type: application/json" \
63 -d '{
64 "name": "Acme",
65 - "app_url": "https://mcp.acme.com/mcp",
65 + "mcp_url": "https://mcp.acme.com/mcp",
66 "auth_schemes": [{"mode": "NO_AUTH"}],
67 "user_id": "all"
68 }'
@@ -72,10 +72,10 @@ curl -X POST https://backend.composio.dev/api/v3.1/custom/toolkits \
72
73 Save the returned slug: you need it to sync, update, or delete the toolkit.
74
75 -`app_url`, `auth_schemes`, and `user_id` can't change later. To change them, delete the toolkit and create it again.
75 +`mcp_url`, `auth_schemes`, and `user_id` can't change later. To change them, delete the toolkit and create it again.
76
77 <Callout type="warn" title="Use the final URL">
78 -Set `app_url` to the final MCP endpoint, with no redirects: a redirect can send credentials to another host. Don't put keys in the URL.
78 +Set `mcp_url` to the final MCP endpoint, with no redirects: a redirect can send credentials to another host. Don't put keys in the URL.
79 </Callout>
80
81 ### Choose how users authenticate
@@ -100,7 +100,7 @@ Set `user_id` to a user's ID to make the toolkit private: only that user's sessi
100 ```python
101 result = composio.experimental.custom_toolkits.create(
102 name="Acme",
103 - app_url="https://mcp.acme.com/mcp",
103 + mcp_url="https://mcp.acme.com/mcp",
104 auth_schemes=[
105 {
106 "mode": "DCR_OAUTH",
@@ -147,7 +147,7 @@ curl -X POST https://backend.composio.dev/api/v3.1/custom/toolkits \
147 -H "Content-Type: application/json" \
148 -d '{
149 "name": "Acme",
150 - "app_url": "https://mcp.acme.com/mcp",
150 + "mcp_url": "https://mcp.acme.com/mcp",
151 "auth_schemes": [
152 {
153 "mode": "DCR_OAUTH",
@@ -398,13 +398,13 @@ curl -X POST https://backend.composio.dev/api/v3.1/tool_router/session \
398
399 - **New toolkit:** call create instead of upsert. Don't pass a slug: create returns one, so save it. Set `user_id` to `"all"` to share the toolkit like upsert did, or to a user's ID to make it private.
400 - **Existing toolkit:** call update with its slug to change the name, logo, or API key field label. Don't create it again: a second shared toolkit for the same URL returns `409`.
401 -- **Request shape:** create takes the fields directly (`name`, `app_url`, `auth_schemes`, ...), not inside `toolkit_config`.
401 +- **Request shape:** create takes the fields directly (`name`, `mcp_url`, `auth_schemes`, ...), not inside `toolkit_config`.
402
403 ## Limits
404
405 - Private toolkits need a Pro plan. Shared toolkits (`user_id: "all"`) work on every plan.
406 - Remote servers only: local and STDIO servers aren't supported.
407 -- `app_url`, `auth_schemes`, and `user_id` can't change after creation.
407 +- `mcp_url`, `auth_schemes`, and `user_id` can't change after creation.
408 - At most 500 tools per toolkit.
409 - OAuth works only through Dynamic Client Registration (DCR). Servers that need a pre-registered OAuth client, or that only support Client ID Metadata Documents (CIMD), aren't supported.
410 - No automatic resync: sync again when the server's tools change.
docs/public/openapi-v3.json
+102 -6
@@ -3555,6 +3555,16 @@
3555 }
3556 }
3557 },
3558 + "403": {
3559 + "description": "Forbidden - Your role does not allow modifying auth configs",
3560 + "content": {
3561 + "application/json": {
3562 + "schema": {
3563 + "$ref": "#/components/schemas/Error"
3564 + }
3565 + }
3566 + }
3567 + },
3568 "404": {
3569 "description": "Not found - Auth configuration does not exist",
3570 "content": {
@@ -3668,6 +3678,16 @@
3678 }
3679 }
3680 },
3681 + "403": {
3682 + "description": "Forbidden - Your role does not allow modifying auth configs",
3683 + "content": {
3684 + "application/json": {
3685 + "schema": {
3686 + "$ref": "#/components/schemas/Error"
3687 + }
3688 + }
3689 + }
3690 + },
3691 "404": {
3692 "description": "Auth config not found - The specified configuration does not exist or was already deleted",
3693 "content": {
@@ -3778,6 +3798,16 @@
3798 }
3799 }
3800 },
3801 + "403": {
3802 + "description": "Forbidden - Your role does not allow modifying auth configs",
3803 + "content": {
3804 + "application/json": {
3805 + "schema": {
3806 + "$ref": "#/components/schemas/Error"
3807 + }
3808 + }
3809 + }
3810 + },
3811 "404": {
3812 "description": "Not found - Auth configuration does not exist",
3813 "content": {
@@ -8006,6 +8036,16 @@
8036 }
8037 }
8038 },
8039 + "403": {
8040 + "description": "Your role does not allow modifying webhook subscriptions",
8041 + "content": {
8042 + "application/json": {
8043 + "schema": {
8044 + "$ref": "#/components/schemas/Error"
8045 + }
8046 + }
8047 + }
8048 + },
8049 "409": {
8050 "description": "Subscription already exists",
8051 "content": {
@@ -8438,6 +8478,16 @@
8478 }
8479 }
8480 },
8481 + "403": {
8482 + "description": "Your role does not allow modifying webhook subscriptions",
8483 + "content": {
8484 + "application/json": {
8485 + "schema": {
8486 + "$ref": "#/components/schemas/Error"
8487 + }
8488 + }
8489 + }
8490 + },
8491 "404": {
8492 "description": "Subscription not found",
8493 "content": {
@@ -8515,6 +8565,16 @@
8565 }
8566 }
8567 },
8568 + "403": {
8569 + "description": "Your role does not allow modifying webhook subscriptions",
8570 + "content": {
8571 + "application/json": {
8572 + "schema": {
8573 + "$ref": "#/components/schemas/Error"
8574 + }
8575 + }
8576 + }
8577 + },
8578 "404": {
8579 "description": "Subscription not found",
8580 "content": {
@@ -8601,6 +8661,16 @@
8661 }
8662 }
8663 },
8664 + "403": {
8665 + "description": "Your role does not allow modifying webhook subscriptions",
8666 + "content": {
8667 + "application/json": {
8668 + "schema": {
8669 + "$ref": "#/components/schemas/Error"
8670 + }
8671 + }
8672 + }
8673 + },
8674 "404": {
8675 "description": "Subscription not found",
8676 "content": {
@@ -9902,7 +9972,7 @@
9972 "/api/v3/custom/toolkits/upsert": {
9973 "post": {
9974 "summary": "Upsert a custom toolkit",
9905 - "description": "Experimental: custom toolkits are in pilot and this contract may change. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. app_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
9975 + "description": "Experimental: custom toolkits are in pilot and this contract may change. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. mcp_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
9976 "tags": [
9977 "Toolkits"
9978 ],
@@ -9940,7 +10010,7 @@
10010 "maxLength": 200,
10011 "description": "Display name of the toolkit"
10012 },
9943 - "app_url": {
10013 + "mcp_url": {
10014 "type": "string",
10015 "format": "uri",
10016 "description": "MCP server URL. Must use https."
@@ -10093,7 +10163,7 @@
10163 },
10164 "required": [
10165 "name",
10096 - "app_url",
10166 + "mcp_url",
10167 "auth_schemes"
10168 ],
10169 "additionalProperties": false
@@ -10170,7 +10240,7 @@
10240 }
10241 },
10242 "409": {
10173 - "description": "Conflict - app_url or auth_schemes differ from the registered toolkit; delete and re-register to change them",
10243 + "description": "Conflict - mcp_url or auth_schemes differ from the registered toolkit; delete and re-register to change them",
10244 "content": {
10245 "application/json": {
10246 "schema": {
@@ -11273,7 +11343,7 @@
11343 "/api/v3/tools/enum": {
11344 "get": {
11345 "summary": "Get tool enum list",
11276 - "description": "Retrieve a list of all available tool enumeration values (tool slugs) from latest version of each toolkit. This endpoint returns a comma-separated string of tool slugs that can be used in other API calls.",
11346 + "description": "Lists the slug of every tool in the latest version of each Composio-managed toolkit, such as GMAIL_SEND_EMAIL. Tools of custom toolkits are not included.",
11347 "tags": [
11348 "Tools"
11349 ],
@@ -11296,7 +11366,7 @@
11366 "items": {
11367 "type": "string"
11368 },
11299 - "description": "JSON string containing all tool enum values from latest version of each toolkit"
11369 + "description": "Tool slugs"
11370 }
11371 }
11372 }
@@ -13997,6 +14067,16 @@
14067 }
14068 }
14069 },
14070 + "403": {
14071 + "description": "Forbidden",
14072 + "content": {
14073 + "application/json": {
14074 + "schema": {
14075 + "$ref": "#/components/schemas/Error"
14076 + }
14077 + }
14078 + }
14079 + },
14080 "404": {
14081 "description": "Trigger instance not found",
14082 "content": {
@@ -26174,6 +26254,22 @@
26254 "ApiKeyAuth": []
26255 }
26256 ],
26257 + "parameters": [
26258 + {
26259 + "schema": {
26260 + "type": "string",
26261 + "minLength": 1,
26262 + "maxLength": 256,
26263 + "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
26264 + "example": "user_123",
26265 + "x-experimental": true
26266 + },
26267 + "required": false,
26268 + "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
26269 + "name": "user_id",
26270 + "in": "query"
26271 + }
26272 + ],
26273 "responses": {
26274 "200": {
26275 "description": "Toolkits changelog retrieved successfully",
docs/public/openapi.json
+110 -14
@@ -2959,7 +2959,7 @@
2959 "/api/v3.1/session_configs": {
2960 "get": {
2961 "summary": "List Session configs",
2962 - "description": "List Session configs in your project, newest updated first. Returns active configs by default; set archived=true to list archived configs. Retrieve a config by ID for its description and toolkit, tool, and tag policy. Experimental: available only to projects enabled for Session configs. Create and manage configs in Dashboard.",
2962 + "description": "List Session configs in your project, newest updated first. Returns active configs by default; set archived=true to list archived configs. Retrieve a config by ID for its description and toolkit, tool, and tag policy. Experimental. Create and manage configs in Dashboard.",
2963 "tags": [
2964 "Tool Router"
2965 ],
@@ -3090,7 +3090,7 @@
3090 }
3091 },
3092 "403": {
3093 - "description": "Session configs or read access not enabled for this project.",
3093 + "description": "Forbidden. The API key lacks Session management read access.",
3094 "content": {
3095 "application/json": {
3096 "schema": {
@@ -3126,7 +3126,7 @@
3126 "/api/v3.1/session_configs/{session_config_id}": {
3127 "get": {
3128 "summary": "Retrieve a Session config",
3129 - "description": "Retrieve a saved access policy in your project. config.toolkits.enable selects toolkit slugs; config.toolkits.disable excludes them; an omitted config.toolkits allows all toolkits. Tool and tag rules further restrict access. This returns the saved policy, not an expanded catalog or an existing Session snapshot. Archived configs remain readable but cannot create new Sessions. Experimental: available only to projects enabled for Session configs. Create and manage configs in Dashboard.",
3129 + "description": "Retrieve a saved access policy in your project. config.toolkits.enable selects toolkit slugs; config.toolkits.disable excludes them; an omitted config.toolkits allows all toolkits. Tool and tag rules further restrict access. This returns the saved policy, not an expanded catalog or an existing Session snapshot. Archived configs remain readable but cannot create new Sessions. Experimental. Create and manage configs in Dashboard.",
3130 "tags": [
3131 "Tool Router"
3132 ],
@@ -3473,7 +3473,7 @@
3473 }
3474 },
3475 "403": {
3476 - "description": "Session configs or read access not enabled for this project.",
3476 + "description": "Forbidden. The API key lacks Session management read access.",
3477 "content": {
3478 "application/json": {
3479 "schema": {
@@ -4478,7 +4478,7 @@
4478 "/api/v3.1/tools/enum": {
4479 "get": {
4480 "summary": "Get tool enum list",
4481 - "description": "Retrieve a list of all available tool enumeration values (tool slugs) from latest version of each toolkit. This endpoint returns a comma-separated string of tool slugs that can be used in other API calls.",
4481 + "description": "Lists the slug of every tool in the latest version of each Composio-managed toolkit, such as GMAIL_SEND_EMAIL. Tools of custom toolkits are not included.",
4482 "tags": [
4483 "Tools"
4484 ],
@@ -4501,7 +4501,7 @@
4501 "items": {
4502 "type": "string"
4503 },
4504 - "description": "JSON string containing all tool enum values from latest version of each toolkit"
4504 + "description": "Tool slugs"
4505 }
4506 }
4507 }
@@ -6542,7 +6542,7 @@
6542 "maxLength": 200,
6543 "description": "Display name of the toolkit"
6544 },
6545 - "app_url": {
6545 + "mcp_url": {
6546 "type": "string",
6547 "format": "uri",
6548 "description": "MCP server URL. Must use https."
@@ -6717,7 +6717,7 @@
6717 },
6718 "required": [
6719 "name",
6720 - "app_url",
6720 + "mcp_url",
6721 "auth_schemes",
6722 "user_id"
6723 ],
@@ -7013,7 +7013,7 @@
7013 },
7014 "patch": {
7015 "summary": "Update a custom toolkit",
7016 - "description": "Experimental: this endpoint may change. Updates a custom toolkit's name, logo, or API key field text. Omitted fields keep their current value. To change app_url, auth_schemes, or user_id, delete and re-create the toolkit. On a project with 2FA enabled, updating a private toolkit requires the user_id it is private to.",
7016 + "description": "Experimental: this endpoint may change. Updates a custom toolkit's name, logo, or API key field text. Omitted fields keep their current value. To change mcp_url, auth_schemes, or user_id, delete and re-create the toolkit. On a project with 2FA enabled, updating a private toolkit requires the user_id it is private to.",
7017 "tags": [
7018 "Toolkits"
7019 ],
@@ -13264,7 +13264,7 @@
13264 }
13265 },
13266 "403": {
13267 - "description": "Session configs are not enabled for this project.",
13267 + "description": "Forbidden. The caller cannot modify this Session.",
13268 "content": {
13269 "application/json": {
13270 "schema": {
@@ -18646,6 +18646,16 @@
18646 }
18647 }
18648 },
18649 + "403": {
18650 + "description": "Forbidden - Your role does not allow modifying auth configs",
18651 + "content": {
18652 + "application/json": {
18653 + "schema": {
18654 + "$ref": "#/components/schemas/Error"
18655 + }
18656 + }
18657 + }
18658 + },
18659 "404": {
18660 "description": "Not found - Auth configuration does not exist",
18661 "content": {
@@ -18759,6 +18769,16 @@
18769 }
18770 }
18771 },
18772 + "403": {
18773 + "description": "Forbidden - Your role does not allow modifying auth configs",
18774 + "content": {
18775 + "application/json": {
18776 + "schema": {
18777 + "$ref": "#/components/schemas/Error"
18778 + }
18779 + }
18780 + }
18781 + },
18782 "404": {
18783 "description": "Auth config not found - The specified configuration does not exist or was already deleted",
18784 "content": {
@@ -18869,6 +18889,16 @@
18889 }
18890 }
18891 },
18892 + "403": {
18893 + "description": "Forbidden - Your role does not allow modifying auth configs",
18894 + "content": {
18895 + "application/json": {
18896 + "schema": {
18897 + "$ref": "#/components/schemas/Error"
18898 + }
18899 + }
18900 + }
18901 + },
18902 "404": {
18903 "description": "Not found - Auth configuration does not exist",
18904 "content": {
@@ -23097,6 +23127,16 @@
23127 }
23128 }
23129 },
23130 + "403": {
23131 + "description": "Your role does not allow modifying webhook subscriptions",
23132 + "content": {
23133 + "application/json": {
23134 + "schema": {
23135 + "$ref": "#/components/schemas/Error"
23136 + }
23137 + }
23138 + }
23139 + },
23140 "409": {
23141 "description": "Subscription already exists",
23142 "content": {
@@ -23529,6 +23569,16 @@
23569 }
23570 }
23571 },
23572 + "403": {
23573 + "description": "Your role does not allow modifying webhook subscriptions",
23574 + "content": {
23575 + "application/json": {
23576 + "schema": {
23577 + "$ref": "#/components/schemas/Error"
23578 + }
23579 + }
23580 + }
23581 + },
23582 "404": {
23583 "description": "Subscription not found",
23584 "content": {
@@ -23606,6 +23656,16 @@
23656 }
23657 }
23658 },
23659 + "403": {
23660 + "description": "Your role does not allow modifying webhook subscriptions",
23661 + "content": {
23662 + "application/json": {
23663 + "schema": {
23664 + "$ref": "#/components/schemas/Error"
23665 + }
23666 + }
23667 + }
23668 + },
23669 "404": {
23670 "description": "Subscription not found",
23671 "content": {
@@ -23692,6 +23752,16 @@
23752 }
23753 }
23754 },
23755 + "403": {
23756 + "description": "Your role does not allow modifying webhook subscriptions",
23757 + "content": {
23758 + "application/json": {
23759 + "schema": {
23760 + "$ref": "#/components/schemas/Error"
23761 + }
23762 + }
23763 + }
23764 + },
23765 "404": {
23766 "description": "Subscription not found",
23767 "content": {
@@ -24993,7 +25063,7 @@
25063 "/api/v3.1/custom/toolkits/upsert": {
25064 "post": {
25065 "summary": "Upsert a custom toolkit",
24996 - "description": "Experimental: custom toolkits are in pilot and this contract may change. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. app_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
25066 + "description": "Experimental: custom toolkits are in pilot and this contract may change. Creates a custom toolkit for the project with the provided slug, or updates its display metadata (name, API key field copy) when the project already owns a toolkit with that slug. A toolkit created here is shared with every user in the project; an existing toolkit keeps its access. mcp_url and auth_schemes cannot be changed on an existing toolkit: re-sending them unchanged is a no-op, changing them returns 409 (delete and re-register the toolkit instead, which revokes its connections).",
25067 "tags": [
25068 "Toolkits"
25069 ],
@@ -25031,7 +25101,7 @@
25101 "maxLength": 200,
25102 "description": "Display name of the toolkit"
25103 },
25034 - "app_url": {
25104 + "mcp_url": {
25105 "type": "string",
25106 "format": "uri",
25107 "description": "MCP server URL. Must use https."
@@ -25184,7 +25254,7 @@
25254 },
25255 "required": [
25256 "name",
25187 - "app_url",
25257 + "mcp_url",
25258 "auth_schemes"
25259 ],
25260 "additionalProperties": false
@@ -25261,7 +25331,7 @@
25331 }
25332 },
25333 "409": {
25264 - "description": "Conflict - app_url or auth_schemes differ from the registered toolkit; delete and re-register to change them",
25334 + "description": "Conflict - mcp_url or auth_schemes differ from the registered toolkit; delete and re-register to change them",
25335 "content": {
25336 "application/json": {
25337 "schema": {
@@ -27272,6 +27342,16 @@
27342 }
27343 }
27344 },
27345 + "403": {
27346 + "description": "Forbidden",
27347 + "content": {
27348 + "application/json": {
27349 + "schema": {
27350 + "$ref": "#/components/schemas/Error"
27351 + }
27352 + }
27353 + }
27354 + },
27355 "404": {
27356 "description": "Trigger instance not found",
27357 "content": {
@@ -32786,6 +32866,22 @@
32866 "ApiKeyAuth": []
32867 }
32868 ],
32869 + "parameters": [
32870 + {
32871 + "schema": {
32872 + "type": "string",
32873 + "minLength": 1,
32874 + "maxLength": 256,
32875 + "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
32876 + "example": "user_123",
32877 + "x-experimental": true
32878 + },
32879 + "required": false,
32880 + "description": "[EXPERIMENTAL] Include the custom toolkits this user can use. Without it, only custom toolkits with access \"all\" are included.",
32881 + "name": "user_id",
32882 + "in": "query"
32883 + }
32884 + ],
32885 "responses": {
32886 "200": {
32887 "description": "Toolkits changelog retrieved successfully",
pnpm-lock.yaml
+9 -9
@@ -28,8 +28,8 @@ catalogs:
28 specifier: ^5.20261019.1
29 version: 5.20261019.1
30 '@composio/client':
31 - specifier: 2.0.1
32 - version: 2.0.1
31 + specifier: 2.1.0
32 + version: 2.1.0
33 '@effect/language-service':
34 specifier: ^0.87.5
35 version: 0.87.5
@@ -998,7 +998,7 @@ importers:
998 dependencies:
999 '@composio/client':
1000 specifier: 'catalog:'
1001 - version: 2.0.1(effect@4.1.1)
1001 + version: 2.1.0(effect@4.1.1)
1002 '@composio/core':
1003 specifier: workspace:*
1004 version: link:../../packages/core
@@ -1246,7 +1246,7 @@ importers:
1246 version: link:../cli-keyring
1247 '@composio/client':
1248 specifier: 'catalog:'
1249 - version: 2.0.1(effect@4.1.1)
1249 + version: 2.1.0(effect@4.1.1)
1250 '@composio/core':
1251 specifier: workspace:*
1252 version: link:../core
@@ -1355,7 +1355,7 @@ importers:
1355 dependencies:
1356 '@composio/client':
1357 specifier: 'catalog:'
1358 - version: 2.0.1(effect@4.1.1)
1358 + version: 2.1.0(effect@4.1.1)
1359 '@composio/json-schema-to-zod':
1360 specifier: workspace:*
1361 version: link:../json-schema-to-zod
@@ -1772,7 +1772,7 @@ importers:
1772 dependencies:
1773 '@composio/client':
1774 specifier: 'catalog:'
1775 - version: 2.0.1(effect@4.1.1)
1775 + version: 2.1.0(effect@4.1.1)
1776 '@composio/json-schema-to-zod':
1777 specifier: workspace:*
1778 version: link:../json-schema-to-zod
@@ -2324,8 +2324,8 @@ packages:
2324 resolution: {integrity: sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==}
2325 engines: {node: '>=0.1.90'}
2326
2327 - '@composio/client@2.0.1':
2328 - resolution: {integrity: sha512-1+Azl8W/grinmXVt6KhDKy5UlvTiv7MCMgjqBDxd8TqndjM92/HotxLabnB63A285bvo5Lcu4kbOz413uaPmEQ==}
2327 + '@composio/client@2.1.0':
2328 + resolution: {integrity: sha512-tAHMxlv4rfeWBCuyNbs9g7eUJ8eCwpJ+Hdv7MSGVvT1LTbIu/O9reUaL7XC5Oqa84UO/+SPJZhqx4YKK10UKGg==}
2329 engines: {node: '>=22'}
2330 peerDependencies:
2331 effect: '*'
@@ -7541,7 +7541,7 @@ snapshots:
7541 '@colors/colors@1.5.0':
7542 optional: true
7543
7544 - '@composio/client@2.0.1(effect@4.1.1)':
7544 + '@composio/client@2.1.0(effect@4.1.1)':
7545 optionalDependencies:
7546 effect: 4.1.1
7547
pnpm-workspace.yaml
+1 -1
@@ -33,7 +33,7 @@ catalog:
33 '@clack/prompts': '^1.8.1'
34 '@cloudflare/vitest-pool-workers': 0.23.0
35 '@cloudflare/workers-types': ^5.20261019.1
36 - '@composio/client': 2.0.1
36 + '@composio/client': 2.1.0
37 '@effect/language-service': ^0.87.5
38 '@effect/platform-bun': ^4.1.0
39 '@effect/vitest': ^4.1.0
python/composio/core/models/experimental.py
+6 -6
@@ -177,11 +177,11 @@ class ExperimentalCustomToolkits:
177
178 Set ``user_id`` to ``"all"`` to share the toolkit with every user in
179 the project, or to a user ID to make it private to that user.
180 - ``app_url``, ``auth_schemes`` and ``user_id`` cannot change later:
180 + ``mcp_url``, ``auth_schemes`` and ``user_id`` cannot change later:
181 delete and re-create the toolkit instead.
182
183 :param name: Display name of the toolkit.
184 - :param app_url: The MCP server URL. Must use https.
184 + :param mcp_url: The MCP server URL. Must use https.
185 :param auth_schemes: How users authenticate to the MCP server.
186 :param user_id: ``"all"``, or the user ID the toolkit is private to.
187 :param logo_file: Optional base64 PNG or JPEG logo.
@@ -193,7 +193,7 @@ class ExperimentalCustomToolkits:
193 Example:
194 toolkit = composio.experimental.custom_toolkits.create(
195 name="Internal API",
196 - app_url="https://mcp.internal.example.com/mcp",
196 + mcp_url="https://mcp.internal.example.com/mcp",
197 auth_schemes=[
198 {
199 "mode": "API_KEY",
@@ -249,14 +249,14 @@ class ExperimentalCustomToolkits:
249 its name, logo or API key field. ``create`` generates the slug,
250 so store the slug it returns.
251
252 - ``app_url`` and ``auth_schemes`` cannot change on an existing
252 + ``mcp_url`` and ``auth_schemes`` cannot change on an existing
253 toolkit: re-sending them unchanged is a no-op, and changing them fails
254 with a 409. Delete and re-register the toolkit instead, which revokes
255 its connections.
256
257 :param slug: Letters, digits, underscores or spaces (max 30). The API
258 prefixes it with ``CUSTOM_`` and turns spaces into underscores.
259 - :param toolkit_config: ``name``, ``app_url`` (the MCP URL for MCP
259 + :param toolkit_config: ``name``, ``mcp_url`` (the MCP URL for MCP
260 apps), ``auth_schemes`` and an optional base64 ``logo_file``.
261 :return: The toolkit's ``slug``.
262
@@ -265,7 +265,7 @@ class ExperimentalCustomToolkits:
265 slug="INTERNAL_API",
266 toolkit_config={
267 "name": "Internal API",
268 - "app_url": "https://mcp.internal.example.com/mcp",
268 + "mcp_url": "https://mcp.internal.example.com/mcp",
269 "auth_schemes": [
270 {
271 "mode": "API_KEY",
python/pyproject.toml
+1 -1
@@ -14,7 +14,7 @@ dependencies = [
14 "pysher==1.0.8",
15 "websocket-client<2",
16 "pydantic>=2.11.9,<3",
17 - "composio-client==2.0.1",
17 + "composio-client==2.1.0",
18 "typing-extensions>=4.16.0,<5",
19 "openai>=2.48.0,<4",
20 "json-schema-to-pydantic>=0.4.11,<1",
python/setup.py
+1 -1
@@ -28,7 +28,7 @@ setup(
28 "pysher==1.0.8",
29 "websocket-client<2",
30 "pydantic>=2.11.9,<3",
31 - "composio-client==2.0.1",
31 + "composio-client==2.1.0",
32 "typing-extensions>=4.16.0,<5",
33 "openai>=2.48.0,<4",
34 "json-schema-to-pydantic>=0.4.11,<1",
python/tests/test_experimental_custom_toolkits.py
+1 -1
@@ -16,7 +16,7 @@ from composio.core.models.experimental import (
16
17 TOOLKIT_CONFIG: custom_upsert_params.ToolkitConfig = {
18 "name": "My Toolkit",
19 - "app_url": "https://mcp.example.com/mcp",
19 + "mcp_url": "https://mcp.example.com/mcp",
20 "auth_schemes": [
21 {
22 "mode": "API_KEY",
ts/packages/cli/CHANGELOG.md
+2
@@ -4,6 +4,8 @@
4
5 ### Patch Changes
6
7 +- Update @composio/client to 2.1.0 to include the latest API changes.
8 +
9 - Update Effect and its Bun and Vitest integrations to `^4.1.0`.
10
11 ### Minor Changes
ts/packages/core/src/utils/transformers/customToolkits.ts
+2 -2
@@ -73,7 +73,7 @@ export const transformCustomToolkitCreateParams = (
73 params: CustomToolkitCreateParams
74 ): RawCustomCreateToolkitParams => ({
75 name: params.name,
76 - app_url: params.appUrl,
76 + mcp_url: params.appUrl,
77 logo_file: transformCustomToolkitLogoFile(params.logoFile),
78 auth_schemes: params.authSchemes.map(transformCustomToolkitAuthScheme),
79 user_id: params.userId,
@@ -118,7 +118,7 @@ export const transformCustomToolkitUpsertParams = (
118 slug: params.slug,
119 toolkit_config: {
120 name: params.toolkitConfig.name,
121 - app_url: params.toolkitConfig.appUrl,
121 + mcp_url: params.toolkitConfig.appUrl,
122 logo_file: transformCustomToolkitLogoFile(params.toolkitConfig.logoFile),
123 auth_schemes: params.toolkitConfig.authSchemes.map(transformCustomToolkitAuthScheme),
124 },
ts/packages/core/test/models/customToolkits.test.ts
+3 -3
@@ -78,7 +78,7 @@ describe('Experimental.customToolkits', () => {
78 const [body, options] = mockClient.custom.createToolkit.mock.calls[0];
79 expect(JSON.parse(JSON.stringify(body))).toEqual({
80 name: 'My Toolkit',
81 - app_url: 'https://mcp.example.com/mcp',
81 + mcp_url: 'https://mcp.example.com/mcp',
82 logo_file: { content: 'aGVsbG8=', mime_type: 'image/png' },
83 auth_schemes: [
84 {
@@ -238,7 +238,7 @@ describe('Experimental.customToolkits', () => {
238 slug: 'MY TOOLKIT',
239 toolkit_config: {
240 name: 'My Toolkit',
241 - app_url: 'https://mcp.example.com/mcp',
241 + mcp_url: 'https://mcp.example.com/mcp',
242 logo_file: { content: 'aGVsbG8=', mime_type: 'image/png' },
243 auth_schemes: [
244 { mode: 'NO_AUTH' },
@@ -276,7 +276,7 @@ describe('Experimental.customToolkits', () => {
276 slug: 'MY_TOOLKIT',
277 toolkit_config: {
278 name: 'My Toolkit',
279 - app_url: 'https://mcp.example.com/mcp',
279 + mcp_url: 'https://mcp.example.com/mcp',
280 auth_schemes: [{ mode: 'API_KEY', headers: { 'x-api-key': '{{generic_api_key}}' } }],
281 },
282 });
uv.lock
+4 -4
@@ -534,7 +534,7 @@ release = [
534 [package.metadata]
535 requires-dist = [
536 { name = "certifi", specifier = ">=2026.10.19" },
537 - { name = "composio-client", specifier = "==2.0.1" },
537 + { name = "composio-client", specifier = "==2.1.0" },
538 { name = "json-schema-to-pydantic", specifier = ">=0.4.11,<1" },
539 { name = "jsonschema", specifier = ">=4.23.0,<5" },
540 { name = "openai", specifier = ">=2.48.0,<4" },
@@ -586,16 +586,16 @@ requires-dist = [
586
587 [[package]]
588 name = "composio-client"
589 -version = "2.0.1"
589 +version = "2.1.0"
590 source = { registry = "https://pypi.org/simple" }
591 dependencies = [
592 { name = "httpx" },
593 { name = "pydantic" },
594 { name = "typing-extensions" },
595 ]
596 -sdist = { url = "https://files.pythonhosted.org/packages/11/69/0e6e74fcd32748c9c2f58604e92e1a9fd293033231250d61b35d6a7a93e4/composio_client-2.0.1.tar.gz", hash = "sha256:d23d185b5a45f6628263a37db56567bd8dab6b1dabc0de899ea8ce389b29517b", size = 591542, upload-time = "2026-11-03T11:21:56.274Z" }
596 +sdist = { url = "https://files.pythonhosted.org/packages/d9/ab/d3d66a62c13db1c6dfac59630ee26171d1b038f3d4894310abbf82c2d8d4/composio_client-2.1.0.tar.gz", hash = "sha256:58bfa5cd3cd6da1dd9a70692ca795f1a88074f64c5d853d1c219cce4df346234", size = 592013, upload-time = "2026-11-05T12:11:37.958Z" }
597 wheels = [
598 - { url = "https://files.pythonhosted.org/packages/2e/d7/d4ca7bbbbf4c8b3b2e232e029313a8d59a4dd2f9396683806218f0eefaae/composio_client-2.0.1-py3-none-any.whl", hash = "sha256:e9a24a0883dfa67e19c3d70e0cfe1034cf427411c70edf5e5f4925e4e4d73845", size = 477792, upload-time = "2026-11-03T11:21:54.465Z" },
598 + { url = "https://files.pythonhosted.org/packages/c0/8f/9e64de6f670dbefbec7aaa03b3fca52c28b44b204478861475062a683be7/composio_client-2.1.0-py3-none-any.whl", hash = "sha256:6b1a57ead7fecae314b65b3f10c6f2e537e51de3c9013151f6888208d4997fe4", size = 478016, upload-time = "2026-11-05T12:11:36.218Z" },
599 ]
600
601 [[package]]