Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
fix: grammar and language
[email protected]d20fc5d58feb
diff --git a/fern/pages/src/authentication/custom-auth-configs.mdx b/fern/pages/src/authentication/custom-auth-configs.mdxindex 4ed98f4a4..8f9fd2b9f 100644--- a/fern/pages/src/authentication/custom-auth-configs.mdx+++ b/fern/pages/src/authentication/custom-auth-configs.mdx@@ -1,14 +1,14 @@---title: Custom Auth Configsimage: "https://og.composio.dev/api/og?title=Custom%20Auth%20Configs" # image for socials-subtitle: 'Guide to using customising auth configs for a toolkit '+subtitle: 'Guide to customizing auth configs for a toolkit'keywords: ''hide-nav-links: true----Many toolkits support a level of customisation for the auth config, specifically OAuth applications.+Many toolkits support a level of customization for the auth config, specifically OAuth applications.-This guide will walk you through the process of customising the auth config for toolkits where you can configure the developer app.+This guide will walk you through the process of customizing the auth config for toolkits where you can configure the developer app.## Creating a custom auth config@@ -26,7 +26,7 @@ You may change the subdomain for the PostHog toolkit to match your own instance.<Tab title="Example: Hubspot">For Hubspot you may customize everything here. For each auth scheme there is a different set of fields.-If you choose to use your own developer app for OAuth2 scheme, you will have to provide the client ID and client secret.+If you choose to use your own developer app for the OAuth2 scheme, you will have to provide the client ID and client secret.<Frame background="subtle" title="Hubspot Auth Config Settings"><img src="../../../assets/images/custom-auth-hubspot.png" />@@ -37,9 +37,9 @@ If you choose to use your own developer app for OAuth2 scheme, you will have toToolkits that support OAuth2 allow using your own developer app. This is the recommended approach for most cases.<Tip title="Use your own developer app!" icon="exclamation">-We recommend using your own developer app for OAuth2 scheme as it is suited more for production usage with many users and more granular control over scopes.+We recommend using your own developer app for the OAuth2 scheme as it is more suited for production usage with many users and more granular control over scopes.-However getting OAuth approvals takes time so Composio provides a default developer app!+However, getting OAuth approvals takes time, so Composio provides a default developer app!</Tip>@@ -130,7 +130,7 @@ By default the users will see an OAuth screen like the one below:<img src="../../../assets/images/oauth-branding.png" /></Frame>-The OAuth redirect URL is surfaced in the some OAuth providers' consent screens. This may cause confusion for some users as that URL is not of the same domain as the application.+The OAuth redirect URL is surfaced in some OAuth providers' consent screens. This may cause confusion for some users as that URL is not of the same domain as the application.To remediate this:@@ -203,7 +203,7 @@ res.redirect(302, redirectUrl);</CodeGroup></Step><Step title="Create the auth config">-Specify the your custom redirect URI in the auth config settings!+Specify your custom redirect URI in the auth config settings!<Frame background="subtle" title="Auth Config Settings"><img src="../../../assets/images/custom-redirect-uri.png" />diff --git a/fern/pages/src/authentication/custom-auth-params.mdx b/fern/pages/src/authentication/custom-auth-params.mdxindex bac7a6ba3..ae6067571 100644--- a/fern/pages/src/authentication/custom-auth-params.mdx+++ b/fern/pages/src/authentication/custom-auth-params.mdx@@ -6,7 +6,7 @@ keywords: ""hide-nav-links: true----In case Composio is not being used for managing the auth but only for the tools. It is possible to use the `beforeExecute` hook to inject custom auth headers or parameters for a toolkit.+In cases where Composio is not being used for managing the auth but only for the tools, it is possible to use the `beforeExecute` hook to inject custom auth headers or parameters for a toolkit.## Setup and Initializationdiff --git a/fern/pages/src/authentication/programmatic-auth-configs.mdx b/fern/pages/src/authentication/programmatic-auth-configs.mdxindex 89e04ae77..563eded0b 100644--- a/fern/pages/src/authentication/programmatic-auth-configs.mdx+++ b/fern/pages/src/authentication/programmatic-auth-configs.mdx@@ -6,7 +6,7 @@ keywords: ""hide-nav-links: true----Auth configs are created once and reused many times. However when dealing with many toolkits, you may want to create auth configs programmatically.+Auth configs are created once and reused many times. However, when dealing with many toolkits, you may want to create auth configs programmatically.- When creating and destroying auth configs multiple times in your app's lifecycle.- When creating auth configs for your users' users.diff --git a/fern/pages/src/examples/gmail-filterer.mdx b/fern/pages/src/examples/gmail-filterer.mdxindex 8f2e13f54..f67d51761 100644--- a/fern/pages/src/examples/gmail-filterer.mdx+++ b/fern/pages/src/examples/gmail-filterer.mdx@@ -21,7 +21,7 @@ The complete app is available in our [`filter-gmails-example`](https://github.coExplore the complete source code on GitHub</Card>-In this guide, we'll focus on the Composio + OpenAI Agents part of the app+In this guide, we'll focus on the Composio + OpenAI Agents part of the app.## Prerequisites- Clone the [`filter-gmails-example`](https://github.com/ComposioHQ/filter-gmails-example) repository and set the project up locally.@@ -31,7 +31,7 @@ In this guide, we'll focus on the Composio + OpenAI Agents part of the app## Creating Triggers for users[Triggers](/docs/using-triggers) are a way to listen for events from apps. They act as a notification system for your AI applications, enabling your agents to respond dynamically to external events occurring within your apps.-In some cases, triggers require certain configuration to set the correct events. You can inspect and add these properties while enabling the triggers.+In some cases, triggers require certain configurations to set the correct events. You can inspect and add these properties while enabling the triggers.<SnippetCodegithubUrl="https://github.com/ComposioHQ/filter-gmails-example/blob/master/apps/backend/email_processor.py#L135-L156"@@ -68,7 +68,7 @@ This is the main webhook endpoint for processing Gmail new message events.Composio sends a POST request to the webhook endpoint `/composio/webhook` that contains the event data.-It is parsed and then the labelling method `process_gmail_message` is called through a FastAPI Background task.+It is parsed and then the labeling method `process_gmail_message` is called through a FastAPI Background task.```python apps/backend/main.py {1-5, 29-33} maxLines=33@app.post("/composio/webhook")@@ -126,7 +126,7 @@ The `process_gmail_message` method is responsible for processing the email usingtitle="apps/backend/email_processor.py"/>-We read the first 10k characters of the email body to pass it to the agent. This is done to not overwhelm or surpass the token limits in case of really long emails.+We read the first 10k characters of the email body to pass it to the agent. This is done to avoid overwhelming or surpassing the token limits in case of really long emails.<SnippetCodegithubUrl="https://github.com/ComposioHQ/filter-gmails-example/blob/master/apps/backend/email_processor.py#L50-L60"@@ -175,4 +175,4 @@ In the `/composio/webhook` endpoint, we verify the webhook signature and then pa## InspirationThis example was inspired by an X/Twitter post by [@FarzaTV](https://x.com/FarzaTV/status/1905371012369350857).-We encourage you to check out the [full app](https://github.com/ComposioHQ/filter-gmails-example), fork it, build it and make it your own! Reach out to [[email protected]](mailto:[email protected]) for free credits ;)+We encourage you to check out the [full app](https://github.com/ComposioHQ/filter-gmails-example), fork it, build it, and make it your own! Reach out to [[email protected]](mailto:[email protected]) for free credits ;)diff --git a/fern/pages/src/examples/sample-script.mdx b/fern/pages/src/examples/sample-script.mdxindex cf0ef6a13..6037c9fba 100644--- a/fern/pages/src/examples/sample-script.mdx+++ b/fern/pages/src/examples/sample-script.mdx@@ -1,7 +1,7 @@---title: Sample Scriptimage: "https://og.composio.dev/api/og?title=Sample%20Script" # image for socials-description: "A simple example of python script that uses the Composio SDK to call tools."+description: "A simple example of a Python script that uses the Composio SDK to call tools."keywords: "hello world python, composio, sdk, tool calling"subtitle: ""hide-nav-links: truediff --git a/fern/pages/src/examples/sample-webserver/sample-webserver.mdx b/fern/pages/src/examples/sample-webserver/sample-webserver.mdxindex ef481c8d2..067f90321 100644--- a/fern/pages/src/examples/sample-webserver/sample-webserver.mdx+++ b/fern/pages/src/examples/sample-webserver/sample-webserver.mdx@@ -7,12 +7,12 @@ subtitle: ""hide-nav-links: true----This tutorial shows you a minimal example of a web server that can use composio+This tutorial shows you a minimal example of a web server that can use Composio.### Install dependencies-using `bun` for this example, it is super convenient for rapid prototyping.+Using `bun` for this example, it is super convenient for rapid prototyping.```bashbun install @composio/core@next openai hono@@ -46,11 +46,11 @@ Basic scaffolding for the server.### Auth Configs-These are configurations for tools that control how they are authorized, the scopes and permissions they have. You can learn more about them [here](/authenticating-tools).+These are configurations for tools that control how they are authorized, the scopes, and permissions they have. You can learn more about them [here](/authenticating-tools).For this example, we will create a basic GMAIL auth config.-You are recommend to store these config ids, so that you can reuse them later.+You are recommended to store these config IDs, so that you can reuse them later.<SnippetCodesrc="./index.ts"@@ -64,7 +64,7 @@ You are recommend to store these config ids, so that you can reuse them later.Connections are your users authorizing your tools.-Here we start the connection process, once your user uses the `redirectUrl` from the response,+Here we start the connection process. Once your user uses the `redirectUrl` from the response,they will be redirected to the auth flow.Once they have authorized the connection, you can use the `id` to get and execute the tools as the user.@@ -114,19 +114,19 @@ You can see the full code [here](https://github.com/ComposioHQ/composio/blob/nex### What just happened?-Well first - we created an instance of our `gmail` tool with our default auth config, then our user authorized that tool with their account and some permissions.+Well, first - we created an instance of our `gmail` tool with our default auth config, then our user authorized that tool with their account and some permissions.-Then we used that `gmail` tool by giving it to OpenAI's `gpt-4o`. The model composed the email and sent it correctly formatted to the composio team.+Then we used that `gmail` tool by giving it to OpenAI's `gpt-4o`. The model composed the email and sent it correctly formatted to the Composio team.### What's next?-This is a fairly basic example, but you can do a lot more with our sdk.+This is a fairly basic example, but you can do a lot more with our SDK.Recommended further reading:- [Authenticating tools](/authenticating-tools) - understand how to control tool authorization- [Executing Tools](/executing-tools) - understand how tool execution works-- [Providers](/providers) - want to use something other than OpenAI? we probably support it+- [Providers](/providers) - want to use something other than OpenAI? We probably support it- [Tools](/tools) - understand what tools we havediff --git a/fern/pages/src/examples/tool-generator.mdx b/fern/pages/src/examples/tool-generator.mdxindex 49ebc675c..2c9e9e913 100644--- a/fern/pages/src/examples/tool-generator.mdx+++ b/fern/pages/src/examples/tool-generator.mdx@@ -1,30 +1,30 @@---title: Tool Type Generatorimage: "https://og.composio.dev/api/og?title=Tool%20Type%20Generator" # image for socials-description: "An example that show you how to showcase auth scheme and action params for tools"+description: "An example that shows you how to showcase auth scheme and action params for tools"keywords: "tool type generator, composio, sdk, tool calling"subtitle: "using raw tool definition to build your own platform on top of Composio"hide-nav-links: true----This is a bit of a checky tutorial as it is dogfooding the `docs` tool generation process.+This is a bit of a cheeky tutorial as it is dogfooding the `docs` tool generation process.-To motivate this example clearly, in our tools section — we have details about let's say [`Github`](/tools/github) tool, that shows its auth scheme, actions and their params.+To motivate this example clearly, in our tools section — we have details about, let's say, the [`Github`](/tools/github) tool, that shows its auth scheme, actions, and their params.-Now why would anyone outside of Composio want to do this? Well if you are building a platform on top of Composio, perchance a Workflow builder like langflow. You would want to show some or all of this information to your users.+Now why would anyone outside of Composio want to do this? Well, if you are building a platform on top of Composio, perhaps a workflow builder like Langflow, you would want to show some or all of this information to your users.-This is a non standard use case, that we support and love users building on top of us but if this is uninteresting to you, you can skip this tutorial.+This is a non-standard use case that we support and love users building on top of us, but if this is uninteresting to you, you can skip this tutorial.## How does one build a tool type generator?-In composio, we have two internal states for tools+In Composio, we have two internal states for tools:1. Raw tool definition2. Provider tool definition-The raw tool definition is an generic input output schema definition that we internally for tools, we expose it for customers if they want to build on top of it but it is not the primary way tools are normally used.+The raw tool definition is a generic input-output schema definition that we use internally for tools. We expose it for customers if they want to build on top of it, but it is not the primary way tools are normally used.-The provider tool definition, translates this raw tool definition to the specific schema of a provider (by default `openai`).+The provider tool definition translates this raw tool definition to the specific schema of a provider (by default `openai`).For building something like this, we need to use the raw tool definition.diff --git a/fern/pages/src/examples/vercel-composio.mdx b/fern/pages/src/examples/vercel-composio.mdxindex 906f5da01..9684e045b 100644--- a/fern/pages/src/examples/vercel-composio.mdx+++ b/fern/pages/src/examples/vercel-composio.mdx@@ -16,7 +16,7 @@ You can find the demo live [here](https://chat.composio.dev/).## Prerequisites-Ensure you've followed the README.md in the [composiohq/chat](https://github.com/composiohq/chat) repository to set the project locally.+Ensure you've followed the README.md in the [composiohq/chat](https://github.com/composiohq/chat) repository to set up the project locally.## Creating auth configs@@ -32,7 +32,7 @@ Once done, your auth configs will be available in the [Composio dashboard](https### Save auth config IDs to environment variables-For this project, the auth config IDs should be saved the the environment variables with the `NEXT_PUBLIC_` prefix.+For this project, the auth config IDs should be saved to the environment variables with the `NEXT_PUBLIC_` prefix.```bash .env.localNEXT_PUBLIC_GMAIL_AUTH_CONFIG_ID=ac_1234567890@@ -41,7 +41,7 @@ NEXT_PUBLIC_GITHUB_AUTH_CONFIG_ID=ac_1234567890## Create a Composio client instance-We create a Composio client instance for server-side operations like, API routes, server components, etc.+We create a Composio client instance for server-side operations like API routes, server components, etc.```typescript lib/service/composio.tsimport { Composio } from '@composio/core';diff --git a/fern/pages/src/get-started/dev-setup.mdx b/fern/pages/src/get-started/dev-setup.mdxindex 421c6b5ba..1266bb62d 100644--- a/fern/pages/src/get-started/dev-setup.mdx+++ b/fern/pages/src/get-started/dev-setup.mdx@@ -7,7 +7,7 @@ keywords: ''hide-nav-links: false----This comprehensive guide explains how to setup your IDE and coding agents to help you ship faster with Composio. We'll cover optimal configurations for popular editors and AI coding assistants.+This comprehensive guide explains how to set up your IDE and coding agents to help you ship faster with Composio. We'll cover optimal configurations for popular editors and AI coding assistants.## CursorCursor is an AI-powered code editor that can significantly accelerate your development with Composio. Here's how to set it up optimally.@@ -50,8 +50,8 @@ To get the best experience building with Composio, add custom instructions to Cu<CodeGroup>```md TypeScriptYou are the best TypeScript developer known for your high taste and usage of new and cutting-edge practices.-You are building with Composio's TypeScript SDK. Composio is platform for building with authenticated tools for AI agents and workflows.-It lets you build agents that that can work across a user's apps like Gmail, Notion, Slack.+You are building with Composio's TypeScript SDK. Composio is a platform for building with authenticated tools for AI agents and workflows.+It lets you build agents that can work across a user's apps like Gmail, Notion, Slack.Below is a list of Composio documentation. Use your web and fetch capabilities to read the documentation you need.[Composio Documentation](https://v3.docs.composio.dev)@@ -61,12 +61,12 @@ Below is a list of Composio documentation. Use your web and fetch capabilities t- [Providers](https://v3.docs.composio.dev/docs/providers.mdx)- [Executing Tools](https://v3.docs.composio.dev/docs/executing-tools.mdx): Learn how to execute Composio's tools with different providers and frameworks- [Authenticating Tools](https://v3.docs.composio.dev/docs/authenticating-tools.mdx): Learn how to authenticate tools-- [Fetching and Filtering Tools](https://v3.docs.composio.dev/docs/fetching-tools.mdx): Learn how to fetch and filter Composio's tools and toolsets+- [Fetching and Filtering Tools](https://v3.docs.composio.dev/docs/fetching-tools.mdx): Learn how to fetch and filter Composio's tools and toolkits- [Schema Modifiers](https://v3.docs.composio.dev/docs/modifiers/schema-modifiers.mdx): Learn how to use schema modifiers to transform tool schemas before they are seen by agents.- [Before Execution Modifiers](https://v3.docs.composio.dev/docs/modifiers/before-execution.mdx): Learn how to use before execution modifiers to modify tool arguments before execution.- [After Execution Modifiers](https://v3.docs.composio.dev/docs/modifiers/after-execution.mdx): Learn how to use after execution modifiers to transform tool results after execution.- [Creating custom tools](https://v3.docs.composio.dev/docs/custom-tools.mdx): Learn how to extend Composio's toolkits with your own tools-- [Custom Auth Configs](https://v3.docs.composio.dev/docs/custom-auth-configs.mdx): Guide to using customising auth configs for a toolkit+- [Custom Auth Configs](https://v3.docs.composio.dev/docs/custom-auth-configs.mdx): Guide to using customizing auth configs for a toolkit- [Programmatic Auth Configs](https://v3.docs.composio.dev/docs/programmatic-auth-configs.mdx): Guide to creating auth configs programmatically- [Custom Auth Parameters](https://v3.docs.composio.dev/docs/custom-auth-params.mdx): Guide to injecting custom credentials in headers or parameters for a toolkit- [Using Triggers](https://v3.docs.composio.dev/docs/using-triggers.mdx): Send payloads to your system based on external events@@ -84,8 +84,8 @@ Below is a list of Composio documentation. Use your web and fetch capabilities t```md PythonYou are the best Python developer known for your high taste and usage of new and cutting-edge practices.-You are building with Composio's Python SDK. Composio is platform for building with authenticated tools for AI agents and workflows.-It lets you build agents that that can work across a user's apps like Gmail, Notion, Slack.+You are building with Composio's Python SDK. Composio is a platform for building with authenticated tools for AI agents and workflows.+It lets you build agents that can work across a user's apps like Gmail, Notion, Slack.Below is a list of Composio documentation. Use your web and fetch capabilities to read the documentation you need.[Composio Documentation](https://v3.docs.composio.dev)@@ -94,12 +94,12 @@ Below is a list of Composio documentation. Use your web and fetch capabilities t- [Providers](https://v3.docs.composio.dev/docs/toolsets.mdx)- [Executing Tools](https://v3.docs.composio.dev/docs/executing-tools.mdx): Learn how to execute Composio's tools with different providers and frameworks- [Authenticating Tools](https://v3.docs.composio.dev/docs/authenticating-tools.mdx): Learn how to authenticate tools-- [Fetching and Filtering Tools](https://v3.docs.composio.dev/docs/fetching-tools.mdx): Learn how to fetch and filter Composio's tools and toolsets+- [Fetching and Filtering Tools](https://v3.docs.composio.dev/docs/fetching-tools.mdx): Learn how to fetch and filter Composio's tools and toolkits- [Schema Modifiers](https://v3.docs.composio.dev/docs/modifiers/schema-modifiers.mdx): Learn how to use schema modifiers to transform tool schemas before they are seen by agents.- [Before Execution Modifiers](https://v3.docs.composio.dev/docs/modifiers/before-execution.mdx): Learn how to use before execution modifiers to modify tool arguments before execution.- [After Execution Modifiers](https://v3.docs.composio.dev/docs/modifiers/after-execution.mdx): Learn how to use after execution modifiers to transform tool results after execution.- [Creating custom tools](https://v3.docs.composio.dev/docs/custom-tools.mdx): Learn how to extend Composio's toolkits with your own tools-- [Custom Auth Configs](https://v3.docs.composio.dev/docs/custom-auth-configs.mdx): Guide to using customising auth configs for a toolkit+- [Custom Auth Configs](https://v3.docs.composio.dev/docs/custom-auth-configs.mdx): Guide to using customizing auth configs for a toolkit- [Programmatic Auth Configs](https://v3.docs.composio.dev/docs/programmatic-auth-configs.mdx): Guide to creating auth configs programmatically- [Custom Auth Parameters](https://v3.docs.composio.dev/docs/custom-auth-params.mdx): Guide to injecting custom credentials in headers or parameters for a toolkit- [Using Triggers](https://v3.docs.composio.dev/docs/using-triggers.mdx): Send payloads to your system based on external eventsdiff --git a/fern/pages/src/get-started/providers.mdx b/fern/pages/src/get-started/providers.mdxindex f22f0995b..92a278f9b 100644--- a/fern/pages/src/get-started/providers.mdx+++ b/fern/pages/src/get-started/providers.mdx@@ -329,7 +329,7 @@ Select a provider based on your AI platform:> No, providers are set during initialization. Create a new Composio instance with a different provider if needed.**Q: Do I need different API keys for different providers?**-> Yes, your Composio API key is used only for tool authentication, and is not used by the provider. You need to use provider specific API keys for each provider.+> Yes, your Composio API key is used only for tool authentication and is not used by the provider. You need to use provider-specific API keys for each provider.**Q: Can I use multiple providers in the same application?**> Yes, create separate Composio instances with different providers for different parts of your application.diff --git a/fern/pages/src/mcp/developers.mdx b/fern/pages/src/mcp/developers.mdxindex 12a89958d..f656a1ba7 100644--- a/fern/pages/src/mcp/developers.mdx+++ b/fern/pages/src/mcp/developers.mdx@@ -12,7 +12,7 @@ hide-nav-links: trueComposio MCP lets you build custom MCP servers that your users can connect to and use to perform actions.You can manage these servers via our [Dashboard](https://app.composio.dev), or use the [SDK/API](/api-reference/mcp) for greater control and flexibility.-## Creating MCP Servers and Onboarding End users+## Creating MCP Servers and Onboarding End Users<Steps><Step title="Configure Authentication">- **Configure Toolkit permissions:**@@ -45,7 +45,7 @@ You can manage these servers via our [Dashboard](https://app.composio.dev), or u```json{"id": "5bc757cc-7a8e-431c-8616-7f57cbed2423",- "name": "Gmail MCP Server"",+ "name": "Gmail MCP Server","auth_config_ids": ["ac_auth_12"],"allowed_tools": ["GMAIL_FETCH_EMAIL",@@ -81,9 +81,9 @@ You can manage these servers via our [Dashboard](https://app.composio.dev), or u</Tip>### Configuring authentication-You or your users need to authenticate against an app to use it's MCP server through Composio!+You or your users need to authenticate against an app to use its MCP server through Composio!This can be done in two ways:-* Authenticate users upfront via the Composio SDK/API. Follow [custom auth configs](/docs/custom-auth-configs) to learn how to connect users. This is recommended for most use cases+* Authenticate users upfront via the Composio SDK/API. Follow [custom auth configs](/docs/custom-auth-configs) to learn how to connect users. This is recommended for most use cases.* Let the agent authenticate users on demand. Passing `include_composio_helper_actions=true` in the URL will include Composio's helper actions and the agent will guide the user through auth on demand.diff --git a/fern/pages/src/mcp/introduction.mdx b/fern/pages/src/mcp/introduction.mdxindex cb14e4c8c..99f5ecd63 100644--- a/fern/pages/src/mcp/introduction.mdx+++ b/fern/pages/src/mcp/introduction.mdx@@ -47,7 +47,7 @@ Interested in embedding Composio MCP servers into your MCP clients or applicatio```json{"id": "5bc757cc-7a8e-431c-8616-7f57cbed2423",- "name": "Gmail MCP Server"",+ "name": "Gmail MCP Server","auth_config_ids": ["ac_auth_12"],"allowed_tools": ["GMAIL_FETCH_EMAIL",@@ -83,9 +83,9 @@ Interested in embedding Composio MCP servers into your MCP clients or applicatio</Tip>### Configuring authentication-You or your users need to authenticate against an app to use it's MCP server through Composio!+You or your users need to authenticate against an app to use its MCP server through Composio!This can be done in two ways:-* Authenticate users upfront via the Composio SDK/API. Follow [custom auth configs](/docs/custom-auth-configs) to learn how to connect users. This is recommended for most use cases+* Authenticate users upfront via the Composio SDK/API. Follow [custom auth configs](/docs/custom-auth-configs) to learn how to connect users. This is recommended for most use cases.* Let the agent authenticate users on demand. Passing `include_composio_helper_actions=true` in the URL will include Composio's helper actions and the agent will guide the user through auth on demand.diff --git a/fern/pages/src/mcp/overview.mdx b/fern/pages/src/mcp/overview.mdxindex 1903c0e28..bd9cd599b 100644--- a/fern/pages/src/mcp/overview.mdx+++ b/fern/pages/src/mcp/overview.mdx@@ -7,7 +7,7 @@ hide-nav-links: true---[Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) is an open protocol that standardizes how LLM-powered applications provide _tools_ and relevant context to the underlying models.-The protocol follows a client server model, where the MCP server provides the tools and context to the MCP client.+The protocol follows a client-server model, where the MCP server provides the tools and context to the MCP client.All [tools](/tools) in Composio are also available through MCP servers.diff --git a/fern/pages/src/mcp/partner-api.mdx b/fern/pages/src/mcp/partner-api.mdxindex 557145d8e..6fe266217 100644--- a/fern/pages/src/mcp/partner-api.mdx+++ b/fern/pages/src/mcp/partner-api.mdx@@ -1,6 +1,6 @@---title: Composio Partner Program-subtitle: "Onboard as a partner with composio"+subtitle: "Onboard as a partner with Composio"image: "https://og.composio.dev/api/og?title=Composio%20Partner%20Program" # image for socialskeywords: ""hide-nav-links: truediff --git a/fern/pages/src/mcp/providers.mdx b/fern/pages/src/mcp/providers.mdxindex b45c4780c..5a99c05c3 100644--- a/fern/pages/src/mcp/providers.mdx+++ b/fern/pages/src/mcp/providers.mdx@@ -8,7 +8,7 @@ hide-nav-links: true----<Warning title="Only available for Typescript SDK" icon="warning">At this time, MCP providers using the Composio SDK are only supported in the TypeScript SDK. Support for the Python SDK is coming soon.</Warning>+<Warning title="Only available for TypeScript SDK" icon="warning">At this time, MCP providers using the Composio SDK are only supported in the TypeScript SDK. Support for the Python SDK is coming soon.</Warning>Integrating external tools into agent frameworks can be a complex and time-consuming process. Composio MCP (Model Context Protocol) servers simplify this workflow, enabling you to connect your framework to a wide array of tools and services with minimal configuration.diff --git a/fern/pages/src/migration-guide.mdx b/fern/pages/src/migration-guide.mdxindex 541d7048c..5c5dd3ba3 100644--- a/fern/pages/src/migration-guide.mdx+++ b/fern/pages/src/migration-guide.mdx@@ -8,17 +8,17 @@ hide-nav-links: trueIn the last few months, we have experienced very rapid growth in usage of our platform. As such, our team has been working hard to radically improve the performance and developer experience of our platform.-A lot of these changes have happened in the background, but we are excited to finally share our new SDKs with you that compliment our new infra.+A lot of these changes have happened in the background, but we are excited to finally share our new SDKs with you that complement our new infra.The new API features improved usability, enhanced stability, and better scalability. The SDKs built on top of it simplify the developer experience, making it easier than ever to build useful agents.## What's new?-A lot of the changes are on the infra side, but from the SDK point of view. Here is what you can expect:+A lot of the changes are on the infra side, but from the SDK point of view, here is what you can expect:- Faster and more reliable tool execution- A simpler but more opinionated SDK- Much more intuitive and consistent naming conventions-- A vastly improved typescript sdk that is meaningfully more type-safe and has full feature parity with the python sdk+- A vastly improved TypeScript SDK that is meaningfully more type-safe and has full feature parity with the Python SDKThere aren't too many new flashy features here (yet) mainly because we wanted to get the bones right — but we feel we have a solid foundation to ship incredible new experiences on top very quickly.@@ -27,7 +27,7 @@ There aren't too many new flashy features here (yet) mainly because we wanted toCurrently, the new SDKs are in a preview release. These new SDKs come almost fully formed, we do not expect many breaking changes to them but are releasing them in a preview state to get feedback and make necessary changes before locking them in.-As we lock the new SDKs in place, we will deprecate support for the old SDKs. They will continue to work for the foreseeable future but are no longer active maintained. We will continue to push security update and fix any critical bugs but will not be support any new functionality in them.+As we lock the new SDKs in place, we will deprecate support for the old SDKs. They will continue to work for the foreseeable future but are no longer actively maintained. We will continue to push security updates and fix any critical bugs but will not support any new functionality in them.We urge you to upgrade to the new SDKs as soon as possible.diff --git a/fern/pages/src/providers/anthropic.mdx b/fern/pages/src/providers/anthropic.mdxindex a0f178225..1fa010fe1 100644--- a/fern/pages/src/providers/anthropic.mdx+++ b/fern/pages/src/providers/anthropic.mdx@@ -7,10 +7,10 @@ hide-nav-links: false----The Anthropic Provider transforms Composio tools into a format compatible with Anthropic's function calling capabilities through it's Messages API.+The Anthropic Provider transforms Composio tools into a format compatible with Anthropic's function calling capabilities through its Messages API.## Setup-Anthropic provider can be installed for both the SDKs.+The Anthropic provider can be installed for both SDKs.<CodeGroup>```bash title="Python" for="python" maxLines=60 wordWrapdiff --git a/fern/pages/src/providers/crewai.mdx b/fern/pages/src/providers/crewai.mdxindex 28a70463b..db859712b 100644--- a/fern/pages/src/providers/crewai.mdx+++ b/fern/pages/src/providers/crewai.mdx@@ -8,7 +8,7 @@ hide-nav-links: false## CrewAI Provider-The CrewAI Provider is a provider that formats the Composio tools into an object compatible with CrewAI's tool calling capabilities. Agents and LLM workflows built with this can call and execute the Composio tools.+The CrewAI Provider formats the Composio tools into an object compatible with CrewAI's tool calling capabilities. Agents and LLM workflows built with this can call and execute the Composio tools.## Setup@@ -40,7 +40,7 @@ crewai_agent = Agent(goal="""You take action on Github using Github APIs""",backstory=("You are AI agent that is responsible for taking actions on Github "- "on users behalf. You need to take action on Github using Github APIs"+ "on users' behalf. You need to take action on Github using Github APIs"),verbose=True,tools=tools,diff --git a/fern/pages/src/providers/google-adk.mdx b/fern/pages/src/providers/google-adk.mdxindex a32ea0789..4f97c9330 100644--- a/fern/pages/src/providers/google-adk.mdx+++ b/fern/pages/src/providers/google-adk.mdx@@ -10,7 +10,7 @@ hide-nav-links: false## Google ADK Provider-The Google ADK Provider is a provider that formats the Composio tools into an object compatible with Google's ADK capabilities. Agents and LLM workflows built with this can call and execute the Composio tools.+The Google ADK Provider formats the Composio tools into an object compatible with Google's ADK capabilities. Agents and LLM workflows built with this can call and execute the Composio tools.## Setupdiff --git a/fern/pages/src/providers/mastra.mdx b/fern/pages/src/providers/mastra.mdxindex a99132a2f..c89bf7135 100644--- a/fern/pages/src/providers/mastra.mdx+++ b/fern/pages/src/providers/mastra.mdx@@ -8,7 +8,7 @@ hide-nav-links: falseMastra is a TypeScript native framework for building agents with tools and MCPs. It expects tools to be in the following format:- Inputs: What information the tool needs to run (defined with an `inputSchema`, often using Zod).-- Outputs: The structure of the data the tool returns (defined with an outputSchema).+- Outputs: The structure of the data the tool returns (defined with an `outputSchema`).- Execution Logic: The code that performs the tool's action.- Description: Text that helps the agent understand what the tool does and when to use it.diff --git a/fern/pages/src/providers/openai-agents.mdx b/fern/pages/src/providers/openai-agents.mdxindex a14568db1..455dd7dc0 100644--- a/fern/pages/src/providers/openai-agents.mdx+++ b/fern/pages/src/providers/openai-agents.mdx@@ -10,7 +10,7 @@ hide-nav-links: falseThe OpenAI Agents Provider is a provider that formats the Composio tools into an object compatible with OpenAI's Agents API.-OpenAI Agents SDK is different from the OpenAI SDK. It's to help build agentic AI apps in a lightweight, easy-to-use package with very few abstractions.+OpenAI Agents SDK is different from the OpenAI SDK. It helps build agentic AI apps in a lightweight, easy-to-use package with very few abstractions.## Setupdiff --git a/fern/pages/src/providers/openai.mdx b/fern/pages/src/providers/openai.mdxindex 30ce3b796..6eabb2023 100644--- a/fern/pages/src/providers/openai.mdx+++ b/fern/pages/src/providers/openai.mdx@@ -6,10 +6,10 @@ keywords: ""hide-nav-links: false----The OpenAI Provider is the default provider for the Composio SDK. It transforms Composio tools into a format compatible with OpenAI's function calling capabilities through both: the Responses and Chat Completion APIs.+The OpenAI Provider is the default provider for the Composio SDK. It transforms Composio tools into a format compatible with OpenAI's function calling capabilities through both the Responses and Chat Completion APIs.## Setup-By default the OpenAI Provider is installed when you install the Composio SDK. You can also install it manually:+By default, the OpenAI Provider is installed when you install the Composio SDK. You can also install it manually:<CodeGroup>```bash title="Python" for="python"@@ -49,7 +49,7 @@ The Responses API is the recommended way to build more agentic flows with the Op</CodeGroup>## Chat Completion API-Chat Completion API is the industry standard for building LLM-powered applications. Chat completions is also adopted and used by many other LLM providers apart from OpenAI.+Chat Completion API is the industry standard for building LLM-powered applications. Chat completions are also adopted and used by many other LLM providers apart from OpenAI.<CodeGroup><SnippetCodediff --git a/fern/pages/src/providers/ts-custom.mdx b/fern/pages/src/providers/ts-custom.mdxindex 583ab2492..cc6d2b700 100644--- a/fern/pages/src/providers/ts-custom.mdx+++ b/fern/pages/src/providers/ts-custom.mdx@@ -5,7 +5,7 @@ keywords: ""hide-nav-links: false----This guide provides a comprehensive walkthrough of creating custom providers for the Composio TypeScriptSDK, enabling integration with different AI frameworks and platforms.+This guide provides a comprehensive walkthrough of creating custom providers for the Composio TypeScript SDK, enabling integration with different AI frameworks and platforms.## Provider Architecturediff --git a/fern/pages/src/providers/vercel.mdx b/fern/pages/src/providers/vercel.mdxindex 24180a610..161a21af6 100644--- a/fern/pages/src/providers/vercel.mdx+++ b/fern/pages/src/providers/vercel.mdx@@ -39,7 +39,7 @@ const { text } = await generateText({{role: "user",content:- "Send an email to [email protected] saying how 'hi from the ether of composio'",+ "Send an email to [email protected] saying 'hi from the ether of composio'",},],tools,diff --git a/fern/pages/src/tool-calling/after-execution-modifiers.mdx b/fern/pages/src/tool-calling/after-execution-modifiers.mdxindex 0556afe6d..4900318e9 100644--- a/fern/pages/src/tool-calling/after-execution-modifiers.mdx+++ b/fern/pages/src/tool-calling/after-execution-modifiers.mdx@@ -15,7 +15,7 @@ These modifiers are called after the tool is executed by the LLM. This allows yo**Useful for:**- Modifying or truncating the output of the tool.-- Convert the output to a different format before returning it to the agent.+- Converting the output to a different format before returning it to the agent.<Frame><img src="../../../assets/images/after-execute.png" alt="After Execution Modifier" />@@ -46,7 +46,7 @@ def after_execute_modifier(return {**response,"data": {- "karama": response["data"]["karama"],+ "karma": response["data"]["karma"],},}diff --git a/fern/pages/src/tool-calling/authenticating-tools.mdx b/fern/pages/src/tool-calling/authenticating-tools.mdxindex 3ad237477..86b53b421 100644--- a/fern/pages/src/tool-calling/authenticating-tools.mdx+++ b/fern/pages/src/tool-calling/authenticating-tools.mdx@@ -10,7 +10,7 @@ Different apps (like Slack, Notion, Shopify) have their own authentication flows## Creating an auth config-Each toolkit comes with it's own _auth config_.+Each toolkit comes with its own _auth config_.This configuration is used to authenticate the users to the tools.The first step is to create an auth config for any toolkit that you want to use.@@ -37,12 +37,12 @@ The dashboard offers a guided process for all app types.</Frame></Step><Step title="Configure Auth Config Settings">- Select between the supported auth schemes of OAuth2, API Key, Bearer Token, Basic Auth, depending on the toolkit.+ Select among the supported auth schemes of OAuth2, API Key, Bearer Token, Basic Auth, depending on the toolkit.Switch between the auth schemes and configure the scopes, developer credentials, etc here.<Note title="Composio Managed Auth" icon="info">You may also choose to use Composio's managed auth for certain toolkits or use your own auth credentials.- It is recommended to use specify your own credentials for production workloads and ability to control scopes, etc.+ It is recommended to specify your own credentials for production workloads and ability to control scopes, etc.</Note><Frame background="subtle" title="Auth Config Settings">@@ -50,7 +50,7 @@ The dashboard offers a guided process for all app types.</Frame></Step><Step title="Create and Get auth config ID">- Click **"Create Integration"**. After creation, **copy the displayed starting with `ac_`**. This is your auth config ID. This is _not_ a sensitive ID -- you can save it in environment variables or a database.+ Click **"Create Integration"**. After creation, **copy the displayed ID starting with `ac_`**. This is your auth config ID. This is _not_ a sensitive ID -- you can save it in environment variables or a database.**This ID will be used to create connections to the toolkit for a given user.**</Step></Steps>@@ -105,7 +105,7 @@ If you know the required authentication fields for your toolkit (like `apiKey` f## Specifying auth schemesComposio supports a wide range of auth schemes; OAuth2, API Key, HTTP Basic and many more.Each app (and toolkit) has different connection options required for each auth scheme. For example;-- Shopify requires an *API key* from each user from each user for the API Key auth scheme.+- Shopify requires an *API key* from each user for the API Key auth scheme.- Airtable requires the Bearer token from each user for the *Bearer* auth scheme.The auth scheme information is typed and can be configured as follows:diff --git a/fern/pages/src/tool-calling/before-execution-modifiers.mdx b/fern/pages/src/tool-calling/before-execution-modifiers.mdxindex c00056638..94be46587 100644--- a/fern/pages/src/tool-calling/before-execution-modifiers.mdx+++ b/fern/pages/src/tool-calling/before-execution-modifiers.mdx@@ -96,7 +96,7 @@ if (tool_calls) {arguments: JSON.parse(toolArgs),},{- beforeExecute: { toolSlug, toolkitSlug, params }) => {+ beforeExecute: ({ toolSlug, toolkitSlug, params }) => {if (toolSlug === "HACKERNEWS_GET_LATEST_POSTS") {params.arguments.size = 1;}@@ -142,7 +142,7 @@ tools = composio.tools.get("LINEAR_CREATE_LINEAR_ISSUE",],modifiers=[- after_execute_modifier,+ modify_linear_project_id,])```diff --git a/fern/pages/src/tool-calling/custom-tools.mdx b/fern/pages/src/tool-calling/custom-tools.mdxindex bee4390d5..d7bbeea31 100644--- a/fern/pages/src/tool-calling/custom-tools.mdx+++ b/fern/pages/src/tool-calling/custom-tools.mdx@@ -75,14 +75,14 @@ const tool = await composio.tools.createCustomTool({slug: 'GITHUB_STAR_COMPOSIOHQ_REPOSITORY',name: 'Github star composio repositories',toolkitSlug: 'github',- description: 'Star any specificied repo of `composiohq` user',+ description: 'Star any specified repo of `composiohq` user',inputParams: z.object({repository: z.string().describe('The repository to star'),page: z.number().optional().describe('Pagination page number'),customHeader: z.string().optional().describe('Custom header'),}),execute: async (input, connectionConfig, executeToolRequest) => {- // This method makes authenticated requests to relevant API+ // This method makes authenticated requests to the relevant API// You can use relative paths!// Composio will automatically inject the baseURLconst result = await executeToolRequest({diff --git a/fern/pages/src/tool-calling/executing-tools.mdx b/fern/pages/src/tool-calling/executing-tools.mdxindex 1610fe32d..909b9f877 100644--- a/fern/pages/src/tool-calling/executing-tools.mdx+++ b/fern/pages/src/tool-calling/executing-tools.mdx@@ -6,7 +6,7 @@ subtitle: "Learn how to execute Composio's tools with different providers and frhide-nav-links: false----Tool calling is a feature of all frontier LLMs to allow them to interact with the outside world. Earlier you might be able to ask an LLM to write you a nice email, but you would have to manually send it. With tool calling, you can now provide an LLM a valid tools for example, `GMAIL_SEND_EMAIL` to go and accomplish the task autonomously.+Tool calling is a feature of all frontier LLMs to allow them to interact with the outside world. Earlier you might be able to ask an LLM to write you a nice email, but you would have to manually send it. With tool calling, you can now provide an LLM a valid tool, for example, `GMAIL_SEND_EMAIL` to go and accomplish the task autonomously.## Using Chat CompletionsFor non-agent providers—such as OpenAI, Anthropic, and Google AI—you can process tool calls using the tool call handlers provided by the Composio SDK.@@ -58,7 +58,7 @@ Each tool and tool action is scoped to a user. Hence, a `user_id` is required toThe authentication state is checked and used while fetching and executing a tool.You need to authorize the user to execute tools.-For more information on authentication, see [Authenticating Tools](./authenticating-tools).+For more information on authentication, see [Authenticating Tools](./authenticating-tools).## For Humans (deterministic tool calling)In case you just want to call a tool manually -- not using any framework or LLM provider, you can do so using the `execute` method.diff --git a/fern/pages/src/tool-calling/fetching-tools.mdx b/fern/pages/src/tool-calling/fetching-tools.mdxindex 3730b54b3..d5365e0b5 100644--- a/fern/pages/src/tool-calling/fetching-tools.mdx+++ b/fern/pages/src/tool-calling/fetching-tools.mdx@@ -13,7 +13,7 @@ This process returns a union of all tools that match the specified criteria, ensWhen fetching tools, they are automatically formatted to match the requirements of the provider you are using. This means you do not need to manually convert or adapt the tool format.## Filtering by toolkit-Toolkits are collections of tools that from a specific app!+Toolkits are collections of tools from a specific app!Fetching tools from a toolkit is a good way to get a sense of the tools available.@@ -122,7 +122,7 @@ const tools = await composio.tools.get(userId, {</CodeGroup>## Fetching raw tools-To examine the raw schema definitition of a tool to understand the input/output parameters or to build custom logic around tool definitions, you can use the following methods. This can be useful for:+To examine the raw schema definition of a tool to understand the input/output parameters or to build custom logic around tool definitions, you can use the following methods. This can be useful for:- Understanding exact input parameters and output structures.- Building custom logic around tool definitions.- Debugging tool interactions.@@ -203,4 +203,4 @@ When fetching tools, you must use one of these filter combinations:{ search: "query", toolkits?: string[], limit?: number }```-These combinations are mutually exclusive - you can't mix `tools` with `search` or use `scopes` with multiple toolkits.\ No newline at end of file+These combinations are mutually exclusive - you can't mix `tools` with `search` or use `scopes` with multiple toolkits.\ No newline at end of filediff --git a/fern/pages/src/tool-calling/schema-modifiers.mdx b/fern/pages/src/tool-calling/schema-modifiers.mdxindex f2905a027..67bfc61c8 100644--- a/fern/pages/src/tool-calling/schema-modifiers.mdx+++ b/fern/pages/src/tool-calling/schema-modifiers.mdx@@ -153,15 +153,15 @@ const tools = await composio.tools.get(tools: ['HACKERNEWS_GET_LATEST_POSTS', 'HACKERNEWS_GET_USER'],},{- modifyToolSchema: (toolSlug, _, toolSchema) => {+ modifyToolSchema: ({ toolSlug, toolkitSlug, schema }) => {if (toolSlug === 'HACKERNEWS_GET_LATEST_POSTS') {- const { inputParameters } = toolSchema;+ const { inputParameters } = schema;if (inputParameters?.properties) {delete inputParameters.properties['page'];}inputParameters.required = ['size'];}- return toolSchema;+ return schema;},});diff --git a/fern/pages/src/triggers/using-triggers.mdx b/fern/pages/src/triggers/using-triggers.mdxindex 267e93a92..4cc9cb996 100644--- a/fern/pages/src/triggers/using-triggers.mdx+++ b/fern/pages/src/triggers/using-triggers.mdx@@ -131,7 +131,7 @@ Below are some examples of how to listen in on trigger events for a FastAPI/Next</CodeGroup>## Trigger payload types-When subscribing to triggers, it is helpful to know the payload type recieved from the trigger. You can inspect the payload type by fetching the trigger type.+When subscribing to triggers, it is helpful to know the payload type received from the trigger. You can inspect the payload type by fetching the trigger type.<CodeGroup>```python Python maxLines=60 wordWrap