Add x-mint: mcp

ai/model-context-protocol.mdx

@@ -28,7 +28,7 @@
 
 All MCP servers include the `search` tool by default, allowing users to query information from your docs in other tools.
 
-If you have an OpenAPI specification, you can expose specific endpoints as MCP tools by using the `x-mcp` extension at either the file or endpoint level.
+If you have an OpenAPI specification, you can expose specific endpoints as MCP tools by using the `mcp` object within the `x-mint` extension at either the file or endpoint level.
 
 For example, the Mintlify MCP server includes tools to get status updates, trigger updates, and create assistant chats.
 
@@ -39,8 +39,10 @@
 ```json
 {
   "openapi": "3.1.0",
-  "x-mcp": {
-    "enabled": true
+  "x-mint": {
+    "mcp": {
+      "enabled": true
+    }
   },
   // Other OpenAPI content
 }
@@ -54,8 +56,10 @@
 {
   "paths": {
     "/api/v1/users": {
-      "x-mcp": {
-        "enabled": true
+      "x-mint": {
+        "mcp": {
+          "enabled": true
+        }
       },
       // Endpoint configuration
     }
@@ -97,7 +101,7 @@
 
 <Steps>
   <Step title="Open MCP settings">
     1. Use <kbd>Command</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> on Windows) to open the command palette.
     2. Search for "Open MCP settings".
     3. Select **Add custom MCP**. This will open the `mcp.json` file.
   </Step>

api-playground/openapi-setup.mdx

@@ -27,7 +27,7 @@
 
 ### Specifying the URL for your API
 
 To enable Mintlify features like the API playground, add a `servers` field to your OpenAPI document with your API's base URL.
 
 ```json
 {
@@ -181,6 +181,32 @@
 }
 ```
 
+### MCP
+
+Expose endpoints as MCP tools by using `x-mint: mcp`:
+
+```json {6-10}
+{
+  "paths": {
+    "/users": {
+      "post": {
+        "summary": "Create user",
+        "x-mint": {
+          "mcp": {
+            "enabled": true
+          }
+        },
+        "parameters": [
+          {
+            // Parameter configuration
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
 ## Auto-populate API pages
 
 Add an `openapi` field to any navigation element in your `docs.json` to automatically generate pages for OpenAPI endpoints. The `openapi` field accepts either a file path in your docs repo or a URL to a hosted OpenAPI document.
@@ -298,10 +324,10 @@
 
 ### Autogenerate `MDX` files
 
 Use our Mintlify [scraper](https://www.npmjs.com/package/@mintlify/scraping) to autogenerate `MDX` pages for large OpenAPI documents.
 
 <Note>
   Your OpenAPI document must be valid or the files will not autogenerate.
 </Note>
 
 The scraper generates:
@@ -313,12 +339,12 @@
 <Steps>
   <Step title="Generate `MDX` files.">
     ```bash
     npx @mintlify/scraping@latest openapi-file <path-to-openapi-file>
     ```
   </Step>
   <Step title="Specify an output folder.">
     ```bash
     npx @mintlify/scraping@latest openapi-file <path-to-openapi-file> -o api-reference
     ```
 
     Add the `-o` flag to specify a folder to populate the files into. If a folder is not specified, the files will populate in the working directory.