copyedit page

Author: ethanpalm

mcp.mdx

@@ -10,7 +10,7 @@ The Model Context Protocol (MCP) is an open protocol that connects your function
 
 ## Quick usage guide
 
-Any public documentation hosted on Mintlify can be extracted as an MCP server using a simple command:
+Any public documentation hosted on Mintlify can be extracted as an MCP server using the following command:
 
 ```bash
 npx mint-mcp add <your-subdomain-or-domain>
@@ -30,18 +30,18 @@ npx mint-mcp add mintlify.com
 
 When you run the command, you'll need to provide two API keys, `External Admin Key` and `Assistant API Key`.
 
-These can be found in your [Mintlify Dashboard](https://dashboard.mintlify.com/settings/organization/api-keys) under **Settings > API Keys**.
+These can be found in your [dashboard](https://dashboard.mintlify.com/settings/organization/api-keys) under **Settings > API Keys**.
 
 <Frame>
-  <img src="/images/mcp/mcp-terminal.png" alt="API Keys" />
+  <img src="/images/mcp/mcp-terminal.png" alt="Terminal prompt asking What is the Bearer Token for Mintlify External API?" />
 </Frame>
 
 ### Select MCP clients
 
 After authentication, you'll choose which MCP clients to enable for your server:
 
 <Frame>
-  <img src="/images/mcp/mcp-terminal-completed.png" alt="MCP Clients" />
+  <img src="/images/mcp/mcp-terminal-completed.png" alt="MCP Clients listed in the terminal." />
 </Frame>
 
 Once configured, your MCP server is ready to use with the command provided in the terminal.
@@ -91,15 +91,15 @@ Enable MCP for specific endpoints only:
 
 ### Authentication handling
 
-If your OpenAPI spec defines authentication using securitySchemes, these authentication methods will be automatically applied to your MCP server.
+If your OpenAPI spec defines authentication using `securitySchemes`, these authentication methods will be automatically applied to your MCP server.
 
 ### Monitoring your MCP server
 
 After publishing your changes, you can view all available MCP tools in the **Available Tools** section on the MCP server page in your dashboard.
 
 <Frame>
-  <img src="/images/mcp/mcp-server-page-light.png" alt="MCP Dashboard" class="block dark:hidden" />
-  <img src="/images/mcp/mcp-server-page-dark.png" alt="MCP Dashboard" class="hidden dark:block" />
+  <img src="/images/mcp/mcp-server-page-light.png" alt="MCP dashboard with Available tools section emphasized" class="block dark:hidden" />
+  <img src="/images/mcp/mcp-server-page-dark.png" alt="MCP dashboard with Available tools section emphasized" class="hidden dark:block" />
 </Frame>
 
 ## Distribution