Composio SDK renames custom tools to local tools and appUrl to mcpUrl (November 9, 2026)

What changed

Composio shipped TypeScript @composio/core 0.29.0, @composio/slim 0.29.0 and Python composio 0.32.0.

• Breaking (experimental): create() and upsert() on custom toolkits now take the MCP server URL as mcpUrl in TypeScript (sent as mcp_url) and as mcp_url in Python. These replace appUrl and app_url.
• Rename: in-process custom tools are now called local tools.
  • TypeScript: experimental.localTools and experimental.localToolkits in composio.create(); localTools and localToolkits in composio.use(); session.localTools() and session.localToolkits().
  • Python: experimental={"local_tools": ..., "local_toolkits": ...} in composio.create(); local_tools= and local_toolkits= in composio.use(); session.local_tools() and session.local_toolkits().
  • The API request itself is unchanged.
• Deprecated but still working: in TypeScript, customTools, customToolkits, session.customTools(), session.customToolkits() and the Custom* type names. In Python, custom_tools and custom_toolkits now emit ComposioDeprecationWarning.
• If you pass a new option together with its deprecated alias, TypeScript throws ValidationError and Python raises InvalidParams.
• TypeScript: rate-limited calls throw ComposioToolFetchRateLimitError or ComposioToolExecutionRateLimitError. Check for them with isComposioRateLimitError. waitForConnection() now backs off between polls and waits out 429 responses.
• Python: wait_for_connection() polls at 1 to 5 seconds and honours on a 429.