From a4637d156518c2b6ff52d0f58a9606c0009328d7 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sat, 31 Oct 2026 00:41:12 +0000
Subject: [PATCH] docs: note that admin MCP auth switching only carries over
 JWT

---
 ai/mintlify-mcp.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx
index eeef6a618..38217c7e1 100644
--- a/ai/mintlify-mcp.mdx
+++ b/ai/mintlify-mcp.mdx
@@ -280,7 +280,7 @@ Write tools:
 - **`update_deployment_settings`**: Change one dashboard setting, such as `noindex`, `base_path`, `name`, `disable_ai_chat`, `search_settings`, `privacy`, `custom_scripts`, or an add-on. Use `update_config` for `docs.json` settings.
 - **`manage_custom_domain`**: Add or remove a custom domain, provision its hostname, or retrigger hostname validation.
 - **`manage_git_source`**: Add, update, remove, or reorder the Git repositories a project builds from, or set the base source.
-- **`manage_access_auth`**: Configure or remove site [authentication](/deploy/authentication-setup), add or delete passwords, configure end-user authentication, or switch which one is active.
+- **`manage_access_auth`**: Configure or remove site [authentication](/deploy/authentication-setup), add or delete passwords, configure end-user authentication, or switch which one is active. Switching carries over only a JWT configuration. If the active configuration uses any other type, the switch fails with a `409` error and leaves your site unchanged. To change to a different type, configure the new authentication directly.
 - **`manage_workflow`**: Create, update, enable or disable, delete, or trigger an automation.
 - **`manage_workflow_prs`**: Merge or close a pull request that an [automation](/automations) run opened. To merge a pull request for a branch the AI tool edited, use `publish` with `merge: true` instead.
 - **`manage_members_sharing`**: List or remove organization members, update their roles, or manage private page grants and moves in bases.