Documentation edits made through Mintlify web editor

mintlify[bot] · web-flow · commit 87b8d7ae5808 · 2025-03-14T16:23:11.000Z
diff --git a/advanced/dashboard/permissions.mdx b/advanced/dashboard/permissions.mdx
@@ -5,12 +5,12 @@ description: 'Allow more members of your team to update your docs'
 
 The team member who created your initial docs will have update access to your docs, as long as they push to your documentation repo with the same GitHub account that was used while signing up for Mintlify.
 
-If another editor attempts to update the docs while on the free plan, you will see a warning in your git commit check.
+If another editor attempts to update the docs while on the free plan, you will see a warning in your GitHub commit check.
 
-<Frame>
-  <img className="rounded-md" src="/images/editor-gate.png" />
+<Frame className="my-6">
+  <img className="rounded-md" src="/images/editor-gate.png" alt="Editor gate warning message" />
 </Frame>
 
-In the details of the git check warning, you'll find the link to upgrade your plan. You can also upgrade your plan on the [dashboard](https://dashboard.mintlify.com) to enable unlimited editors to update your docs. Once you upgrade your plan, trigger a manual update or push another change to deploy your updates.
+In the details of the GitHub commit check warning, you'll find the link to upgrade your plan. You can also upgrade your plan on the [dashboard](https://dashboard.mintlify.com) to enable unlimited editors to update your docs. Once you upgrade your plan, trigger a manual update or push another change to deploy your updates.
 
-Learn more about our pricing [here](https://mintlify.com/pricing).
+Learn more about our pricing [here](https://mintlify.com/pricing).
diff --git a/advanced/dashboard/sso.mdx b/advanced/dashboard/sso.mdx
@@ -3,7 +3,7 @@ title: "Single Sign-On (SSO)"
 description: "Customize how your team can login to your admin dashboard"
 ---
 
-Use single sign-on to your dashboard via SAML and OIDC. If you use Okta or Google Workspace, we have provider-specific documentation for setting up SSO, but if you use another provider, please contact us!
+Use Single Sign-On to your dashboard via SAML and OIDC. If you use Okta or Google Workspace, we have provider-specific documentation for setting up SSO. For other providers, please contact us!
 
 <Note>
   SSO functionality is available on our Enterprise plan. [Contact
@@ -20,12 +20,12 @@ Use single sign-on to your dashboard via SAML and OIDC. If you use Okta or Googl
             </Step>
             <Step title="Configure integration">
                 Enter the following:
-                * Single sign-on URL (provided by Mintlify)
+                * Single Sign-On URL (provided by Mintlify)
                 * Audience URI (provided by Mintlify)
                 * Name ID Format: `EmailAddress`
                 * Attribute Statements:
-                    | Name | Name format | Value
-                    | ---- | ----------- | -----
+                    | Name | Name format | Value |
+                    | ---- | ----------- | ----- |
                     | `firstName` | Basic | `user.firstName` |
                     | `lastName` | Basic | `user.lastName` |
             </Step>
@@ -45,8 +45,8 @@ Use single sign-on to your dashboard via SAML and OIDC. If you use Okta or Googl
                 Select the authorization code grant type and enter the Redirect URI provided by Mintlify.
             </Step>
             <Step title="Send us your IdP information">
-                Once the application is set up, navigate to the General tab and locate the client ID & client secret.
-                Please securely provide us with these, along with your Okta instance URL (e.g. `<your-tenant-name>.okta.com`). You can send these via a service like 1Password or SendSafely.
+                Once the application is set up, navigate to the General tab and locate the Client ID & Client Secret.
+                Please securely provide us with these, along with your Okta instance URL (e.g., `<your-tenant-name>.okta.com`). You can send these via a service like 1Password or SendSafely.
             </Step>
         </Steps>
     </Tab>
@@ -58,19 +58,21 @@ Use single sign-on to your dashboard via SAML and OIDC. If you use Okta or Googl
     <Tab title="SAML">
         <Steps>
             <Step title="Create an application">
-                Under `Web and mobile apps`, select `Add custom SAML app` from the `Add app` dropdown.  
+                Under `Web and mobile apps`, select `Add custom SAML app` from the `Add app` dropdown.
+
                 <Frame>
                     ![](/images/gsuite-add-custom-saml-app.png)
-                </Frame>              
+                </Frame>
             </Step>
             <Step title="Send us your IdP information">
-                Copy the provided SSO URL, Entity ID, and x509 certificate and send it to the Mintlify team.
+                Copy the provided SSO URL, Entity ID, and X.509 certificate and send it to the Mintlify team.
+
                 <Frame>
-                    ![](/images/gsuite-saml-metadata.png)                    
+                    ![](/images/gsuite-saml-metadata.png)
                 </Frame>
             </Step>
             <Step title="Configure integration">
-                On the Service provider details page, enter the following:
+                On the Service Provider details page, enter the following:
                 * ACS URL (provided by Mintlify)
                 * Entity ID (provided by Mintlify)
                 * Name ID format: `EMAIL`
@@ -83,12 +85,11 @@ Use single sign-on to your dashboard via SAML and OIDC. If you use Okta or Googl
                 On the next page, enter the following attribute statements:
                 | Google Directory Attribute | App Attribute |
                 | -------------------------- | ------------- |
-                | `First name` | `firstName`  |
+                | `First name` | `firstName` |
                 | `Last name` | `lastName` |
 
                 Once this step is complete and users are assigned to the application, let our team know and we'll enable SSO for your account!
             </Step>
         </Steps>
     </Tab>
-
-</Tabs>
+</Tabs>
diff --git a/advanced/mcp/generate.mdx b/advanced/mcp/generate.mdx
@@ -9,30 +9,37 @@ description: "Learn how to set up your own MCP Server"
   [Installing and using the Mintlify MCP Server](/advanced/mcp/quickstart) page.
 </Tip>
 
-## Get started
+## Get Started
 
-Run `npm i mcp` to install the `mcp` CLI.
+Run `npm i mcp` to install the MCP CLI.
 
-In the [dashboard](https://dashboard.mintlify.com/products/mcp) go to `MCP Server`, on this page toggle to see your unique installation command. This is the command to install your MCP Server with the `mcp` CLI.
+In the [dashboard](https://dashboard.mintlify.com/products/mcp), navigate to the `MCP Server` section. On this page, toggle the display to see your unique installation command. This command will install your MCP Server using the MCP CLI.
 
 <Note>
-  Make sure to toggle OpenAPI access to allow the MCP server to access **all**
-  endpoints in your OpenAPI spec.
+  Make sure to toggle OpenAPI access to allow the MCP Server to access **all**
+  endpoints in your OpenAPI specification.
 </Note>
 
-## Start the MCP server locally
+## Start the MCP Server Locally
 
 <Steps>
   <Step title="Install the server through the CLI">
-    Run the following command to install the server: ```bash npx mcp add [your
-    subdomain] ```
+    Run the following command to install the server:
+    ```bash
+    npx mcp add [your-subdomain]
+    ```
   </Step>
   <Step title="Add the authentication token if applicable">
-    If your API requires an authentication token, tell your end-customer to get
-    it and apply it when given this response: ``` > What is the Authorization
-    (basic token)? ``` Otherwise, you can skip this step.
+    If your API requires an authentication token, instruct your end-customer to provide it when prompted with this response:
+    ```bash
+    > What is the Authorization (basic token)?
+    ```
+    Otherwise, you can skip this step.
   </Step>
-  <Step title="Start your MCP server">
-    You can now run: ```bash npm --prefix ~/.mcp/[your subdomain] start ```
+  <Step title="Start your MCP Server">
+    You can now run:
+    ```bash
+    npm --prefix ~/.mcp/[your-subdomain] start
+    ```
   </Step>
-</Steps>
+</Steps>
diff --git a/advanced/mcp/quickstart.mdx b/advanced/mcp/quickstart.mdx
@@ -5,7 +5,7 @@ description: "[MCP](https://modelcontextprotocol.io/introduction) simplifies how
 
 ## Introduction
 
-The MCP Generator is a CLI tool that generates an MCP server based on your company's documentation & OpenAPI specification if available. It takes in your documentation and a OpenAPI spec and outputs an MCP server that can be used with any MCP client. The MCP Generator is delivered via [npm package](https://www.npmjs.com/package/mcp) and generates an MCP server that can be used with any MCP client.
+The MCP Generator is a CLI tool that generates an MCP server based on your company's documentation and OpenAPI specification (if available). It takes in your documentation and OpenAPI spec and outputs an MCP server that can be used with any MCP client. The MCP Generator is delivered via [npm package](https://www.npmjs.com/package/mcp) and generates an MCP server that can be used with any MCP client.
 
 Mintlify enables you to create an MCP server that allows AI tools to interact with your docs in these key scenarios:
 
@@ -16,42 +16,45 @@ Mintlify enables you to create an MCP server that allows AI tools to interact wi
      **all** endpoints in your OpenAPI spec.
    </Note>
 
-## Install the MCP server
+## Install the MCP Server
 
 <Tip>
     This page is dedicated to the Mintlify MCP Server. If you are looking for information on generating your MCP, please refer to the [MCP Generator](/advanced/mcp/generate) page.
 </Tip>
 
-## Example installation with the Mintlify MCP server
+## Example Installation with the Mintlify MCP Server
 
-To use the Mintlify MCP server you will need an [API key](https://mintlify.com/docs/advanced/rest-api/overview#authentication) from your Mintlify account. If you don't have one, navigate to `Settings > API Keys > Chat API Key` and create a new key.
+To use the Mintlify MCP server, you will need an [API key](https://mintlify.com/docs/advanced/rest-api/overview#authentication) from your Mintlify account. If you don't have one, navigate to `Settings > API Keys > Chat API Key` and create a new key.
 
-## Start the MCP server locally
+## Start the MCP Server Locally
 
 <Steps>
     <Step title="Install the server through the CLI">
         Run the following command to install the server:
+
         ```bash
         npx mcp add mintlify
         ```
     </Step>
     <Step title="Add the authentication token">
         The following response will be given after running the previous command:
+
         ```
         > What is the Authorization (basic token)?
         ```
+
         Using your API chat key, copy the authentication token and paste it into the CLI.
-        
     </Step>
     <Step title="Start your MCP server">
         You can now run:
+
         ```bash
         npm --prefix ~/.mcp/mintlify start
         ```
     </Step>
 </Steps>
 
-## Use your server with Claude
+## Use Your Server with Claude
 
 <Note>
     Download the [Claude Desktop App](https://claude.ai/download)
@@ -60,9 +63,10 @@ To use the Mintlify MCP server you will need an [API key](https://mintlify.com/d
 Once you have the Claude Desktop App installed, follow these steps:
 
 <Steps>
-    <Step title="Navigate to the Settings > Developer" />
+    <Step title="Navigate to Settings > Developer" />
     <Step title="Click on Edit Config">
        Add the following to the `claude_desktop_config.json`: 
+
        ```json 
        {
         "mcpServers": {
@@ -80,9 +84,9 @@ Once you have the Claude Desktop App installed, follow these steps:
     </Step>
     <Step title="If you see the hammer icon, you're all set!">
         If you click on it, you should see the available MCP Tools in your server.
+
         <Frame>
             <img src="/images/mcp-with-claude.png" alt="Claude MCP" />
         </Frame>
     </Step>
-</Steps>
-
+</Steps>
diff --git a/advanced/rest-api/overview.mdx b/advanced/rest-api/overview.mdx
@@ -7,36 +7,29 @@ title: Overview
 You can leverage the REST API to programmatically trigger an update when desired.
 
 <Info>
-  While the primary use-case will be to trigger updates, we will be adding more and more
-  functionality to the API overtime. Let us know what else you want to see in
-  [our community](https://mintlify.com/community)!
+  While the primary use case will be to trigger updates, we will be adding more functionality to the API over time. Let us know what else you would like to see in [our community](https://mintlify.com/community)!
 </Info>
 
 ## Authentication
 
-You can generate an API key through
-[the dashboard](https://dashboard.mintlify.com/settings/organization/api-keys). The API key is
-associated with the entire org and can be used across multiple deployments.
+You can generate an API key through [the dashboard](https://dashboard.mintlify.com/settings/organization/api-keys). The API key is associated with the entire organization and can be used across multiple deployments.
 
-<Frame>
-  <img src="/images/external-api-key.png" />
+<Frame caption="Generate API keys in the dashboard">
+  <img src="/images/external-api-key.png" alt="API key generation interface" />
 </Frame>
 
-## Admin API key
+## Admin API Key
 
 The Admin API key is used for the majority of the API. It is used to trigger updates via the [Update endpoint](/advanced/rest-api/update/trigger).
 
-## Chat API key
+## Chat API Key
 
-The Chat API allows you to embed the AI chat experience grounded in your docs and continually kept up to date into any application of your choosing.
+The Chat API allows you to embed an AI chat experience, grounded in your documentation and continually kept up to date, into any application of your choosing.
 
 Responses include citations so you can point your users to the right places they need to get help.
 
 <Note>
-  The Chat API token is a public token that can be referenced in your
-  frontend code whereas the API key is a server-side token that should be kept
-  secret.
+  The Chat API token is a public token that can be referenced in your frontend code, whereas the Admin API key is a server-side token that should be kept secret.
 </Note>
 
-Now that you have an API key, check out our [example](https://github.com/mintlify/discovery-api-example) for how to use
-the API for AI chat. You can also see a deployed version of this example at [chat.mintlify.com](https://chat.mintlify.com).
+Now that you have an API key, check out our [example repository](https://github.com/mintlify/discovery-api-example) for how to use the API for AI chat. You can also see a deployed version of this example at [chat.mintlify.com](https://chat.mintlify.com).
diff --git a/api-playground/mdx/configuration.mdx b/api-playground/mdx/configuration.mdx
@@ -3,25 +3,25 @@ title: 'MDX Setup'
 description: 'Generate docs pages for your API endpoints using MDX'
 ---
 
-Mintlify allows you to define your API endpoints using a combination of `docs.json` configuration, MDX metadata fields, and the `<ParamFields />` component. From the defined endpoints, we generate an API playground, request examples, and response examples.
+Mintlify allows you to define your API endpoints using a combination of `docs.json` configuration, MDX metadata fields, and the `<ParamFields />` component. From the defined endpoints, we generate an API Playground, request examples, and response examples.
 
 <Steps>
   <Step title="Configure your API">
-    In your `docs.json` file, define your base URL and auth method:
+    In your `docs.json` file, define your base URL and authentication method:
 
     ```json
      "api": {
       "mdx": {
         "server": "https://mintlify.com/api", // string array for multiple base URLs
         "auth": {
           "method": "key",
-          "name": "x-api-key" // options: bearer, basic, key.
+          "name": "x-api-key" // options: bearer, basic, key
         }
       }
     }
     ```
 
-    If you would not like to show an API playground, you don't need to include auth types. Hide the playground with the following field:
+    If you do not want to show an API Playground, you don't need to include authentication types. Hide the playground with the following field:
 
     ```json
     "api": {
@@ -35,7 +35,6 @@ Mintlify allows you to define your API endpoints using a combination of `docs.js
   </Step>
   
   <Step title="Create your endpoint pages">
-
     Each API endpoint page should have a corresponding MDX file. At the top of each file, define:
 
     ```md
@@ -52,23 +51,21 @@ Mintlify allows you to define your API endpoints using a combination of `docs.js
     ```
 
     <Note>
-
-    If you have `server` configured in [docs.json](/settings/global), you can use relative paths like `/v1/endpoint`.
-
+      If you have `server` configured in [docs.json](/settings/global), you can use relative paths like `/v1/endpoint`.
     </Note>
 
-    You can also override the globally-defined display mode for the API playground per page by adding `playground` at the top of the MDX file:
+    You can also override the globally-defined display mode for the API Playground per page by adding `playground` at the top of the MDX file:
 
     ```md
     ---
     title: 'Create new user'
     api: 'POST https://api.mintlify.com/user'
     playground: 'none'
+    ---
     ```
-    
   </Step>
 
   <Step title="Add your endpoints to your docs">
     Add your endpoint pages to the sidebar by adding the paths to the `navigation` field in your `docs.json`. Learn more about structuring your docs [here](/settings/navigation).
   </Step>
-</Steps>
+</Steps>
diff --git a/content/components/code.mdx b/content/components/code.mdx
@@ -32,7 +32,7 @@ helloWorld();
 
 Put the name of your programming language after the three backticks to get syntax highlighting.
 
-We use [Prism](https://prismjs.com/#supported-languages) for syntax highlighting. [Test Drive Prism](https://prismjs.com/test.html#language=markup) lists all the languages supported.
+We use [Prism](https://prismjs.com/#supported-languages) for syntax highlighting. The [Test Drive Prism](https://prismjs.com/test.html#language=markup) page lists all supported languages.
 
 ```java
 class HelloWorld {
@@ -54,7 +54,7 @@ class HelloWorld {
 
 ## Names
 
-Add a title after the programming language to set the name of your code example. The text can be anything as long as its all in one line.
+Add a title after the programming language to set the name of your code example. The text can be anything as long as it's all on one line.
 
 ```javascript Code Block Example
 const hello = "world";
@@ -90,7 +90,7 @@ sayHello();
 
 ## Expandable
 
-If you have a long code block and `[expandable]` after your title to make it close and expand.
+Add `[expandable]` after your title to make a long code block collapsible.
 
 ```python library.py [expandable]
 from datetime import datetime, timedelta
@@ -194,12 +194,12 @@ sayHello();
 
 ## Code Groups
 
-Want to display multiple code examples in one code box? Check out the Code Group docs:
+Want to display multiple code examples in one code box? Check out the Code Group documentation:
 
 <Card
   title="Code Group"
   href="/content/components/code-groups"
   icon="columns-3"
 >
   Read the reference for the Code Group component
-</Card>
+</Card>
diff --git a/docs.json b/docs.json
diff --git a/settings/authentication-personalization/authentication.mdx b/settings/authentication-personalization/authentication.mdx
