From c72d706ba346865bac2a5588c9b6991f4fa96038 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 22 Oct 2026 05:32:02 +0000 Subject: [PATCH 1/2] docs: document batched edits for admin MCP edit_page --- 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 2acc0be81b..b33e535b01 100644 --- a/ai/mintlify-mcp.mdx +++ b/ai/mintlify-mcp.mdx @@ -173,7 +173,7 @@ To revoke a credential, click the delete icon next to it. - **`read`**: Fetch the full MDX of any page on `branch`, or on your deploy branch when you omit it. Pass in a file path or UUID. To read a [private page](/editor/pages#private-pages), pass its `private-page-` node ID from `list_nodes` with `visibility: "private"`. Private reads don't need a `branch` and require an OAuth session. The admin MCP rejects client and machine-to-machine tokens for private-page access. - **`search`**: Find lines matching a substring or regular expression across every page on `branch`. Searches your deploy branch when you omit it. -- **`edit_page`**: Apply a targeted edit to a page. To edit a [private page](/editor/pages#private-pages), pass its `private-page-` node ID as `path`. Private edits require an OAuth session with an editor role or higher on the page and don't need a `branch`. +- **`edit_page`**: Apply a targeted edit to a page. Pass `oldString` and `newString` for one replacement, or pass an `edits` list of up to 100 replacements to change several parts of a page in one call. Mintlify applies the edits in order, each to the result of the previous one. If any edit fails, none of them apply. To edit a [private page](/editor/pages#private-pages), pass its `private-page-` node ID as `path`. Private edits require an OAuth session with an editor role or higher on the page and don't need a `branch`. - **`write_page`**: Overwrite a page's full MDX content. Accepts a `private-page-` node ID to overwrite a private page under the same OAuth and role requirements as `edit_page`. Use `create_node` to create a new private page. ### Images From e9cf242653eb0540a2e2275f350cd954ab0f0a92 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 22 Oct 2026 18:06:40 +0000 Subject: [PATCH 2/2] docs: document notRendered in admin MCP write_page and edit_page --- ai/mintlify-mcp.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx index b33e535b01..9133627508 100644 --- a/ai/mintlify-mcp.mdx +++ b/ai/mintlify-mcp.mdx @@ -173,8 +173,8 @@ To revoke a credential, click the delete icon next to it. - **`read`**: Fetch the full MDX of any page on `branch`, or on your deploy branch when you omit it. Pass in a file path or UUID. To read a [private page](/editor/pages#private-pages), pass its `private-page-` node ID from `list_nodes` with `visibility: "private"`. Private reads don't need a `branch` and require an OAuth session. The admin MCP rejects client and machine-to-machine tokens for private-page access. - **`search`**: Find lines matching a substring or regular expression across every page on `branch`. Searches your deploy branch when you omit it. -- **`edit_page`**: Apply a targeted edit to a page. Pass `oldString` and `newString` for one replacement, or pass an `edits` list of up to 100 replacements to change several parts of a page in one call. Mintlify applies the edits in order, each to the result of the previous one. If any edit fails, none of them apply. To edit a [private page](/editor/pages#private-pages), pass its `private-page-` node ID as `path`. Private edits require an OAuth session with an editor role or higher on the page and don't need a `branch`. -- **`write_page`**: Overwrite a page's full MDX content. Accepts a `private-page-` node ID to overwrite a private page under the same OAuth and role requirements as `edit_page`. Use `create_node` to create a new private page. +- **`edit_page`**: Apply a targeted edit to a page. Pass `oldString` and `newString` for one replacement, or pass an `edits` list of up to 100 replacements to change several parts of a page in one call. Mintlify applies the edits in order, each to the result of the previous one. If any edit fails, none of them apply. Like `write_page`, `edit_page` returns `notRendered` for markup the edit adds that the editor drops. It doesn't report markup that was already on the page. To edit a [private page](/editor/pages#private-pages), pass its `private-page-` node ID as `path`. Private edits require an OAuth session with an editor role or higher on the page and don't need a `branch`. +- **`write_page`**: Overwrite a page's full MDX content. Accepts a `private-page-` node ID to overwrite a private page under the same OAuth and role requirements as `edit_page`. Use `create_node` to create a new private page. If the content includes markup the Mintlify editor drops, such as `