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.

docs: add managed auth list page and improve toolkits landing

Sushmitha Mallesha032fb8edc35
diff --git a/docs/app/(home)/toolkits/[[...slug]]/page.tsx b/docs/app/(home)/toolkits/[[...slug]]/page.tsx
index b54e28e2e..3488a9c68 100644
--- a/docs/app/(home)/toolkits/[[...slug]]/page.tsx
+++ b/docs/app/(home)/toolkits/[[...slug]]/page.tsx
@@ -208,6 +208,8 @@ export default async function ToolkitsPage({ params }: { params: Promise<{ slug?
const MDXContent = page.data.body;
return (
<article className="prose prose-fd max-w-none">
+ <a href="/toolkits" className="text-sm text-fd-primary no-underline hover:underline">← All Toolkits</a>
+ <h1>{page.data.title}</h1>
<PageActions path={page.url} />
<MDXContent components={getMDXComponents()} />
</article>
diff --git a/docs/app/llms.mdx/[[...slug]]/route.ts b/docs/app/llms.mdx/[[...slug]]/route.ts
index 1b2fa2426..0c54d9b0e 100644
--- a/docs/app/llms.mdx/[[...slug]]/route.ts
+++ b/docs/app/llms.mdx/[[...slug]]/route.ts
@@ -706,6 +706,60 @@ function toolkitToMarkdown(toolkit: Toolkit, detailedTools?: Tool[], detailedTri
return lines.join('\n');
}
+// Generate markdown for /toolkits/managed-auth.md
+async function generateManagedAuthIndex(): Promise<string> {
+ const toolkits = await getAllToolkits();
+
+ // Only include OAuth toolkits
+ const oauthToolkits = toolkits.filter((t) =>
+ t.authSchemes?.some((s) => s.toUpperCase().includes('OAUTH'))
+ );
+
+ const managed = oauthToolkits
+ .filter((t) => t.composioManagedAuthSchemes && t.composioManagedAuthSchemes.length > 0)
+ .sort((a, b) => (a.name?.trim() || '').localeCompare(b.name?.trim() || ''));
+
+ const unmanaged = oauthToolkits
+ .filter((t) => !t.composioManagedAuthSchemes || t.composioManagedAuthSchemes.length === 0)
+ .sort((a, b) => (a.name?.trim() || '').localeCompare(b.name?.trim() || ''));
+
+ const lines: string[] = [
+ '# Composio Managed Auth',
+ '',
+ 'Toolkits with managed auth work out of the box with no OAuth setup. For toolkits without managed auth, you need to provide your own credentials.',
+ '',
+ 'You can also check programmatically whether a toolkit has managed auth:',
+ '',
+ '```bash',
+ "curl 'https://backend.composio.dev/api/v3/toolkits/posthog' \\",
+ " -H 'x-api-key: YOUR_API_KEY'",
+ '```',
+ '',
+ 'See [When to use your own developer credentials](/docs/custom-app-vs-managed-app.md) for help deciding which approach fits your use case.',
+ '',
+ `## Composio Managed App Available (${managed.length})`,
+ '',
+ '| Toolkit | Slug |',
+ '|---------|------|',
+ ];
+
+ for (const t of managed) {
+ lines.push(`| [${t.name?.trim() || t.slug}](/toolkits/${t.slug}.md) | \`${t.slug.toUpperCase()}\` |`);
+ }
+
+ lines.push('');
+ lines.push(`## Requires Your Own Credentials (${unmanaged.length})`);
+ lines.push('');
+ lines.push('| Toolkit | Slug |');
+ lines.push('|---------|------|');
+
+ for (const t of unmanaged) {
+ lines.push(`| [${t.name?.trim() || t.slug}](/toolkits/${t.slug}.md) | \`${t.slug.toUpperCase()}\` |`);
+ }
+
+ return lines.join('\n');
+}
+
// Generate a comprehensive toolkits index for /toolkits.md
async function generateToolkitsIndex(): Promise<string> {
const toolkits = await getAllToolkits();
@@ -720,6 +774,9 @@ async function generateToolkitsIndex(): Promise<string> {
'',
`Composio supports ${toolkits.length} toolkits for building AI agents.`,
'',
+ '- [Premium Tools](/toolkits/premium-tools.md) - Learn about pricing and limits',
+ '- [Composio Managed Auth](/toolkits/managed-auth.md) - Check which toolkits have managed auth',
+ '',
'## All Toolkits',
'',
'| Toolkit | Slug | Tools | Triggers | Auth | Managed App |',
@@ -852,6 +909,16 @@ export async function GET(
});
}
+ // Special handling for managed auth page - generate server-side list
+ if (prefix === 'toolkits' && rest.length === 1 && rest[0] === 'managed-auth') {
+ const managedAuthIndex = await generateManagedAuthIndex();
+ return new Response(managedAuthIndex, {
+ headers: {
+ 'Content-Type': 'text/markdown; charset=utf-8',
+ },
+ });
+ }
+
// Special handling for changelog index - /docs/changelog
if (prefix === 'docs' && rest[0] === 'changelog' && rest.length === 1) {
const changelogIndex = generateChangelogIndex();
diff --git a/docs/components/toolkits/managed-auth-list.tsx b/docs/components/toolkits/managed-auth-list.tsx
new file mode 100644
index 000000000..9e2a04173
--- /dev/null
+++ b/docs/components/toolkits/managed-auth-list.tsx
@@ -0,0 +1,208 @@
+'use client';
+
+import { useState, useMemo, useDeferredValue, useEffect, useRef } from 'react';
+import Link from 'next/link';
+import { Search, Copy, Check } from 'lucide-react';
+
+interface ManagedAuthToolkit {
+ slug: string;
+ name: string;
+ logo: string | null;
+ authSchemes: string[];
+ composioManagedAuthSchemes?: string[];
+ toolCount: number;
+ triggerCount: number;
+}
+
+function CopyButton({ toolkits }: { toolkits: ManagedAuthToolkit[] }) {
+ const [copied, setCopied] = useState(false);
+
+ const handleCopy = () => {
+ const text = toolkits.map((t) => t.slug).join(', ');
+ navigator.clipboard.writeText(text);
+ setCopied(true);
+ setTimeout(() => setCopied(false), 2000);
+ };
+
+ return (
+ <button
+ onClick={handleCopy}
+ className="inline-flex items-center gap-1 text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground"
+ >
+ {copied ? <Check className="h-3 w-3 text-green-500" /> : <Copy className="h-3 w-3" />}
+ {copied ? 'Copied!' : 'Copy slugs'}
+ </button>
+ );
+}
+
+function CopySlugButton({ slug }: { slug: string }) {
+ const [copied, setCopied] = useState(false);
+
+ const handleCopy = (e: React.MouseEvent) => {
+ e.preventDefault();
+ navigator.clipboard.writeText(slug.toUpperCase());
+ setCopied(true);
+ setTimeout(() => setCopied(false), 2000);
+ };
+
+ return (
+ <button
+ onClick={handleCopy}
+ aria-label={`Copy ${slug.toUpperCase()} to clipboard`}
+ className="inline-flex items-center gap-1 rounded bg-fd-muted px-1.5 py-0.5 font-mono text-xs text-fd-muted-foreground transition-colors hover:text-fd-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-orange-500"
+ >
+ <span className="max-w-[120px] truncate sm:max-w-none">{slug.toUpperCase()}</span>
+ {copied ? <Check className="h-3 w-3 text-green-500" aria-hidden="true" /> : <Copy className="h-3 w-3" aria-hidden="true" />}
+ </button>
+ );
+}
+
+function ToolkitIcon({ toolkit }: { toolkit: ManagedAuthToolkit }) {
+ const [imgFailed, setImgFailed] = useState(false);
+ const fallback = toolkit.name.trim().charAt(0).toUpperCase();
+
+ return (
+ <div className="flex h-9 w-9 shrink-0 items-center justify-center rounded-lg border border-fd-border/50 bg-fd-background text-sm font-medium text-fd-muted-foreground sm:h-10 sm:w-10">
+ {toolkit.logo && !imgFailed ? (
+ <img
+ src={toolkit.logo}
+ alt=""
+ loading="lazy"
+ decoding="async"
+ className="h-[65%] w-[65%] object-contain"
+ onError={() => setImgFailed(true)}
+ />
+ ) : (
+ fallback
+ )}
+ </div>
+ );
+}
+
+function ToolkitRow({ toolkit }: { toolkit: ManagedAuthToolkit }) {
+ return (
+ <Link
+ href={`/toolkits/${toolkit.slug}`}
+ className="group flex flex-col gap-2 px-2 py-3 transition-colors hover:bg-fd-accent/30 sm:flex-row sm:items-center sm:justify-between sm:px-0 sm:py-2.5"
+ >
+ <div className="flex items-center gap-3">
+ <ToolkitIcon toolkit={toolkit} />
+ <div className="flex min-w-0 flex-1 flex-col gap-1 sm:flex-row sm:items-center sm:gap-3">
+ <span className="truncate text-sm font-medium text-fd-foreground">{toolkit.name.trim()}</span>
+ <CopySlugButton slug={toolkit.slug} />
+ </div>
+ </div>
+ </Link>
+ );
+}
+
+export function ManagedAuthList() {
+ const [data, setData] = useState<ManagedAuthToolkit[] | null>(null);
+ const [tab, setTab] = useState<'managed' | 'unmanaged'>('managed');
+ const [search, setSearch] = useState('');
+ const deferredSearch = useDeferredValue(search);
+
+ useEffect(() => {
+ fetch('/data/toolkits.json')
+ .then((res) => res.json())
+ .then((all: ManagedAuthToolkit[]) => {
+ setData(all.filter((t) => t.authSchemes?.some((s) => s.toUpperCase().includes('OAUTH'))));
+ });
+ }, []);
+
+ const filtered = useMemo(() => {
+ if (!data) return [];
+ const s = deferredSearch.toLowerCase();
+ const list = s
+ ? data.filter((t) => t.name.toLowerCase().includes(s) || t.slug.toLowerCase().includes(s))
+ : data;
+ return list.sort((a, b) => a.name.trim().localeCompare(b.name.trim()));
+ }, [data, deferredSearch]);
+
+ const managed = useMemo(
+ () => filtered.filter((t) => t.composioManagedAuthSchemes && t.composioManagedAuthSchemes.length > 0),
+ [filtered]
+ );
+ const notManaged = useMemo(
+ () => filtered.filter((t) => !t.composioManagedAuthSchemes || t.composioManagedAuthSchemes.length === 0),
+ [filtered]
+ );
+
+ // Auto-switch tab when search leaves current tab empty but other has results
+ const prevSearch = useRef(deferredSearch);
+ useEffect(() => {
+ if (deferredSearch !== prevSearch.current) {
+ prevSearch.current = deferredSearch;
+ if (tab === 'managed' && managed.length === 0 && notManaged.length > 0) {
+ setTab('unmanaged');
+ } else if (tab === 'unmanaged' && notManaged.length === 0 && managed.length > 0) {
+ setTab('managed');
+ }
+ }
+ }, [deferredSearch, tab, managed.length, notManaged.length]);
+
+ const activeList = tab === 'managed' ? managed : notManaged;
+
+ if (!data) {
+ return <p className="py-8 text-center text-sm text-fd-muted-foreground">Loading toolkits...</p>;
+ }
+
+ return (
+ <div className="space-y-4">
+ {/* Search */}
+ <div className="relative">
+ <Search className="absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-fd-muted-foreground" />
+ <input
+ type="text"
+ placeholder="Search toolkits..."
+ autoComplete="off"
+ value={search}
+ onChange={(e) => setSearch(e.target.value)}
+ className="h-10 w-full rounded-lg border border-fd-border bg-fd-background pl-10 pr-4 text-sm text-fd-foreground placeholder:text-fd-muted-foreground focus:outline-none focus-visible:border-orange-500/50 focus-visible:ring-2 focus-visible:ring-orange-500/20"
+ />
+ </div>
+
+ {/* Tabs + Copy */}
+ <div className="flex items-center justify-between border-b border-fd-border">
+ <div className="flex items-center gap-1">
+ <button
+ onClick={() => setTab('managed')}
+ className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
+ tab === 'managed'
+ ? 'border-green-500 text-fd-foreground'
+ : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
+ }`}
+ >
+ <span className="inline-block h-2 w-2 rounded-full bg-green-500" />
+ Composio Managed App Available
+ <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{managed.length}</span>
+ </button>
+ <button
+ onClick={() => setTab('unmanaged')}
+ className={`flex items-center gap-2 border-b-2 px-3 py-2 text-sm font-medium transition-colors ${
+ tab === 'unmanaged'
+ ? 'border-amber-500 text-fd-foreground'
+ : 'border-transparent text-fd-muted-foreground hover:text-fd-foreground'
+ }`}
+ >
+ <span className="inline-block h-2 w-2 rounded-full bg-amber-500" />
+ Requires your own credentials
+ <span className="rounded-full bg-fd-muted px-1.5 py-0.5 text-xs">{notManaged.length}</span>
+ </button>
+ </div>
+ <CopyButton toolkits={activeList} />
+ </div>
+
+ {/* List */}
+ {activeList.length > 0 ? (
+ <div className="divide-y divide-fd-border">
+ {activeList.map((t) => (
+ <ToolkitRow key={t.slug} toolkit={t} />
+ ))}
+ </div>
+ ) : (
+ <p className="py-8 text-center text-sm text-fd-muted-foreground">No toolkits found.</p>
+ )}
+ </div>
+ );
+}
diff --git a/docs/components/toolkits/toolkits-landing.tsx b/docs/components/toolkits/toolkits-landing.tsx
index 26b795b53..2f01b58d5 100644
--- a/docs/components/toolkits/toolkits-landing.tsx
+++ b/docs/components/toolkits/toolkits-landing.tsx
@@ -2,7 +2,8 @@
import { useState, useMemo, useDeferredValue } from 'react';
import Link from 'next/link';
-import { Search, Sparkles, ArrowRight, Wrench, Zap, Copy, Check, ExternalLink, Grip } from 'lucide-react';
+import { Search, Sparkles, Wrench, Zap, Copy, Check, ExternalLink, Grip, ShieldCheck } from 'lucide-react';
+import { Card, Cards } from 'fumadocs-ui/components/card';
import toolkitsData from '@/public/data/toolkits-list.json';
import type { ToolkitSummary } from '@/types/toolkit';
import { PageActions } from '@/components/page-actions';
@@ -178,18 +179,11 @@ export function ToolkitsLanding() {
</div>
</div>
- {/* Premium Tools Card */}
- <Link
- href="/toolkits/premium-tools"
- className="group flex items-center justify-between gap-3 rounded-md border border-orange-500/30 bg-orange-500/5 px-3 py-2.5 transition-all hover:border-orange-500/50 hover:bg-orange-500/10"
- >
- <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
- <Sparkles className="h-4 w-4 shrink-0 text-orange-500" />
- <span className="text-sm font-medium text-fd-foreground">Premium Tools</span>
- <span className="hidden text-sm text-fd-muted-foreground sm:inline">— Learn about pricing and limits</span>
- </div>
- <ArrowRight className="h-4 w-4 shrink-0 text-fd-muted-foreground transition-transform group-hover:translate-x-1 group-hover:text-orange-500" />
- </Link>
+ {/* Cards */}
+ <Cards>
+ <Card icon={<ShieldCheck />} title="Composio Managed Auth" href="/toolkits/managed-auth" description="Check which toolkits have managed auth" />
+ <Card icon={<Sparkles />} title="Premium Tools" href="/toolkits/premium-tools" description="Learn about pricing and limits" />
+ </Cards>
{/* Search */}
<div className="relative">
diff --git a/docs/content/docs/common-faq.mdx b/docs/content/docs/common-faq.mdx
index 2c9556b8e..d9bb43964 100644
--- a/docs/content/docs/common-faq.mdx
+++ b/docs/content/docs/common-faq.mdx
@@ -231,7 +231,16 @@ curl 'https://backend.composio.dev/api/v3/toolkits/github' \
-H 'x-api-key: YOUR_API_KEY'
```
-If the array is empty, you'll need to provide your own credentials. You can also check on each toolkit's page on the [toolkits page](/toolkits).
+If the array is empty, you'll need to provide your own credentials.
+
+To fetch all toolkits and filter by managed auth availability, use the list endpoint:
+
+```bash
+curl 'https://backend.composio.dev/api/v3/toolkits' \
+ -H 'x-api-key: YOUR_API_KEY'
+```
+
+Each toolkit in the response includes `composio_managed_auth_schemes`. You can also browse the full list on the [managed auth page](/toolkits/managed-auth) or check individual toolkit pages on the [toolkits page](/toolkits).
</Accordion>
<Accordion title="What happens to existing connections when I switch to my own OAuth app?">
diff --git a/docs/content/toolkits/managed-auth.mdx b/docs/content/toolkits/managed-auth.mdx
new file mode 100644
index 000000000..ba6d77b7c
--- /dev/null
+++ b/docs/content/toolkits/managed-auth.mdx
@@ -0,0 +1,17 @@
+---
+title: Managed Auth
+description: Check which toolkits have Composio managed authentication
+---
+
+Toolkits with managed auth work out of the box with no OAuth setup. For toolkits without managed auth, you need to provide your own credentials.
+
+You can also check programmatically whether a toolkit has managed auth:
+
+```bash
+curl 'https://backend.composio.dev/api/v3/toolkits/posthog' \
+ -H 'x-api-key: YOUR_API_KEY'
+```
+
+See [When to use your own developer credentials](/docs/custom-app-vs-managed-app) for help deciding which approach fits your use case.
+
+<ManagedAuthList />
diff --git a/docs/content/toolkits/premium-tools.mdx b/docs/content/toolkits/premium-tools.mdx
index 86b0e60ac..776ae2652 100644
--- a/docs/content/toolkits/premium-tools.mdx
+++ b/docs/content/toolkits/premium-tools.mdx
@@ -3,10 +3,6 @@ title: Premium Tools
description: Learn about premium tools, pricing, and limits in Composio
---
-[← All Toolkits](/toolkits)
-
-# Premium Tools
-
This is a quick overview of premium tools, what they are, how they are priced, what limits they have and such.
## What are premium tools?
diff --git a/docs/mdx-components.tsx b/docs/mdx-components.tsx
index e3edc2ece..502da19ac 100644
--- a/docs/mdx-components.tsx
+++ b/docs/mdx-components.tsx
@@ -20,6 +20,7 @@ import { Video } from '@/components/video';
import { CapabilityCard, CapabilityList } from '@/components/capability-card';
import { TemplateCard, TemplateGrid } from '@/components/template-card';
import { ToolkitsLanding } from '@/components/toolkits/toolkits-landing';
+import { ManagedAuthList } from '@/components/toolkits/managed-auth-list';
import { Mermaid } from '@/components/mermaid';
import { AIToolsBanner } from '@/components/ai-tools-banner';
import { Glossary, GlossaryTerm } from '@/components/glossary';
@@ -92,6 +93,7 @@ export function getMDXComponents(components?: MDXComponents): MDXComponents {
TemplateCard,
TemplateGrid,
ToolkitsLanding,
+ ManagedAuthList,
Mermaid,
AIToolsBanner,
StepTitle,