Director allows you to provide playbooks to AI Agents. A playbook is a set of MCP tools, prompts and configuration that give agents new skills. You can connect Claude, Cursor and VSCode in 1-click, or integrate manually through a single MCP endpoint.Playbooks are portable, declarative YAML files that can easily be shared (or committed to version control). Director is local-first - installation and client integration takes 30 seconds. Director provides all the MCP management functionality you’d expect: tool filtering, logging, strong isolation, and unified OAuth.
Discover and evaluate MCP servers securely. Browse available servers through the Studio or CLI.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Director","colors":{"primary":"#1a211e","light":"#efeded","dark":"#1a211e"},"logo":{"light":"https://mintcdn.com/director/8UYMXXYL2jySjwdR/logo/light.svg?fit=max\u0026auto=format\u0026n=8UYMXXYL2jySjwdR\u0026q=85\u0026s=edfd5aae9c23180186bc3efe37c8b54c","dark":"https://mintcdn.com/director/8UYMXXYL2jySjwdR/logo/dark.svg?fit=max\u0026auto=format\u0026n=8UYMXXYL2jySjwdR\u0026q=85\u0026s=03005753c6d8fbd856f91f4331af0af6"},"favicon":"/favicon.svg","appearance":{"default":"dark"},"background":{"color":{"light":"#fcfcfc","dark":"#131111"}},"footer":{"socials":{"x":"https://x.com/theworkingco","github":"https://github.com/director-run/director"}},"seo":{"metatags":{"robots":"noindex"}},"fonts":{"heading":{"family":"Inter"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"director","hasAudioNarration":false,"actualSubdomain":"director","customDomains":["docs.director.run"],"gitSource":{"type":"github","owner":"director-run","repo":"director","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c90ac633b96a9da59db5","collectionId":"77cf474f-3b87-4cdb-a608-82ef111abee9","schemaVersion":"v2"},"entitlements":{},"buildId":"6a20c90ac633b96a9da59db5:success","clientVersion":"0.0.3894","searchFilterCounts":[{"language":"default","tag":"Concepts","count":5},{"language":"default","tag":"Typescript SDK","count":3},{"language":"default","tag":"Getting Started","count":2},{"language":"default","tag":"Project","count":2},{"language":"default","tag":"Experimental","count":1}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"getting-started/welcome","slug":"/getting-started/welcome","pageMetadata":{"sidebarTitle":"Welcome!","title":"Welcome to Director!","description":"MCP Playbooks for AI agents","icon":"hand-wave","href":"/getting-started/welcome"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"MCP Playbooks for AI agents\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const BetaBadge=()=>{const{Warning}=_provideComponents()||{};if(!Warning)_missingMdxReference(`Warning`,true);return _jsx(Warning,{children:`Director is in BETA and is not yet production ready.`})};function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);return _jsxs(_Fragment,{children:[_jsx(Frame,{caption:`Director overview`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/director/CjAvXf2lj6FQxkzs/images/director-highlevel-overview.png?fit=max\u0026auto=format\u0026n=CjAvXf2lj6FQxkzs\u0026q=85\u0026s=9c4ba9205154a1e6d95a9505078b4a75`,\"data-og-width\":`1764`,width:`1764`,\"data-og-height\":`726`,height:`726`,\"data-path\":`images/director-highlevel-overview.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/director/CjAvXf2lj6FQxkzs/images/director-highlevel-overview.png?w=280\u0026fit=max\u0026auto=format\u0026n=CjAvXf2lj6FQxkzs\u0026q=85\u0026s=4078b3030aef9238719dee75a46925b9 280w, https://mintcdn.com/director/CjAvXf2lj6FQxkzs/images/director-highlevel-overview.png?w=560\u0026fit=max\u0026auto=format\u0026n=CjAvXf2lj6FQxkzs\u0026q=85\u0026s=3993403af27a53fe54e023b45c574b2b 560w, https://mintcdn.com/director/CjAvXf2lj6FQxkzs/images/director-highlevel-overview.png?w=840\u0026fit=max\u0026auto=format\u0026n=CjAvXf2lj6FQxkzs\u0026q=85\u0026s=91ea675881dd261bcc8f171feb4accea 840w, https://mintcdn.com/director/CjAvXf2lj6FQxkzs/images/director-highlevel-overview.png?w=1100\u0026fit=max\u0026auto=format\u0026n=CjAvXf2lj6FQxkzs\u0026q=85\u0026s=b3670abf61d3d90479359e472be1f776 1100w, https://mintcdn.com/director/CjAvXf2lj6FQxkzs/images/director-highlevel-overview.png?w=1650\u0026fit=max\u0026auto=format\u0026n=CjAvXf2lj6FQxkzs\u0026q=85\u0026s=6e8eb93c74366609f4aa4a8961fe6aea 1650w, https://mintcdn.com/director/CjAvXf2lj6FQxkzs/images/director-highlevel-overview.png?w=2500\u0026fit=max\u0026auto=format\u0026n=CjAvXf2lj6FQxkzs\u0026q=85\u0026s=e65dcbf40af7b9bb31e7d9f1ea72ccea 2500w`})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`https://director.run`,children:`Director`}),` allows you to provide `,_jsx(_components.strong,{children:`playbooks`}),` to AI Agents. A playbook is a set of `,_jsx(_components.strong,{children:`MCP tools`}),`, `,_jsx(_components.strong,{children:`prompts`}),` and `,_jsx(_components.strong,{children:`configuration`}),` that give agents new `,_jsx(_components.strong,{children:`skills`}),`. You can connect Claude, Cursor and VSCode in 1-click, or integrate manually through a single MCP endpoint.`]}),`\n`,_jsx(_components.p,{children:`Playbooks are portable, declarative YAML files that can easily be shared (or committed to version control). Director is local-first - installation and client integration takes 30 seconds. Director provides all the MCP management functionality you’d expect: tool filtering, logging, strong isolation, and unified OAuth.`}),`\n`,_jsx(Heading,{level:`2`,id:`key-features`,children:`Key Features`}),`\n`,_jsx(Heading,{level:`4`,id:`-playbooks`,children:`📚 Playbooks`}),`\n`,_jsx(_components.p,{children:`Maintain sets of tools, prompts and config for different tasks or environments.`}),`\n`,_jsx(Heading,{level:`4`,id:`-1-click-integration`,children:`🚀 1-Click Integration`}),`\n`,_jsx(_components.p,{children:`Switch playbooks with a single click. Currently supports Claude Code, Claude Desktop, Cursor, VSCode.`}),`\n`,_jsx(Heading,{level:`4`,id:`-shareable`,children:`🔗 Shareable`}),`\n`,_jsx(_components.p,{children:`Playbooks are flat files which can be shared or committed to version control easily.`}),`\n`,_jsx(Heading,{level:`4`,id:`-local-first`,children:`🏠 Local-First`}),`\n`,_jsx(_components.p,{children:`Director is local-first, designed to easily run on your own machine or infrastructure.`}),`\n`,_jsx(Heading,{level:`4`,id:`-unified-oauth`,children:`🔑 Unified OAuth`}),`\n`,_jsx(_components.p,{children:`Connect to OAuth MCPs centrally, and use them across all of your agents.`}),`\n`,_jsx(Heading,{level:`4`,id:`-tool-filtering`,children:`🎯 Tool Filtering`}),`\n`,_jsx(_components.p,{children:`Select only the MCP tools that are required for the specific task, preserving context.`}),`\n`,_jsx(Heading,{level:`4`,id:`-declarative`,children:`📋 Declarative`}),`\n`,_jsx(_components.p,{children:`Like terraform for AI agents, Director will enforce playbook to client mapping on startup.`}),`\n`,_jsx(Heading,{level:`4`,id:`-flexibility`,children:`🔧 Flexibility`}),`\n`,_jsx(_components.p,{children:`Configure director through the UI, by editing the config file, through the CLI or using the Typescript SDK.`}),`\n`,_jsx(Heading,{level:`4`,id:`-observability`,children:`📊 Observability`}),`\n`,_jsx(_components.p,{children:`Centralized JSON logging that allows you to understand exactly what your agent is doing.`}),`\n`,_jsx(Heading,{level:`4`,id:`-mcp-compliant`,children:`🔌 MCP Compliant`}),`\n`,_jsx(_components.p,{children:`Just works with any MCP server or client. Up to date with the latest MCP spec.`}),`\n`,_jsx(Heading,{level:`4`,id:`mcp-registry`,children:`MCP Registry`}),`\n`,_jsxs(_components.p,{children:[`Discover and evaluate MCP servers securely. Browse available servers through the `,_jsx(_components.a,{href:`/getting-started/studio`,children:`Studio`}),` or CLI.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{BetaBadge,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"sidebarTitle":"Welcome!","title":"Welcome to Director!","description":"MCP Playbooks for AI agents","icon":"hand-wave","href":"/getting-started/welcome"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Key Features","slug":"key-features","depth":2,"children":[{"title":"📚 Playbooks","slug":"-playbooks","depth":4,"children":[]},{"title":"🚀 1-Click Integration","slug":"-1-click-integration","depth":4,"children":[]},{"title":"🔗 Shareable","slug":"-shareable","depth":4,"children":[]},{"title":"🏠 Local-First","slug":"-local-first","depth":4,"children":[]},{"title":"🔑 Unified OAuth","slug":"-unified-oauth","depth":4,"children":[]},{"title":"🎯 Tool Filtering","slug":"-tool-filtering","depth":4,"children":[]},{"title":"📋 Declarative","slug":"-declarative","depth":4,"children":[]},{"title":"🔧 Flexibility","slug":"-flexibility","depth":4,"children":[]},{"title":"📊 Observability","slug":"-observability","depth":4,"children":[]},{"title":"🔌 MCP Compliant","slug":"-mcp-compliant","depth":4,"children":[]},{"title":"MCP Registry","slug":"mcp-registry","depth":4,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"director","siteName":"Director","title":"Welcome to Director! - Director","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-10-29T16:51:52.485Z","originalFileLocation":"getting-started/welcome.mdx"},"headHtml":"\u003cmeta data-mint-head name=\"description\" content=\"MCP Playbooks for AI agents\">\u003cmeta data-mint-head name=\"application-name\" content=\"Director\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Welcome to Director! - Director\">\u003cmeta data-mint-head property=\"og:description\" content=\"MCP Playbooks for AI agents\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Director\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.director.run/getting-started/welcome\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Welcome to Director! - Director\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"MCP Playbooks for AI agents\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/director/cGufdwalkGp77hrI/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Director\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1a211e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.director.run/getting-started/welcome\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/getting-started/welcome.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.director.run/#organization\",\"name\":\"Director\",\"url\":\"https://docs.director.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/director/8UYMXXYL2jySjwdR/logo/light.svg?fit=max\u0026auto=format\u0026n=8UYMXXYL2jySjwdR\u0026q=85\u0026s=edfd5aae9c23180186bc3efe37c8b54c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.director.run#website\",\"name\":\"Director\",\"url\":\"https://docs.director.run\",\"publisher\":{\"@id\":\"https://docs.director.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.director.run/getting-started/welcome#webpage\",\"url\":\"https://docs.director.run/getting-started/welcome\",\"name\":\"Welcome to Director!\",\"description\":\"MCP Playbooks for AI agents\",\"dateModified\":\"2025-10-29T16:51:52.485Z\",\"isPartOf\":{\"@id\":\"https://docs.director.run#website\"},\"breadcrumb\":{\"@id\":\"https://docs.director.run/getting-started/welcome#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.director.run/getting-started/welcome#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Director\",\"item\":\"https://docs.director.run\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Welcome to Director!\",\"item\":\"https://docs.director.run/getting-started/welcome\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.director.run/getting-started/welcome#article\",\"headline\":\"Welcome to Director!\",\"name\":\"Welcome to Director!\",\"description\":\"MCP Playbooks for AI agents\",\"url\":\"https://docs.director.run/getting-started/welcome\",\"mainEntityOfPage\":{\"@id\":\"https://docs.director.run/getting-started/welcome#webpage\"},\"dateModified\":\"2025-10-29T16:51:52.485Z\",\"publisher\":{\"@id\":\"https://docs.director.run/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.director.run#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Director\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Director","nav":{"global":null,"groups":[{"group":"Getting Started","pages":[{"sidebarTitle":"Welcome!","title":"Welcome to Director!","icon":"hand-wave","href":"/getting-started/welcome"},{"title":"Quickstart","description":"Getting started with Director","icon":"rocket","href":"/getting-started/quickstart"}]},{"group":"Concepts","pages":[{"title":"Architecture","icon":"sitemap","href":"/concepts/architecture"},{"sidebarTitle":"CLI","title":"CLI Reference","icon":"terminal","href":"/concepts/cli"},{"title":"Studio","icon":"desktop","href":"/concepts/studio"},{"title":"Registry","icon":"book","href":"/concepts/registry"},{"title":"Configuration Files","sidebarTitle":"Configuration","icon":"gear","href":"/concepts/configuration"}]},{"group":"Typescript SDK","pages":[{"sidebarTitle":"Gateway","title":"Gateway API Reference","href":"/sdk/gateway"},{"sidebarTitle":"MCP","title":"MCP API Reference","href":"/sdk/mcp"},{"sidebarTitle":"Client Configurator","title":"Client API Reference","href":"/sdk/client-configurator"}]},{"group":"Experimental","pages":[{"sidebarTitle":"Docker","title":"Running in Docker","href":"/experimental/docker"}]},{"group":"Project","pages":[{"title":null,"href":"/project/roadmap"},{"sidebarTitle":"Contributing","title":"Contributing","href":"/project/contributing"}]}]},"title":"Welcome to Director! - Director","buildId":"dpl_8LJVMfxYNq6LJkohTrn2iyWT8umj","deploymentId":"dpl_8LJVMfxYNq6LJkohTrn2iyWT8umj","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DgIorxK1.js","DynamicMarkdown-43fmNsOD.js","zoom-image-lightbox-D9lJgLSo.js","PlusIcon-C1lem43w.js","lightbox-handle-r17bVUz3.js"]}
