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.

navigation high level changes

Sushmithamallesh4fbd95270cbe
diff --git a/fern/docs.yml b/fern/docs.yml
index 409707196..b854269f0 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -90,10 +90,16 @@ redirects:
destination: /type-script
- source: /sdk-reference/type-script/:path
destination: /type-script/:path
+- source: /docs/tool-router/quick-start
+ destination: /tool-router/overview
tabs:
docs:
display-name: Docs
slug: docs
+ tool-router:
+ display-name: Tool Router
+ icon: fa-sparkles
+ slug: tool-router
providers:
display-name: Providers
skip-slug: true
@@ -128,6 +134,24 @@ navigation:
- changelog: ./pages/src/changelog
title: Changelog
slug: changelog
+ - section: Capabilities
+ icon: fa-layer-group
+ skip-slug: true
+ contents:
+ - link: Tool Router
+ href: /tool-router/overview
+ - page: Managed Authentication
+ path: pages/dist/capabilities/managed-authentication.mdx
+ slug: managed-authentication
+ - page: Tools
+ path: pages/dist/capabilities/tools.mdx
+ slug: tools
+ - page: MCP
+ path: pages/dist/capabilities/mcp.mdx
+ slug: mcp
+ - page: Triggers
+ path: pages/dist/capabilities/triggers.mdx
+ slug: triggers
- section: Tools and Triggers
icon: fa-light fa-wrench
skip-slug: true
@@ -194,13 +218,6 @@ navigation:
- page: Providers
path: pages/dist/mcp/providers.mdx
slug: mcp-providers
- - section: Tool Router (Beta)
- icon: fa-light fa-flask
- skip-slug: true
- contents:
- - page: Quick Start
- path: pages/dist/tool-router/quick-start.mdx
- slug: tool-router/quick-start
- section: Resources
icon: fa-light fa-book
skip-slug: true
@@ -253,6 +270,64 @@ navigation:
- page: Triggers
path: pages/dist/resources/troubleshooting/triggers.mdx
slug: triggers
+- tab: tool-router
+ layout:
+ - section: Get Started
+ icon: fa-light fa-rocket
+ skip-slug: true
+ contents:
+ - page: Overview
+ path: pages/dist/tool-router/overview.mdx
+ slug: overview
+ - page: Quickstart
+ path: pages/dist/tool-router/quickstart.mdx
+ slug: quickstart
+ - section: Core Concepts
+ icon: fa-light fa-brain
+ skip-slug: true
+ contents:
+ - page: Understanding Tool Router
+ path: pages/dist/tool-router/understanding-tool-router.mdx
+ slug: understanding-tool-router
+ - page: Sessions
+ path: pages/dist/tool-router/sessions.mdx
+ slug: sessions
+ - page: Meta-Tools
+ path: pages/dist/tool-router/meta-tools.mdx
+ slug: meta-tools
+ - section: Configuration
+ icon: fa-light fa-cog
+ skip-slug: true
+ contents:
+ - page: Toolkit Management
+ path: pages/dist/tool-router/toolkit-management.mdx
+ slug: toolkit-management
+ - page: Permissions
+ path: pages/dist/tool-router/permissions.mdx
+ slug: permissions
+ - section: Authentication
+ icon: fa-light fa-key
+ skip-slug: true
+ contents:
+ - page: Authentication Flows
+ path: pages/dist/tool-router/authentication-flows.mdx
+ slug: authentication-flows
+ - page: White-Labeling
+ path: pages/dist/tool-router/white-labeling.mdx
+ slug: white-labeling
+ - section: Integration
+ icon: fa-light fa-plug
+ skip-slug: true
+ contents:
+ - page: MCP Integration
+ path: pages/dist/tool-router/mcp-integration.mdx
+ slug: mcp-integration
+ - page: Native SDK
+ path: pages/dist/tool-router/native-sdk.mdx
+ slug: native-sdk
+ - page: Framework Examples
+ path: pages/dist/tool-router/framework-examples.mdx
+ slug: framework-examples
- tab: providers
layout:
- section: Supported Providers
@@ -417,4 +492,4 @@ navigation:
contents:
- page: Tool Generator
path: pages/dist/examples/tool-generator/tool-generator.mdx
- slug: examples/tool-generator
+ slug: examples/tool-generator
\ No newline at end of file
diff --git a/fern/pages/src/capabilities/managed-authentication.mdx b/fern/pages/src/capabilities/managed-authentication.mdx
new file mode 100644
index 000000000..abe88f155
--- /dev/null
+++ b/fern/pages/src/capabilities/managed-authentication.mdx
@@ -0,0 +1,164 @@
+---
+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."
+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.~~
+
+## ~~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~~
+
+<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"
+ href="/docs/authenticating-tools"
+ >
+ ~~Learn how to authenticate tools and manage connections~~
+ </Card>
+
+ <Card
+ title="Custom auth configs"
+ icon="fa-solid fa-cog"
+ href="/docs/custom-auth-configs"
+ >
+ ~~Use your own OAuth apps and credentials~~
+ </Card>
+
+ <Card
+ title="Connected accounts"
+ icon="fa-solid fa-users"
+ href="/docs/connected-accounts"
+ >
+ ~~Manage user connections throughout their lifecycle~~
+ </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
diff --git a/fern/pages/src/capabilities/mcp.mdx b/fern/pages/src/capabilities/mcp.mdx
new file mode 100644
index 000000000..f027853e1
--- /dev/null
+++ b/fern/pages/src/capabilities/mcp.mdx
@@ -0,0 +1,210 @@
+---
+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."
+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~~
+
+<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>
+
+ <Card title="800+ tools instantly" icon="fa-solid fa-rocket">
+ ~~All Composio tools available through a single MCP server configuration.~~
+ </Card>
+
+ <Card title="Zero code required" icon="fa-solid fa-code-branch">
+ ~~Configure once in JSON, use everywhere. No SDK integration needed.~~
+ </Card>
+
+ <Card title="Automatic updates" icon="fa-solid fa-arrows-rotate">
+ ~~New tools and capabilities added automatically without client updates.~~
+ </Card>
+</CardGroup>
+
+## ~~How it works~~
+
+<CodeGroup>
+```json claude_desktop_config.json
+{
+ "mcpServers": {
+ "composio": {
+ "command": "npx",
+ "args": [
+ "-y",
+ "@composio/mcp-server",
+ "{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
diff --git a/fern/pages/src/capabilities/tools.mdx b/fern/pages/src/capabilities/tools.mdx
new file mode 100644
index 000000000..88f78465e
--- /dev/null
+++ b/fern/pages/src/capabilities/tools.mdx
@@ -0,0 +1,214 @@
+---
+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."
+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~~
+
+<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"
+ href="/docs/fetching-tools"
+ >
+ ~~Learn how to retrieve and filter tools for your agents~~
+ </Card>
+
+ <Card
+ title="Executing tools"
+ icon="fa-solid fa-play"
+ href="/docs/executing-tools"
+ >
+ ~~Execute tools and handle responses in your application~~
+ </Card>
+
+ <Card
+ title="Custom tools"
+ icon="fa-solid fa-hammer"
+ href="/docs/custom-tools"
+ >
+ ~~Build your own tools for proprietary systems~~
+ </Card>
+</CardGroup>
\ No newline at end of file
diff --git a/fern/pages/src/capabilities/triggers.mdx b/fern/pages/src/capabilities/triggers.mdx
new file mode 100644
index 000000000..66c2b922a
--- /dev/null
+++ b/fern/pages/src/capabilities/triggers.mdx
@@ -0,0 +1,246 @@
+---
+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"
+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~~
+
+<CardGroup cols={2}>
+ <Card
+ title="Using triggers"
+ icon="fa-solid fa-bolt"
+ href="/docs/using-triggers"
+ >
+ ~~Learn how to subscribe to and handle trigger events~~
+ </Card>
+
+ <Card
+ title="Available triggers"
+ icon="fa-solid fa-list"
+ href="/toolkits/introduction"
+ >
+ ~~Browse all available triggers by toolkit~~
+ </Card>
+
+ <Card
+ title="Event-driven workflows"
+ icon="fa-solid fa-diagram-project"
+ href="/examples/slack-summariser"
+ >
+ ~~See real examples of trigger-based automations~~
+ </Card>
+
+ <Card
+ title="Troubleshooting"
+ icon="fa-solid fa-wrench"
+ href="/docs/troubleshooting/triggers"
+ >
+ ~~Debug common trigger issues and solutions~~
+ </Card>
+</CardGroup>
\ No newline at end of file