diff --git a/ai/mintlify-mcp.mdx b/ai/mintlify-mcp.mdx
index 635b9a73c..05227324e 100644
--- a/ai/mintlify-mcp.mdx
+++ b/ai/mintlify-mcp.mdx
@@ -108,12 +108,12 @@ Every admin MCP session binds to a single Git branch. The flow is:
     If your connection has access to more than one project, call `list_deployments` to see which `subdomain` values you can check out. Skip this step if your connection covers only a single project.
   </Step>
   <Step title="Check out a branch">
-    The first required call is `checkout {subdomain}`. It creates a fresh `admin-mcp/<slug>-<sha>` branch from that project's deploy branch (or attaches to an existing branch you name) and returns an `editorUrl` you can open to follow along in the dashboard editor.
+    The first required call is `checkout {subdomain}`. It creates a fresh `admin-mcp/<slug>-<sha>` branch from that project's deploy branch (or attaches to an existing branch you name). It also returns an `editorUrl` you can open to follow along in the dashboard editor.
 
     Call `list_branches` before `checkout` if you need to discover or filter existing branches in a project's repository.
   </Step>
   <Step title="Read, search, and edit">
-    The AI uses tools like `search`, `read`, `list_nodes`, `edit_page`, `write_page`, `create_node`, and `update_config` to make changes. All edits buffer on the session branch in real time—nothing touches your deploy branch yet.
+    The AI uses tools like `search`, `read`, `list_nodes`, `edit_page`, `write_page`, `create_node`, and `update_config` to make changes. All edits buffer on the session branch in real time. Nothing touches your deploy branch yet.
   </Step>
   <Step title="Review the diff">
     Call `diff` at any time to see exactly what changed since your deploy branch. Open an `editorUrl` in your dashboard to see the same changes rendered. When `create_node` adds a page, it returns an `editorUrl` that opens that page directly.
@@ -189,7 +189,7 @@ Code mode handles project-level operations that have no dedicated tool, such as
 - **`list_branches`**: List Git branches available for a project's repository, with optional `query` filtering. Returns the branch names, total count, and the deploy branch. Call this before `checkout` to attach to an existing branch by name.
 - **`get_session_state`**: Inspect the current branch, edited files, and pending nav diff.
 - **`diff`**: List all changes between the session and your deploy branch.
-- **`save`**: Open a pull request or commit to the session branch. If your project allows the agent to push to main and you have no branch protection rules, auto-merges the PR.
+- **`save`**: Open a pull request or commit to the session branch. If your project allows the agent to push to main and you have no branch protection rules, Mintlify auto-merges the PR.
 - **`discard_session`**: Drop the session and its in-flight changes.
 
 ## Example prompts
@@ -236,4 +236,4 @@ Disconnect the admin MCP when you no longer want an AI tool to edit your project
   - Cursor: delete the `mintlify` entry from `mcp.json` and reload.
   - Codex: delete the `[mcp_servers.mintlify]` block from `~/.codex/config.toml`.
 
-Revoking the OAuth grant does not affect pull requests the MCP has already opened. Close or revert those PRs in your Git provider if you want to undo pending changes.
+Revoking the OAuth grant doesn't affect pull requests the MCP has already opened. Close or revert those PRs in your Git provider if you want to undo pending changes.