Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

fixes

Sushmithamalleshcda59a0df970
diff --git a/fern/pages/src/authentication/custom-auth-configs.mdx b/fern/pages/src/authentication/custom-auth-configs.mdx
index 31e1824ff..0a4ad88dd 100644
--- a/fern/pages/src/authentication/custom-auth-configs.mdx
+++ b/fern/pages/src/authentication/custom-auth-configs.mdx
@@ -36,7 +36,7 @@ If you choose to use your own developer app for the OAuth2 scheme, you will have
Toolkits 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">
+<Tip title="Use your own developer app!" icon="fa-light fa-exclamation">
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!
diff --git a/fern/pages/src/authentication/custom-auth-params.mdx b/fern/pages/src/authentication/custom-auth-params.mdx
index d9b3564a6..76e5110b0 100644
--- a/fern/pages/src/authentication/custom-auth-params.mdx
+++ b/fern/pages/src/authentication/custom-auth-params.mdx
@@ -31,7 +31,7 @@ const composio = new Composio({
Define a function that modifies authentication parameters for specific toolkits. This function checks the toolkit name and adds custom authentication headers when needed.
-<Card title="This is a Before Execute Modifier!" href="/docs/modifying-tool-inputs" icon="fa-magic">
+<Card title="This is a Before Execute Modifier!" href="/docs/modifying-tool-inputs" icon="fa-light fa-magic">
Before Execute Modifiers are a way to modify the parameters of a tool before it is executed. In this case, they are useful for adding custom authentication headers or parameters to a tool.
</Card>
diff --git a/fern/pages/src/capabilities/managed-authentication.mdx b/fern/pages/src/capabilities/managed-authentication.mdx
index abe88f155..52aa0f0e6 100644
--- a/fern/pages/src/capabilities/managed-authentication.mdx
+++ b/fern/pages/src/capabilities/managed-authentication.mdx
@@ -1,164 +1,39 @@
---
title: Managed Authentication
image: "https://og.composio.dev/api/og?title=Managed%20Authentication&description=Enterprise-grade%20authentication%20for%20AI%20agents"
-subtitle: "Enterprise-grade authentication for AI agents"
-description: "Let your AI agents authenticate with 800+ apps on behalf of users. OAuth, API keys, user isolation, and white-labeling built in."
+subtitle: "Auth management for your AI agents"
+description: "Let your AI agents authenticate with 500+ apps on behalf of users. OAuth, API keys, user isolation, and white-labeling built in."
keywords: "managed authentication, ai agent auth, oauth, api keys, user isolation, white-labeling, connected accounts"
hide-nav-links: false
---
-~~**Let your AI agents authenticate with 800+ apps on behalf of users**
-Zero-config OAuth flows, automatic token refresh, and complete user isolation—all managed for you.~~
+Composio handles OAuth flows, API keys, token refresh, and credential storage for 500+ apps.
-## ~~Key capabilities~~
-
-<CardGroup cols={2}>
- <Card title="800+ pre-configured apps" icon="fa-solid fa-plug">
- ~~OAuth flows, API keys, and credentials for every major platform—no setup required.~~
- </Card>
-
- <Card title="Automatic token management" icon="fa-solid fa-arrows-rotate">
- ~~Never worry about expired tokens. Composio handles refresh, rotation, and secure storage.~~
- </Card>
-
- <Card title="Complete user isolation" icon="fa-solid fa-lock">
- ~~Each user's credentials are encrypted and isolated. Perfect for multi-tenant applications.~~
- </Card>
-
- <Card title="White-label authentication" icon="fa-solid fa-palette">
- ~~Use your own OAuth apps and branded auth screens for a seamless user experience.~~
- </Card>
-</CardGroup>
-
-## ~~How it works~~
-
-<CodeGroup>
-```python Python
-from composio import Composio
-
-composio = Composio(api_key="YOUR_API_KEY")
-
-# Create an authentication link for your user
-auth_link = composio.connected_accounts.link(
- user_id="user-123",
- toolkit="github"
-)
-
-# User authenticates via the link
-print(f"Send this link to user: {auth_link.url}")
-
-# Execute authenticated actions
-result = composio.tools.execute(
- "GITHUB_CREATE_REPO",
- user_id="user-123",
- arguments={"name": "my-new-repo"}
-)
-```
-
-```typescript TypeScript
-import { Composio } from '@composio/core';
-
-const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
-
-// Create an authentication link for your user
-const authLink = await composio.connectedAccounts.link({
- userId: 'user-123',
- toolkit: 'github'
-});
-
-// User authenticates via the link
-console.log(`Send this link to user: ${authLink.url}`);
-
-// Execute authenticated actions
-const result = await composio.tools.execute('GITHUB_CREATE_REPO', {
- userId: 'user-123',
- arguments: { name: 'my-new-repo' }
-});
-```
-</CodeGroup>
-
-## ~~Use cases~~
-
-### ~~Customer support automation~~
-~~Enable support agents to access customer accounts across Zendesk, Intercom, and internal tools—with proper audit trails and permissions.~~
-
-### ~~Sales automation~~
-~~Connect CRM, email, and calendar accounts to automate outreach, follow-ups, and meeting scheduling while maintaining personalization.~~
-
-### ~~DevOps workflows~~
-~~Authenticate with GitHub, GitLab, AWS, and monitoring tools to automate deployments, incident response, and infrastructure management.~~
-
-### ~~Content management~~
-~~Connect social media, CMS, and analytics platforms to schedule posts, manage content, and track performance across channels.~~
-
-## ~~Authentication methods~~
-
-<AccordionGroup>
- <Accordion title="OAuth 2.0">
- ~~Full OAuth flow with automatic token refresh. Supports Google, Microsoft, GitHub, and 500+ other providers.~~
- </Accordion>
-
- <Accordion title="API Keys">
- ~~Simple key-based authentication for services like OpenAI, Stripe, and SendGrid. Keys are encrypted at rest.~~
- </Accordion>
-
- <Accordion title="Basic Auth">
- ~~Username/password authentication for legacy systems and internal tools. Credentials are securely stored.~~
- </Accordion>
-
- <Accordion title="Custom Credentials">
- ~~Support for any authentication method including JWT, session tokens, and proprietary schemes.~~
- </Accordion>
-</AccordionGroup>
-
-## ~~Enterprise features~~
+## Quick links
<CardGroup cols={3}>
- <Card title="GDPR compliant" icon="fa-solid fa-shield-check">
- ~~Data residency options and right-to-be-forgotten support~~
- </Card>
-
- <Card title="SOC 2 Type II" icon="fa-solid fa-certificate">
- ~~Annual audits and continuous compliance monitoring~~
- </Card>
-
- <Card title="HIPAA ready" icon="fa-solid fa-hospital">
- ~~Healthcare-grade security for sensitive data~~
- </Card>
-</CardGroup>
-
-## ~~Get started~~
-
-<CardGroup cols={2}>
<Card
- title="Authentication guide"
- icon="fa-solid fa-book"
+ title="Authenticating tools"
+ icon="fa-light fa-key"
href="/docs/authenticating-tools"
>
- ~~Learn how to authenticate tools and manage connections~~
+ Create auth configs and connect user accounts via Connect Link or direct SDK integration
</Card>
<Card
- title="Custom auth configs"
- icon="fa-solid fa-cog"
+ title="White-labeling"
+ icon="fa-light fa-palette"
href="/docs/custom-auth-configs"
>
- ~~Use your own OAuth apps and credentials~~
+ Use your own OAuth apps and remove Composio branding from auth screens
</Card>
<Card
- title="Connected accounts"
- icon="fa-solid fa-users"
- href="/docs/connected-accounts"
+ title="Connected Accounts API"
+ icon="fa-light fa-plug"
+ href="/api-reference/connected-accounts"
>
- ~~Manage user connections throughout their lifecycle~~
+ Manage user connections programmatically
</Card>
- <Card
- title="White-labeling"
- icon="fa-solid fa-palette"
- href="/tool-router/white-labeling"
- >
- ~~Create branded authentication experiences~~
- </Card>
-</CardGroup>
\ No newline at end of file
+</CardGroup>
diff --git a/fern/pages/src/capabilities/mcp.mdx b/fern/pages/src/capabilities/mcp.mdx
index f027853e1..9b1d8f3d1 100644
--- a/fern/pages/src/capabilities/mcp.mdx
+++ b/fern/pages/src/capabilities/mcp.mdx
@@ -2,37 +2,51 @@
title: MCP (Model Context Protocol)
image: "https://og.composio.dev/api/og?title=MCP&description=Universal%20tool%20protocol%20for%20any%20AI%20client"
subtitle: "Universal tool protocol for any AI client"
-description: "Connect 800+ tools to Claude Desktop, Continue.dev, and any MCP-compatible client. Framework-agnostic integration with zero code changes."
+description: "Connect 500+ tools to Claude Desktop, Continue.dev, and any MCP-compatible client. Framework-agnostic integration with zero code changes."
keywords: "mcp, model context protocol, claude desktop, continue dev, ai tools, framework agnostic, tool server"
hide-nav-links: false
---
-~~**Connect 800+ tools to any MCP-compatible AI client**
-Works with Claude Desktop, Continue.dev, and custom clients—no code changes needed. Just configure and connect.~~
-
-## ~~Key capabilities~~
+Connect Composio tools to Claude Desktop, Cursor, Windsurf, and any MCP-compatible client. Configure once, use everywhere.
<CardGroup cols={2}>
- <Card title="Universal compatibility" icon="fa-solid fa-infinity">
- ~~Works with any MCP client—Claude Desktop, Continue.dev, or your custom implementation.~~
+ <Card
+ title="MCP quickstart"
+ icon="fa-light fa-rocket"
+ href="/mcp/quickstart"
+ >
+ Set up MCP with Claude Desktop or other clients
</Card>
- <Card title="800+ tools instantly" icon="fa-solid fa-rocket">
- ~~All Composio tools available through a single MCP server configuration.~~
+ <Card
+ title="Server management"
+ icon="fa-light fa-server"
+ href="/mcp/server-management"
+ >
+ Configure toolkits, authentication, and permissions
</Card>
- <Card title="Zero code required" icon="fa-solid fa-code-branch">
- ~~Configure once in JSON, use everywhere. No SDK integration needed.~~
+ <Card
+ title="MCP providers"
+ icon="fa-light fa-plug"
+ href="/mcp/providers"
+ >
+ Integration guides for Claude Desktop, Cursor, Windsurf
</Card>
- <Card title="Automatic updates" icon="fa-solid fa-arrows-rotate">
- ~~New tools and capabilities added automatically without client updates.~~
+ <Card
+ title="Tool Router"
+ icon="fa-light fa-route"
+ href="/tool-router/overview"
+ >
+ Single MCP server and Tool that can search, authenticate, and execute across all Composio tools
</Card>
</CardGroup>
-## ~~How it works~~
+## Example
+
+Add Composio to Claude Desktop's configuration:
-<CodeGroup>
```json claude_desktop_config.json
{
"mcpServers": {
@@ -41,170 +55,9 @@ Works with Claude Desktop, Continue.dev, and custom clients—no code changes ne
"args": [
"-y",
"@composio/mcp-server",
- "{YOUR_COMPOSIO_API_KEY}"
+ "your-composio-api-key"
]
}
}
}
-```
-
-```python Python SDK Alternative
-# Or use the Python MCP server
-from composio import Composio
-
-composio = Composio(api_key="YOUR_API_KEY")
-
-# Start MCP server
-composio.mcp.start_server(
- port=3000,
- allowed_toolkits=["github", "slack", "gmail"]
-)
-
-# Server now available for any MCP client to connect
-print("MCP server running at localhost:3000")
-```
-
-```typescript TypeScript SDK Alternative
-// Or use the TypeScript MCP server
-import { Composio } from '@composio/core';
-
-const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
-
-// Start MCP server
-await composio.mcp.startServer({
- port: 3000,
- allowedToolkits: ['github', 'slack', 'gmail']
-});
-
-// Server now available for any MCP client to connect
-console.log('MCP server running at localhost:3000');
-```
-</CodeGroup>
-
-## ~~Compatible clients~~
-
-<CardGroup cols={3}>
- <Card title="Claude Desktop" icon="fa-solid fa-desktop">
- ~~Native support in Anthropic's desktop application~~
- </Card>
-
- <Card title="Continue.dev" icon="fa-solid fa-code">
- ~~AI-powered IDE extension for VS Code and JetBrains~~
- </Card>
-
- <Card title="Custom Clients" icon="fa-solid fa-wrench">
- ~~Build your own MCP client with any language or framework~~
- </Card>
-</CardGroup>
-
-## ~~Use cases~~
-
-### ~~IDE-powered development~~
-~~Give your IDE assistant the ability to create GitHub issues, search documentation, deploy code, and manage infrastructure—all from natural language.~~
-
-### ~~Desktop AI assistants~~
-~~Transform Claude Desktop into a powerful automation tool that can send emails, manage calendars, update CRMs, and interact with any business tool.~~
-
-### ~~Custom AI applications~~
-~~Build your own MCP client to create specialized AI assistants with access to your entire tool ecosystem without writing integrations.~~
-
-### ~~Research and analysis~~
-~~Enable AI to gather data from multiple sources, compile reports, and take action based on findings—all through a standardized protocol.~~
-
-## ~~MCP vs Native SDK~~
-
-<AccordionGroup>
- <Accordion title="When to use MCP">
- ~~- Working with MCP-compatible clients (Claude Desktop, Continue.dev)~~
- ~~- Want framework-agnostic integration~~
- ~~- Need quick setup without code changes~~
- ~~- Building polyglot applications~~
- </Accordion>
-
- <Accordion title="When to use Native SDK">
- ~~- Need programmatic control over tool execution~~
- ~~- Want to implement custom authentication flows~~
- ~~- Require response transformations or middleware~~
- ~~- Building production applications with specific requirements~~
- </Accordion>
-
- <Accordion title="Can I use both?">
- ~~Yes! MCP and Native SDK can work together. Use MCP for desktop tools and Native SDK for your application backend.~~
- </Accordion>
-</AccordionGroup>
-
-## ~~Server management~~
-
-<CardGroup cols={2}>
- <Card title="Configuration options" icon="fa-solid fa-cog">
- ~~Control which tools are exposed, set rate limits, and manage permissions~~
- </Card>
-
- <Card title="Multiple servers" icon="fa-solid fa-server">
- ~~Run different MCP servers for different environments or user groups~~
- </Card>
-
- <Card title="Authentication" icon="fa-solid fa-key">
- ~~Secure your MCP server with API keys and user-specific access~~
- </Card>
-
- <Card title="Monitoring" icon="fa-solid fa-chart-line">
- ~~Track usage, debug issues, and monitor performance~~
- </Card>
-</CardGroup>
-
-## ~~Setup guides~~
-
-<Steps>
- <Step title="Get your API key">
- ~~Sign up at [app.composio.dev](https://app.composio.dev) and grab your API key~~
- </Step>
-
- <Step title="Configure your client">
- ~~Add the Composio MCP server to your client's configuration file~~
- </Step>
-
- <Step title="Authenticate tools">
- ~~Connect your accounts (GitHub, Gmail, etc.) through the Composio dashboard~~
- </Step>
-
- <Step title="Start using tools">
- ~~Your AI can now access all connected tools through natural language~~
- </Step>
-</Steps>
-
-## ~~Get started~~
-
-<CardGroup cols={2}>
- <Card
- title="MCP quickstart"
- icon="fa-solid fa-rocket"
- href="/docs/mcp-quickstart"
- >
- ~~Set up MCP with Claude Desktop in 5 minutes~~
- </Card>
-
- <Card
- title="Server management"
- icon="fa-solid fa-server"
- href="/docs/mcp-server-management"
- >
- ~~Configure and manage your MCP servers~~
- </Card>
-
- <Card
- title="MCP providers"
- icon="fa-solid fa-plug"
- href="/docs/mcp-providers"
- >
- ~~Integration guides for different MCP clients~~
- </Card>
-
- <Card
- title="Troubleshooting"
- icon="fa-solid fa-wrench"
- href="/docs/troubleshooting/mcp"
- >
- ~~Common MCP issues and solutions~~
- </Card>
-</CardGroup>
\ No newline at end of file
+```
\ No newline at end of file
diff --git a/fern/pages/src/capabilities/tools.mdx b/fern/pages/src/capabilities/tools.mdx
index 88f78465e..5858a2b4c 100644
--- a/fern/pages/src/capabilities/tools.mdx
+++ b/fern/pages/src/capabilities/tools.mdx
@@ -1,214 +1,45 @@
---
title: Tools
-image: "https://og.composio.dev/api/og?title=Tools&description=800%2B%20authenticated%20actions%20for%20AI%20agents"
-subtitle: "800+ authenticated actions for AI agents"
-description: "Give your AI agents the ability to execute real-world actions across 800+ integrations. From GitHub commits to Slack messages—all with user authentication built in."
+image: "https://og.composio.dev/api/og?title=Tools&description=500%2B%20authenticated%20actions%20for%20AI%20agents"
+subtitle: "500+ authenticated actions for AI agents"
+description: "Give your AI agents the ability to execute real-world actions across 500+ integrations. From GitHub commits to Slack messages—all with user authentication built in."
keywords: "ai tools, agent tools, authenticated actions, tool calling, github actions, slack integration, gmail api"
hide-nav-links: false
---
-~~**Give your AI agents the ability to take real-world actions**
-800+ pre-built integrations with authentication, error handling, and response formatting—ready to use in one line of code.~~
-
-## ~~Key capabilities~~
-
-<CardGroup cols={2}>
- <Card title="800+ integrations" icon="fa-solid fa-plug">
- ~~GitHub, Slack, Gmail, Jira, Notion, and hundreds more—all pre-configured and ready.~~
- </Card>
-
- <Card title="User authentication built-in" icon="fa-solid fa-user-lock">
- ~~Every tool execution is scoped to the authenticated user. No credential mixing.~~
- </Card>
-
- <Card title="Automatic error handling" icon="fa-solid fa-shield">
- ~~Rate limiting, retries, and graceful degradation handled automatically.~~
- </Card>
-
- <Card title="Structured outputs" icon="fa-solid fa-code">
- ~~Consistent JSON responses optimized for LLM consumption and parsing.~~
- </Card>
-</CardGroup>
-
-## ~~How it works~~
-
-<CodeGroup>
-```python Python
-from composio import Composio
-
-composio = Composio(api_key="YOUR_API_KEY")
-
-# Get tools for a user
-tools = composio.tools.get(
- user_id="user-123",
- toolkits=["github", "slack"]
-)
-
-# Execute any tool with natural language arguments
-result = composio.tools.execute(
- "GITHUB_CREATE_ISSUE",
- user_id="user-123",
- arguments={
- "repo": "my-repo",
- "title": "Bug: Login not working",
- "body": "Users report login failures after update"
- }
-)
-
-print(f"Issue created: {result.data['html_url']}")
-```
-
-```typescript TypeScript
-import { Composio } from '@composio/core';
-
-const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
-
-// Get tools for a user
-const tools = await composio.tools.get({
- userId: 'user-123',
- toolkits: ['github', 'slack']
-});
-
-// Execute any tool with natural language arguments
-const result = await composio.tools.execute('GITHUB_CREATE_ISSUE', {
- userId: 'user-123',
- arguments: {
- repo: 'my-repo',
- title: 'Bug: Login not working',
- body: 'Users report login failures after update'
- }
-});
-
-console.log(`Issue created: ${result.data.html_url}`);
-```
-</CodeGroup>
-
-## ~~Popular integrations~~
-
-<CardGroup cols={4}>
- <Card title="GitHub" icon="fa-brands fa-github">
- ~~Create issues, manage PRs, deploy code~~
- </Card>
-
- <Card title="Slack" icon="fa-brands fa-slack">
- ~~Send messages, create channels, manage users~~
- </Card>
-
- <Card title="Gmail" icon="fa-solid fa-envelope">
- ~~Send emails, manage drafts, organize inbox~~
- </Card>
-
- <Card title="Notion" icon="fa-solid fa-n">
- ~~Create pages, update databases, manage workspace~~
- </Card>
-
- <Card title="Jira" icon="fa-brands fa-jira">
- ~~Create tickets, update status, manage sprints~~
- </Card>
-
- <Card title="Linear" icon="fa-solid fa-lines-leaning">
- ~~Track issues, update projects, manage cycles~~
- </Card>
-
- <Card title="Discord" icon="fa-brands fa-discord">
- ~~Send messages, manage servers, create webhooks~~
- </Card>
-
- <Card title="HubSpot" icon="fa-solid fa-h">
- ~~Manage contacts, deals, and marketing campaigns~~
- </Card>
-</CardGroup>
-
-## ~~Use cases~~
-
-### ~~Customer support automation~~
-~~Automatically create support tickets, update CRM records, and send follow-up emails based on customer interactions.~~
-
-### ~~DevOps workflows~~
-~~Trigger deployments, create GitHub issues from error logs, and send Slack notifications—all from natural language commands.~~
-
-### ~~Sales automation~~
-~~Update CRM records, schedule follow-ups, send personalized emails, and track deal progress across multiple platforms.~~
-
-### ~~Content publishing~~
-~~Cross-post to social media, update CMS, schedule publications, and track analytics across all your content channels.~~
-
-## ~~Tool categories~~
-
-<AccordionGroup>
- <Accordion title="Developer tools">
- ~~GitHub, GitLab, Bitbucket, Linear, Jira, PagerDuty, Datadog, Sentry~~
- </Accordion>
-
- <Accordion title="Communication">
- ~~Slack, Discord, Microsoft Teams, Gmail, Outlook, Twilio, SendGrid~~
- </Accordion>
-
- <Accordion title="Productivity">
- ~~Notion, Asana, Trello, Monday.com, Airtable, Google Workspace~~
- </Accordion>
-
- <Accordion title="Sales & Marketing">
- ~~HubSpot, Salesforce, Pipedrive, Mailchimp, ActiveCampaign, Intercom~~
- </Accordion>
-
- <Accordion title="Social Media">
- ~~Twitter/X, LinkedIn, Facebook, Instagram, YouTube, TikTok~~
- </Accordion>
-
- <Accordion title="Storage & Files">
- ~~Google Drive, Dropbox, Box, OneDrive, AWS S3, SharePoint~~
- </Accordion>
-</AccordionGroup>
-
-## ~~Advanced features~~
-
-<CardGroup cols={3}>
- <Card title="Custom tools" icon="fa-solid fa-wrench">
- ~~Create your own tools with custom logic and integrate any API~~
- </Card>
-
- <Card title="Tool versioning" icon="fa-solid fa-code-branch">
- ~~Pin specific versions for stability or use latest for new features~~
- </Card>
-
- <Card title="Response modifiers" icon="fa-solid fa-filter">
- ~~Transform outputs to match your application's needs~~
- </Card>
-</CardGroup>
-
-## ~~Get started~~
+Pre-built tools for GitHub, Slack, Gmail, and 500+ other services. Each tool handles authentication, error handling, and returns structured JSON responses.
<CardGroup cols={2}>
- <Card
- title="Browse all toolkits"
- icon="fa-solid fa-grid"
- href="/toolkits/introduction"
- >
- ~~Explore the full catalog of available integrations~~
- </Card>
-
<Card
title="Fetching tools"
- icon="fa-solid fa-download"
+ icon="fa-light fa-download"
href="/docs/fetching-tools"
>
- ~~Learn how to retrieve and filter tools for your agents~~
+ Retrieve and filter tools by toolkit, tags, or specific tool names
</Card>
<Card
title="Executing tools"
- icon="fa-solid fa-play"
+ icon="fa-light fa-play"
href="/docs/executing-tools"
>
- ~~Execute tools and handle responses in your application~~
+ Execute tools and handle responses in your application
</Card>
<Card
title="Custom tools"
- icon="fa-solid fa-hammer"
+ icon="fa-light fa-hammer"
href="/docs/custom-tools"
>
- ~~Build your own tools for proprietary systems~~
+ Build your own tools for proprietary systems and APIs
+ </Card>
+
+ <Card
+ title="Tool Router"
+ icon="fa-light fa-route"
+ href="/tool-router/overview"
+ >
+ Single MCP server and Tool that can search, authenticate, and execute across all Composio tools
</Card>
-</CardGroup>
\ No newline at end of file
+</CardGroup>
+
diff --git a/fern/pages/src/capabilities/triggers.mdx b/fern/pages/src/capabilities/triggers.mdx
index 66c2b922a..f97169007 100644
--- a/fern/pages/src/capabilities/triggers.mdx
+++ b/fern/pages/src/capabilities/triggers.mdx
@@ -1,246 +1,45 @@
---
title: Triggers
-image: "https://og.composio.dev/api/og?title=Triggers&description=Real-time%20events%20from%20800%2B%20integrations"
-subtitle: "Real-time events from 800+ integrations"
+image: "https://og.composio.dev/api/og?title=Triggers&description=Real-time%20events%20from%20500%2B%20integrations"
+subtitle: "Real-time events from 500+ integrations"
description: "React to events as they happen across your connected services. From GitHub commits to Slack messages—build event-driven AI workflows with zero webhook infrastructure."
keywords: "webhooks, triggers, real-time events, event-driven, github webhooks, slack events, automation"
hide-nav-links: false
---
-~~**Build event-driven AI workflows without managing webhooks**
-Automatically react to events from GitHub, Slack, Gmail, and 800+ other services—all webhooks and polling handled for you.~~
-
-## ~~Key capabilities~~
-
-<CardGroup cols={2}>
- <Card title="Real-time event streams" icon="fa-solid fa-bolt">
- ~~Instant notifications when events occur across any connected service.~~
- </Card>
-
- <Card title="Zero webhook setup" icon="fa-solid fa-plug-circle-xmark">
- ~~No need to configure endpoints, manage SSL, or handle retries—we do it all.~~
- </Card>
-
- <Card title="Unified event format" icon="fa-solid fa-layer-group">
- ~~Consistent event structure across all services for easier processing.~~
- </Card>
-
- <Card title="Built-in filtering" icon="fa-solid fa-filter">
- ~~Filter events by type, user, or custom criteria before they reach your app.~~
- </Card>
-</CardGroup>
-
-## ~~How it works~~
-
-<CodeGroup>
-```python Python
-from composio import Composio
-
-composio = Composio(api_key="YOUR_API_KEY")
-
-# Set up a trigger for GitHub push events
-trigger = composio.triggers.subscribe(
- user_id="user-123",
- trigger_name="GITHUB_PUSH_EVENT",
- config={
- "repository": "my-repo",
- "branch": "main"
- }
-)
-
-# Handle incoming events
-def handle_push(event):
- print(f"New commit: {event['commit_message']}")
-
- # Automatically create a deployment
- composio.tools.execute(
- "VERCEL_CREATE_DEPLOYMENT",
- user_id="user-123",
- arguments={
- "repo": event["repository"],
- "branch": event["branch"]
- }
- )
-```
-
-```typescript TypeScript
-import { Composio } from '@composio/core';
-
-const composio = new Composio({ apiKey: 'YOUR_API_KEY' });
-
-// Set up a trigger for GitHub push events
-const trigger = await composio.triggers.subscribe({
- userId: 'user-123',
- triggerName: 'GITHUB_PUSH_EVENT',
- config: {
- repository: 'my-repo',
- branch: 'main'
- }
-});
-
-// Handle incoming events
-trigger.onEvent((event) => {
- console.log(`New commit: ${event.commit_message}`);
-
- // Automatically create a deployment
- composio.tools.execute('VERCEL_CREATE_DEPLOYMENT', {
- userId: 'user-123',
- arguments: {
- repo: event.repository,
- branch: event.branch
- }
- });
-});
-```
-</CodeGroup>
-
-## ~~Popular triggers~~
-
-<CardGroup cols={4}>
- <Card title="GitHub" icon="fa-brands fa-github">
- ~~Push, PR, issue, release, star events~~
- </Card>
-
- <Card title="Slack" icon="fa-brands fa-slack">
- ~~Message, reaction, channel, member events~~
- </Card>
-
- <Card title="Gmail" icon="fa-solid fa-envelope">
- ~~New email, label change, attachment events~~
- </Card>
-
- <Card title="Calendar" icon="fa-solid fa-calendar">
- ~~Event created, updated, reminder events~~
- </Card>
-
- <Card title="Stripe" icon="fa-brands fa-stripe">
- ~~Payment, subscription, invoice events~~
- </Card>
-
- <Card title="Jira" icon="fa-brands fa-jira">
- ~~Issue created, status change, sprint events~~
- </Card>
-
- <Card title="HubSpot" icon="fa-solid fa-h">
- ~~Contact, deal, ticket activity events~~
- </Card>
-
- <Card title="Discord" icon="fa-brands fa-discord">
- ~~Message, reaction, member join events~~
- </Card>
-</CardGroup>
-
-## ~~Use cases~~
-
-### ~~Automated DevOps~~
-~~Trigger deployments on GitHub pushes, create Jira tickets from Sentry errors, and send Slack notifications for critical alerts—all automatically.~~
-
-### ~~Customer success automation~~
-~~React to support tickets, customer emails, and chat messages to automatically update CRM records and trigger follow-up actions.~~
-
-### ~~Content workflow automation~~
-~~Publish blog posts when documents are approved, cross-post to social media on content updates, and trigger translations for new content.~~
-
-### ~~Sales pipeline automation~~
-~~Update deal stages based on email interactions, schedule follow-ups from calendar events, and sync activity across all sales tools.~~
-
-## ~~Event types~~
-
-<AccordionGroup>
- <Accordion title="Repository events">
- ~~Push, pull request, issue, release, star, fork, branch creation/deletion~~
- </Accordion>
-
- <Accordion title="Communication events">
- ~~Message sent/received, channel created, member joined, reaction added~~
- </Accordion>
-
- <Accordion title="Document events">
- ~~File created/updated, page edited, comment added, permission changed~~
- </Accordion>
-
- <Accordion title="Calendar events">
- ~~Event created/updated/deleted, attendee response, reminder triggered~~
- </Accordion>
-
- <Accordion title="Payment events">
- ~~Payment succeeded/failed, subscription created/cancelled, invoice paid~~
- </Accordion>
-
- <Accordion title="Workflow events">
- ~~Task created/completed, status changed, assignee updated, due date changed~~
- </Accordion>
-</AccordionGroup>
-
-## ~~Advanced features~~
-
-<CardGroup cols={3}>
- <Card title="Event filtering" icon="fa-solid fa-filter">
- ~~Filter events before they reach your app to reduce noise~~
- </Card>
-
- <Card title="Batch processing" icon="fa-solid fa-layer-group">
- ~~Group related events for efficient bulk processing~~
- </Card>
-
- <Card title="Replay events" icon="fa-solid fa-clock-rotate-left">
- ~~Replay historical events for testing or recovery~~
- </Card>
-</CardGroup>
-
-## ~~Reliability guarantees~~
-
-<CardGroup cols={2}>
- <Card title="At-least-once delivery" icon="fa-solid fa-check-double">
- ~~Every event is guaranteed to be delivered at least once~~
- </Card>
-
- <Card title="Automatic retries" icon="fa-solid fa-rotate">
- ~~Failed deliveries are automatically retried with exponential backoff~~
- </Card>
-
- <Card title="Event ordering" icon="fa-solid fa-arrow-down-1-9">
- ~~Events from the same source maintain their chronological order~~
- </Card>
-
- <Card title="Idempotency" icon="fa-solid fa-fingerprint">
- ~~Each event has a unique ID to prevent duplicate processing~~
- </Card>
-</CardGroup>
-
-## ~~Get started~~
+Subscribe to real-time events from GitHub, Slack, Gmail, and other services. Composio handles webhook configuration, retries, and delivery.
<CardGroup cols={2}>
<Card
title="Using triggers"
- icon="fa-solid fa-bolt"
+ icon="fa-light fa-bolt"
href="/docs/using-triggers"
>
- ~~Learn how to subscribe to and handle trigger events~~
+ Subscribe to events and handle them in your application
</Card>
<Card
title="Available triggers"
- icon="fa-solid fa-list"
- href="/toolkits/introduction"
+ icon="fa-light fa-list"
+ href="/toolkits/all"
>
- ~~Browse all available triggers by toolkit~~
+ Browse triggers by toolkit
</Card>
<Card
- title="Event-driven workflows"
- icon="fa-solid fa-diagram-project"
- href="/examples/slack-summariser"
+ title="Triggers API"
+ icon="fa-light fa-code"
+ href="/api-reference/triggers"
>
- ~~See real examples of trigger-based automations~~
+ API reference for trigger operations
</Card>
<Card
- title="Troubleshooting"
- icon="fa-solid fa-wrench"
- href="/docs/troubleshooting/triggers"
+ title="Slack summarizer example"
+ icon="fa-light fa-diagram-project"
+ href="/examples/slack-summariser"
>
- ~~Debug common trigger issues and solutions~~
+ Event-driven workflow example
</Card>
-</CardGroup>
\ No newline at end of file
+</CardGroup>
+
diff --git a/fern/pages/src/get-started/providers.mdx b/fern/pages/src/get-started/providers.mdx
index d50cba6e0..928a6d409 100644
--- a/fern/pages/src/get-started/providers.mdx
+++ b/fern/pages/src/get-started/providers.mdx
@@ -244,7 +244,7 @@ These providers work with AI frameworks that can execute tools autonomously. The
</Card>
<Card
title="CrewAI Provider"
- icon="fa-solid fa-people-group"
+ icon="fa-light fa-people-group"
href="/providers/crewai"
>
Enable tool calling in CrewAI multi-agent systems.
@@ -258,20 +258,20 @@ These providers work with AI frameworks that can execute tools autonomously. The
</Card>
<Card
title="OpenAI Agents Provider"
- icon="fa-solid fa-user-astronaut"
+ icon="fa-light fa-user-astronaut"
href="/providers/openai-agents"
>
Add tools to OpenAI's new Agents API.
</Card>
<Card
title="Mastra Provider"
- icon="fa-solid fa-cubes"
+ icon="fa-light fa-cubes"
href="/providers/mastra"
>
Use Composio tools with Mastra agent framework.
</Card>
</CardGroup>
-<Tip title="Custom Providers" icon="puzzle">
+<Tip title="Custom Providers" icon="fa-light fa-puzzle">
Using a framework not yet supported by Composio? Create a custom provider in [TypeScript](/providers/custom/typescript) or [Python](/providers/custom/python)!
</Tip>
diff --git a/fern/pages/src/get-started/quickstart.mdx b/fern/pages/src/get-started/quickstart.mdx
index 9da4c937c..8256d7e15 100644
--- a/fern/pages/src/get-started/quickstart.mdx
+++ b/fern/pages/src/get-started/quickstart.mdx
@@ -102,16 +102,16 @@ All OAuth flows and tool execution were automatically handled by Composio.
## Next steps
<CardGroup cols={2}>
- <Card title="Use Providers" icon="fa-solid fa-plug" href="/providers/openai">
+ <Card title="Use Providers" icon="fa-light fa-plug" href="/providers/openai">
Learn how to use Composio with various agent SDK and frameworks.
</Card>
- <Card title="Work with tools" icon="fa-solid fa-toolbox" href="/docs/executing-tools">
+ <Card title="Work with tools" icon="fa-light fa-toolbox" href="/docs/executing-tools">
Learn how to work with tools and tool calling on a deeper level with Composio.
</Card>
- <Card title="Manage authentication" icon="fa-solid fa-key" href="/docs/custom-auth-configs">
+ <Card title="Manage authentication" icon="fa-light fa-key" href="/docs/custom-auth-configs">
Authorize tools for multiple users.
</Card>
- <Card title="Triggers" icon="fa-solid fa-bolt" href="/docs/using-triggers">
+ <Card title="Triggers" icon="fa-light fa-bolt" href="/docs/using-triggers">
Listen for external events to trigger actions in your agents
</Card>
</CardGroup>
\ No newline at end of file
diff --git a/fern/pages/src/get-started/welcome.mdx b/fern/pages/src/get-started/welcome.mdx
index fdf498c95..5b7c3b38e 100644
--- a/fern/pages/src/get-started/welcome.mdx
+++ b/fern/pages/src/get-started/welcome.mdx
@@ -8,7 +8,7 @@ hide-nav-links: false
<CardGroup cols={2}>
<Card
- icon="key"
+ icon="fa-light fa-key"
title="Managed authentication"
href="/docs/authenticating-tools"
>
@@ -16,7 +16,7 @@ hide-nav-links: false
</Card>
<Card
- icon="wrench"
+ icon="fa-light fa-wrench"
title="Tool execution"
href="/docs/executing-tools"
>
@@ -24,7 +24,7 @@ hide-nav-links: false
</Card>
<Card
- icon="database"
+ icon="fa-light fa-database"
title="MCP server"
href="/docs/mcp-quickstart"
>
@@ -32,7 +32,7 @@ hide-nav-links: false
</Card>
<Card
- icon="bolt"
+ icon="fa-light fa-bolt"
title="Triggers"
href="/docs/using-triggers"
>
@@ -40,16 +40,20 @@ hide-nav-links: false
</Card>
</CardGroup>
+<Card icon="fa-light fa-sparkles" title="Tool Router" href="/tool-router/overview">
+ Single MCP server and Tool that can search, authenticate, and execute across all Composio tools
+</Card>
+
***
## Get started
<CardGroup cols={2}>
- <Card icon="rocket" title="Quickstart" href="/docs/quickstart">
+ <Card icon="fa-light fa-rocket" title="Quickstart" href="/docs/quickstart">
Build your first agent
</Card>
- <Card icon="code" title="Providers" href="/docs/providers">
+ <Card icon="fa-light fa-code" title="Providers" href="/docs/providers">
Integrate with OpenAI, Anthropic, Vercel AI SDK, and more
</Card>
</CardGroup>
@@ -91,13 +95,9 @@ Composio is the fastest way to enable your AI agents to take real-world actions
- **Enforce strict access and data controls** with [fine-grained permissions](/docs/authenticating-tools) for each tool and user.
- **Trigger agents and workflows** using [external events](/docs/using-triggers) (e.g., new message in Slack, new issue in GitHub).
- **Use MCP servers** for all 500+ toolkits, compatible with any [MCP client](/docs/mcp-quickstart).
-- **Search, plan and authenticate** across all tools with [Tool Router](/docs/tool-router/quick-start).
+- **Search, plan and authenticate** across all tools with [Tool Router](/tool-router/overview).
- **Integrate seamlessly** with frameworks like [OpenAI](/providers/openai), [Anthropic](/providers/anthropic), [LangChain](/providers/langchain), [Vercel AI SDK](/providers/vercel), and more.
-<Card icon="flask" title="Tool Router (Beta)" href="/docs/tool-router/quick-start">
- Search, plan, and handle authentication across all the tools.
-</Card>
-
***
## Community
diff --git a/fern/pages/src/mcp/quickstart.mdx b/fern/pages/src/mcp/quickstart.mdx
index 998f40b0e..c95266077 100644
--- a/fern/pages/src/mcp/quickstart.mdx
+++ b/fern/pages/src/mcp/quickstart.mdx
@@ -83,10 +83,10 @@ npm install @composio/core
## Next steps
<Cards>
- <Card title="Server management" href="/docs/mcp-server-management" icon="server">
+ <Card title="Server management" href="/docs/mcp-server-management" icon="fa-light fa-server">
Create and manage MCP servers
</Card>
- <Card title="Providers" href="/docs/mcp-providers" icon="code">
+ <Card title="Providers" href="/docs/mcp-providers" icon="fa-light fa-code">
Use with Anthropic, OpenAI, and other frameworks
</Card>
</Cards>
diff --git a/fern/pages/src/resources/debugging-info.mdx b/fern/pages/src/resources/debugging-info.mdx
index a1bc2b5e4..8fa2be4e3 100644
--- a/fern/pages/src/resources/debugging-info.mdx
+++ b/fern/pages/src/resources/debugging-info.mdx
@@ -41,10 +41,10 @@ The identifiers with `pr_` (project) and `ok_` (organization) prefixes let us qu
<Card title="GitHub Discussions" icon="fa-brands fa-github" href="https://github.com/ComposioHQ/composio/discussions">
Request new tools and share feedback
</Card>
- <Card title="File an Issue" icon="fa-solid fa-bug" href="https://github.com/ComposioHQ/composio/issues">
+ <Card title="File an Issue" icon="fa-light fa-bug" href="https://github.com/ComposioHQ/composio/issues">
Report SDK issues and bugs
</Card>
- <Card title="Contact Support" icon="fa-solid fa-envelope" href="mailto:[email protected]">
+ <Card title="Contact Support" icon="fa-light fa-envelope" href="mailto:[email protected]">
Reach out for dedicated support channels on Growth and Enterprise plans
</Card>
</CardGroup>
diff --git a/fern/pages/src/resources/troubleshooting/overview.mdx b/fern/pages/src/resources/troubleshooting/overview.mdx
index ea9faa33a..533a9fa69 100644
--- a/fern/pages/src/resources/troubleshooting/overview.mdx
+++ b/fern/pages/src/resources/troubleshooting/overview.mdx
@@ -11,7 +11,7 @@ This section is designed to help you quickly identify and resolve common issues
Some quick links:
<Card
title="Report issues"
- icon="fa-solid fa-bug"
+ icon="fa-light fa-bug"
href="https://github.com/ComposioHQ/composio/issues/new?labels=bug"
>
Found a bug? Please create a Github issue!
@@ -19,7 +19,7 @@ Some quick links:
<Card
title="Ask AI"
- icon="fa-solid fa-brain"
+ icon="fa-light fa-brain"
href="https://deepwiki.com/ComposioHQ/composio"
>
Try to use Ask AI in the docs or deepwiki to get the fastes responses on features, types, and best practices.
@@ -27,7 +27,7 @@ Some quick links:
<Card
title="Feature requests"
- icon="fa-solid fa-sparkles"
+ icon="fa-light fa-sparkles"
href="https://github.com/ComposioHQ/composio/issues/new?labels=enhancement"
>
Have an idea for improving Composio? Share your feature suggestions with us and we will prioritise your requests
@@ -35,7 +35,7 @@ Some quick links:
<Card
title="Ask the community"
- icon="fa-solid fa-comments"
+ icon="fa-light fa-comments"
href="https://github.com/ComposioHQ/composio/discussions"
>
Join our GitHub discussions to get help from the community
@@ -51,7 +51,7 @@ Some quick links:
<Card
title="Migration guides"
- icon="fa-solid fa-book"
+ icon="fa-light fa-book"
href="/docs/migration"
>
Check out our migration guides to help you upgrade to the latest version.
diff --git a/fern/pages/src/tools-and-triggers/authenticating-tools.mdx b/fern/pages/src/tools-and-triggers/authenticating-tools.mdx
index 3dfe958e9..850eda76c 100644
--- a/fern/pages/src/tools-and-triggers/authenticating-tools.mdx
+++ b/fern/pages/src/tools-and-triggers/authenticating-tools.mdx
@@ -69,11 +69,11 @@ You should create multiple auth configs for the same toolkit when you need:
- **Different permission levels** - Limiting actions for specific use cases
<CardGroup cols={2}>
-<Card title="Programmatic creation" href="/docs/programmatic-auth-configs" icon="fa-solid fa-code">
+<Card title="Programmatic creation" href="/docs/programmatic-auth-configs" icon="fa-light fa-code">
For managing auth configs across multiple projects, you can create them programmatically via the
API
</Card>
-<Card title="Production white-labeling" href="/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen" icon="fa-solid fa-palette">
+<Card title="Production white-labeling" href="/docs/custom-auth-configs#white-labeling-the-oauth-consent-screen" icon="fa-light fa-palette">
Remove Composio branding from OAuth screens for a fully white-labeled authentication experience
</Card>
</CardGroup>
diff --git a/fern/pages/src/tools-and-triggers/executing-tools.mdx b/fern/pages/src/tools-and-triggers/executing-tools.mdx
index b08d02e4c..11d03a371 100644
--- a/fern/pages/src/tools-and-triggers/executing-tools.mdx
+++ b/fern/pages/src/tools-and-triggers/executing-tools.mdx
@@ -10,7 +10,7 @@ LLMs on their own can only do generation. Tool calling changes that by letting t
In Composio, every **tool** is a single API action—fully described with schema, parameters, and return type. Tools live inside **toolkits** like _Gmail, Slack, or GitHub_, and Composio handles authentication and user scoping.
-<Tip icon="info">
+<Tip icon="fa-light fa-info">
**User Scoping**: All tools are scoped to a specific user - that's why every example includes a
`user_id`. Learn how to structure User IDs in [User Management](./user-management). Each user must authenticate with their respective services (Gmail, Calendar, etc.) - see [Authentication](./authenticating-tools)
</Tip>
@@ -58,7 +58,7 @@ Composio provides support for frameworks like this by making sure the tools are
In case you just want to call a tool without using any framework or LLM provider, you can use the `execute` method directly.
-<Tip icon="lightbulb">
+<Tip icon="fa-light fa-lightbulb">
**Finding tool parameters and types:**
**Platform UI**: [Auth Configs](https://platform.composio.dev?next_page=/auth-configs) → Select your toolkit → Tools & Triggers → Select the tool to see its required and optional parameters
@@ -105,7 +105,7 @@ The `endpoint` can be a relative path or absolute URL. Composio uses the `connec
</CodeGroup>
-<Tip icon="info">
+<Tip icon="fa-light fa-info">
Need an API that isn't supported by any Composio toolkit, or want to extend an existing one? Learn
how to [create custom tools](/docs/custom-tools).
</Tip>
diff --git a/fern/toolkits/src/introduction.mdx b/fern/toolkits/src/introduction.mdx
index 6c716c46a..07d4d06c6 100644
--- a/fern/toolkits/src/introduction.mdx
+++ b/fern/toolkits/src/introduction.mdx
@@ -11,7 +11,7 @@ Composio comes with support for 250+ apps with built in authentication and actio
View the authentication and actions for the Twitter tool.
</Card>
-<Card title="Gmail Tool" href="/toolkits/gmail" icon="fa-solid fa-envelope">
+<Card title="Gmail Tool" href="/toolkits/gmail" icon="fa-light fa-envelope">
View the authentication and actions for the Gmail tool.
</Card>
@@ -19,11 +19,11 @@ View the authentication and actions for the Twitter tool.
View the authentication and actions for the Github tool.
</Card>
-<Card title="Notion Tool" href="/toolkits/notion" icon="fa-solid fa-book">
+<Card title="Notion Tool" href="/toolkits/notion" icon="fa-light fa-book">
View the authentication and actions for the Notion tool.
</Card>
-<Card title="Google Sheets Tool" href="/toolkits/googlesheets" icon="fa-solid fa-file-spreadsheet">
+<Card title="Google Sheets Tool" href="/toolkits/googlesheets" icon="fa-light fa-file-spreadsheet">
View the authentication and actions for the Google Sheets tool.
</Card>