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.

Restructure docs: add Features section, update welcome page

Sushmithamalleshe880a9d8d3ba
diff --git a/docs/content/docs/index.mdx b/docs/content/docs/index.mdx
index c383adf80..4405db382 100644
--- a/docs/content/docs/index.mdx
+++ b/docs/content/docs/index.mdx
@@ -4,68 +4,41 @@ description: Composio is the simplest way to connect AI agents to external tools
keywords: [getting started, introduction]
---
+Connect your AI agents to 800+ tools with managed authentication, tool execution, and multi-user support.
+
<Cards>
<Card
- icon={<Key />}
- title="Managed authentication"
- href="/docs/authenticating-tools"
- description="Handle OAuth, API keys, and custom auth flows automatically"
- />
- <Card
- icon={<Wrench />}
- title="Tool execution"
- href="/docs/executing-tools"
- description="Execute actions across 500+ toolkits with support for most AI frameworks"
+ icon={<Rocket />}
+ title="Quickstart"
+ href="/docs/quickstart"
+ description="Build your first agent in 5 minutes"
/>
<Card
- icon={<Database />}
- title="MCP server"
- href="/docs/mcp-quickstart"
- description="Hosted MCP servers for all 500+ toolkits"
+ icon={<Play />}
+ title="Playground"
+ href="https://platform.composio.dev/auth?next_page=%2Ftool-router"
+ description="Try Composio in your browser"
/>
<Card
- icon={<Zap />}
- title="Triggers"
- href="/docs/using-triggers"
- description="Subscribe to external events and trigger workflows automatically"
+ icon={<Wrench />}
+ title="Toolkits"
+ href="/toolkits"
+ description="Browse 800+ integrations"
/>
-</Cards>
-
-## Get started
-
-<Cards>
<Card
- icon={<Rocket />}
- title="Quickstart"
- href="/docs/quickstart"
- description="Build your first agent"
+ icon={<Key />}
+ title="Authentication"
+ href="/docs/authentication"
+ description="OAuth, API keys, and custom auth flows"
/>
</Cards>
-<Tabs defaultValue="python" id="quickstart-tabs" className="my-6">
- <TabsList>
- <TabsTrigger value="python">Python</TabsTrigger>
- <TabsTrigger value="typescript">TypeScript</TabsTrigger>
- </TabsList>
- <div className="relative mt-2">
- <TabsContent value="python" forceMount className="data-[state=inactive]:invisible data-[state=inactive]:absolute data-[state=inactive]:inset-0">
- <YouTube id="wkqlR8322F4" title="Composio Python Quickstart" />
- </TabsContent>
- <TabsContent value="typescript" forceMount className="data-[state=inactive]:invisible data-[state=inactive]:absolute data-[state=inactive]:inset-0">
- <YouTube id="ZRGb4xGl-kc" title="Composio TypeScript Quickstart" />
- </TabsContent>
- </div>
-</Tabs>
-
-## Why Composio?
+## For AI tools
-Composio is the fastest way to enable your AI agents to take real-world actions—without dealing with individual API integrations, authentication flows, or complex tool formatting.
+Access Composio documentation in Markdown format for use with Cursor, Copilot, Claude, and other AI tools:
-- **Access 500+ toolkits** out of the box across popular apps like Slack, GitHub, Notion, and more. [Browse toolkits →](/toolkits/introduction)
-- **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](/tool-router/overview).
+- [composio.dev/llms.txt](/llms.txt) - Documentation index with links
+- [composio.dev/llms-full.txt](/llms-full.txt) - Complete documentation in one file
## Providers
@@ -84,20 +57,28 @@ Composio works with any AI framework. Pick your preferred SDK:
<ProviderCard name="Build your own" href="/docs/providers/custom-providers" icon={<Blocks size={32} />} languages={["Python", "TypeScript"]} />
</ProviderGrid>
-## For AI tools
-
-Access Composio documentation in Markdown format for use with Cursor, Copilot, Claude, and other AI tools:
+## Features
-- [composio.dev/llms.txt](/llms.txt) - Documentation index with links
-- [composio.dev/llms-full.txt](/llms-full.txt) - Complete documentation in one file
-
-```
-Documentation:
-{paste documentation from composio.dev/llms-full.txt}
----
-Based on the above documentation, answer the following:
-{your question}
-```
+<Cards>
+ <Card
+ icon={<Zap />}
+ title="Triggers"
+ href="/docs/triggers"
+ description="Subscribe to external events and trigger workflows"
+ />
+ <Card
+ icon={<Terminal />}
+ title="CLI"
+ href="/docs/cli"
+ description="Generate types and manage your workspace"
+ />
+ <Card
+ icon={<Database />}
+ title="MCP"
+ href="/docs/mcp/mcp-quickstart"
+ description="Hosted MCP servers for all toolkits"
+ />
+</Cards>
## Community
diff --git a/docs/content/docs/mcp-quickstart.mdx b/docs/content/docs/mcp/mcp-quickstart.mdx
similarity index 98%
rename from docs/content/docs/mcp-quickstart.mdx
rename to docs/content/docs/mcp/mcp-quickstart.mdx
index d70e860cd..a13177f19 100644
--- a/docs/content/docs/mcp-quickstart.mdx
+++ b/docs/content/docs/mcp/mcp-quickstart.mdx
@@ -259,10 +259,10 @@ export const agent = new Agent({
## Next steps
<Cards>
- <Card title="Server management" href="/docs/mcp-server-management">
+ <Card title="Server management" href="/docs/mcp/mcp-server-management">
Create and manage MCP servers
</Card>
- <Card title="Providers" href="/docs/mcp-providers">
+ <Card title="Providers" href="/docs/providers">
Use with Anthropic, OpenAI, and other frameworks
</Card>
</Cards>
diff --git a/docs/content/docs/mcp-server-management.mdx b/docs/content/docs/mcp/mcp-server-management.mdx
similarity index 100%
rename from docs/content/docs/mcp-server-management.mdx
rename to docs/content/docs/mcp/mcp-server-management.mdx
diff --git a/docs/content/docs/mcp/meta.json b/docs/content/docs/mcp/meta.json
new file mode 100644
index 000000000..7d2b3692a
--- /dev/null
+++ b/docs/content/docs/mcp/meta.json
@@ -0,0 +1,7 @@
+{
+ "title": "MCP",
+ "pages": [
+ "mcp-quickstart",
+ "mcp-server-management"
+ ]
+}
diff --git a/docs/content/docs/meta.json b/docs/content/docs/meta.json
index c81e079fc..c1362d03b 100644
--- a/docs/content/docs/meta.json
+++ b/docs/content/docs/meta.json
@@ -8,11 +8,10 @@
"users-and-sessions",
"authentication",
"tools-and-toolkits",
- "---Tools and Triggers---",
+ "---Tools---",
"fetching-tools",
"authenticating-tools",
"executing-tools",
- "using-triggers",
"modify-tool-behavior",
"custom-tools",
"toolkit-versioning",
@@ -22,11 +21,11 @@
"custom-auth-params",
"connected-accounts",
"user-management",
- "---MCP---",
- "mcp-quickstart",
- "mcp-server-management",
- "---Resources---",
+ "---Features---",
+ "triggers",
"cli",
+ "mcp",
+ "---Resources---",
"debugging-info",
"migration-guide",
"troubleshooting"
diff --git a/docs/content/docs/migration-guide/new-sdk.mdx b/docs/content/docs/migration-guide/new-sdk.mdx
index 8258ccab1..2ff203ca7 100644
--- a/docs/content/docs/migration-guide/new-sdk.mdx
+++ b/docs/content/docs/migration-guide/new-sdk.mdx
@@ -1086,7 +1086,7 @@ await composio.triggers.enable("ti_abcd123");
We recommend listening to triggers through webhooks. The following are example routes for Next.js and FastAPI.
-For development, you can also [listen to triggers through the SDK](/docs/using-triggers#subscribing-to-triggers-using-the-sdk-for-development).
+For development, you can also [listen to triggers through the SDK](/docs/triggers#subscribing-to-triggers-using-the-sdk-for-development).
<Tabs items={['FastAPI', 'Next.js']}>
<Tab value="FastAPI">
diff --git a/docs/content/docs/tools-and-toolkits.mdx b/docs/content/docs/tools-and-toolkits.mdx
index 5e706e049..824ed1ef9 100644
--- a/docs/content/docs/tools-and-toolkits.mdx
+++ b/docs/content/docs/tools-and-toolkits.mdx
@@ -80,5 +80,5 @@ const session = await composio.create("user_123");
Your agent can search and use tools from any toolkit. To restrict or configure which toolkits are available, see [Users and sessions](/tool-router/users-and-sessions#enabling-toolkits).
<Callout type="info">
-Triggers can be used alongside Tool Router to respond to events in connected apps. See [Using triggers](/docs/using-triggers) for setup instructions.
+Triggers can be used alongside Tool Router to respond to events in connected apps. See [Triggers](/docs/triggers) for setup instructions.
</Callout>
diff --git a/docs/content/docs/using-triggers.mdx b/docs/content/docs/triggers.mdx
similarity index 99%
rename from docs/content/docs/using-triggers.mdx
rename to docs/content/docs/triggers.mdx
index 30ea0397e..b6230ae05 100644
--- a/docs/content/docs/using-triggers.mdx
+++ b/docs/content/docs/triggers.mdx
@@ -1,5 +1,5 @@
---
-title: Using Triggers
+title: Triggers
description: Send payloads to your AI agents or systems based on events in apps
keywords: [webhooks, events, subscribe, callback]
---
diff --git a/docs/content/docs/troubleshooting/mcp.mdx b/docs/content/docs/troubleshooting/mcp.mdx
index bf4c7a81d..b358bc3c7 100644
--- a/docs/content/docs/troubleshooting/mcp.mdx
+++ b/docs/content/docs/troubleshooting/mcp.mdx
@@ -13,7 +13,7 @@ This error occurs when MCP cannot find a valid connected account for authenticat
- Account status is `ACTIVE` (not deleted)
- Account belongs to the same auth config used to create the MCP server
-Learn more: [MCP Quickstart](/docs/mcp-quickstart)
+Learn more: [MCP Quickstart](/docs/mcp/mcp-quickstart)
## Getting 404 errors
diff --git a/docs/mdx-components.tsx b/docs/mdx-components.tsx
index dd3120aca..f155213fa 100644
--- a/docs/mdx-components.tsx
+++ b/docs/mdx-components.tsx
@@ -23,6 +23,8 @@ import {
Code,
Blocks,
Plug,
+ Play,
+ Terminal,
} from 'lucide-react';
export function getMDXComponents(components?: MDXComponents): MDXComponents {
@@ -63,6 +65,8 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
Code,
Blocks,
Plug,
+ Play,
+ Terminal,
...components,
};
}
diff --git a/docs/next.config.mjs b/docs/next.config.mjs
index 27c51e403..4dcb992f7 100644
--- a/docs/next.config.mjs
+++ b/docs/next.config.mjs
@@ -128,6 +128,22 @@ const config = {
destination: '/reference/api-reference/:path*',
permanent: true,
},
+ // Features section redirects
+ {
+ source: '/docs/using-triggers',
+ destination: '/docs/triggers',
+ permanent: true,
+ },
+ {
+ source: '/docs/mcp-quickstart',
+ destination: '/docs/mcp/mcp-quickstart',
+ permanent: true,
+ },
+ {
+ source: '/docs/mcp-server-management',
+ destination: '/docs/mcp/mcp-server-management',
+ permanent: true,
+ },
];
},
};