Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
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.tsxindex 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.tsindex 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[], detailedTrireturn 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.mdasync 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/changelogif (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.tsxnew file mode 100644index 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.tsxindex 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.mdxindex 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.mdxnew file mode 100644index 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.mdxindex 86b0e60ac..776ae2652 100644--- a/docs/content/toolkits/premium-tools.mdx+++ b/docs/content/toolkits/premium-tools.mdx@@ -3,10 +3,6 @@ title: Premium Toolsdescription: 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.tsxindex 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,