From 1376ea292020f2273eb965679f5cad1a228c8752 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Tue, 17 Mar 2026 18:09:49 +0000
Subject: [PATCH] Document x-mint.mcp extension and undocumented navigation
properties
Generated-By: mintlify-agent
---
api-playground/openapi-setup.mdx | 29 +++++++++++++++++++++++++++++
organize/navigation.mdx | 14 ++++++++++----
organize/settings-reference.mdx | 6 +++---
3 files changed, 42 insertions(+), 7 deletions(-)
diff --git a/api-playground/openapi-setup.mdx b/api-playground/openapi-setup.mdx
index 43008bd4d..a1ecf4d3f 100644
--- a/api-playground/openapi-setup.mdx
+++ b/api-playground/openapi-setup.mdx
@@ -208,6 +208,35 @@ Add content before the auto-generated API documentation using `x-mint: content`.
}
```
+### MCP
+
+Control how individual endpoints are exposed as MCP (Model Context Protocol) tools using `x-mint: mcp`. This lets you enable or disable MCP exposure per endpoint and customize the tool name and description.
+
+```json {6-11}
+{
+ "paths": {
+ "/users": {
+ "get": {
+ "summary": "Get users",
+ "x-mint": {
+ "mcp": {
+ "enabled": true,
+ "name": "list_users",
+ "description": "Retrieve a paginated list of all users"
+ }
+ }
+ }
+ }
+ }
+}
+```
+
+| Field | Type | Description |
+|---|---|---|
+| `enabled` | boolean | Whether the endpoint is exposed as an MCP tool. |
+| `name` | string | Custom name for the MCP tool. |
+| `description` | string | Custom description for the MCP tool. |
+
### Href
Set the URL of the autogenerated endpoint page using `x-mint: href`. When `x-mint: href` is present, the generated API page uses the specified URL instead of the default autogenerated URL.
diff --git a/organize/navigation.mdx b/organize/navigation.mdx
index 16eaceaed..a08c52f06 100644
--- a/organize/navigation.mdx
+++ b/organize/navigation.mdx
@@ -159,6 +159,8 @@ Tabs create distinct sections of your documentation with separate URL paths. Tab
In the `navigation` object, `tabs` is an array where each entry is an object that requires a `tab` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
+Set `align` to `"end"` to push a tab to the right side of the tab bar. Tabs default to `"start"` alignment.
+
```json
{
"navigation": {
@@ -184,6 +186,7 @@ In the `navigation` object, `tabs` is an array where each entry is an object tha
{
"tab": "Blog",
"icon": "newspaper",
+ "align": "end",
"href": "https://external-link.com/blog"
}
]
@@ -332,7 +335,7 @@ Global anchors support both external URLs and relative paths to pages within you
Products create a dedicated navigation division for organizing product-specific documentation. Use products to separate different offerings, services, or major feature sets within your documentation.
-In the `navigation` object, `products` is an array where each entry is an object that requires a `product` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
+In the `navigation` object, `products` is an array where each entry is an object that requires a `product` field and can contain other navigation fields such as groups, pages, icons, or links to external pages. Set `name` to override the display name shown in the product switcher. Set `color` to a hex code or a `{ light, dark }` object to customize the product accent color.
```json
{
@@ -340,8 +343,10 @@ In the `navigation` object, `products` is an array where each entry is an object
"products": [
{
"product": "Core API",
- "description": "Core API description",
+ "name": "API",
+ "description": "Core API description",
"icon": "api",
+ "color": "#6366f1",
"groups": [
{
"group": "Getting started",
@@ -396,7 +401,7 @@ Dropdowns are an expandable menu at the top of your sidebar navigation. Each ite
alt="Decorative graphic of a dropdown navigation."
/>
-In the `navigation` object, `dropdowns` is an array where each entry is an object that requires a `dropdown` field and can contain other navigation fields such as groups, pages, icons, or links to external pages.
+In the `navigation` object, `dropdowns` is an array where each entry is an object that requires a `dropdown` field and can contain other navigation fields such as groups, pages, icons, or links to external pages. Set `description` to add helper text below the dropdown label. Set `color` to a hex code or a `{ light, dark }` object to customize the dropdown accent color.
```json
{
@@ -405,6 +410,7 @@ In the `navigation` object, `dropdowns` is an array where each entry is an objec
{
"dropdown": "Documentation",
"icon": "book-open",
+ "description": "Guides and reference material",
"pages": [
"quickstart",
"development",
@@ -636,7 +642,7 @@ We currently support the following languages for localization:
-
+
diff --git a/organize/settings-reference.mdx b/organize/settings-reference.mdx
index f14498145..48f530577 100644
--- a/organize/settings-reference.mdx
+++ b/organize/settings-reference.mdx
@@ -129,7 +129,7 @@ Global navigation elements that appear across all pages and locales.
Top-level navigation tabs.
-**Type:** array of object — each with: `tab` (string, required), `icon` (string), `iconType` (string), `hidden` (boolean), `href` (string uri, required)
+**Type:** array of object — each with: `tab` (string, required), `icon` (string), `iconType` (string), `hidden` (boolean), `align` (`"start"` | `"end"`), `href` (string uri, required)
##### `navigation.global.anchors`
@@ -141,7 +141,7 @@ Sidebar anchor links.
Dropdown menus.
-**Type:** array of object — each with: `dropdown` (string, required), `icon` (string), `iconType` (string), `hidden` (boolean), `href` (string uri, required)
+**Type:** array of object — each with: `dropdown` (string, required), `icon` (string), `iconType` (string), `description` (string), `color` (string hex or `{ light, dark }` object), `hidden` (boolean), `href` (string uri, required)
##### `navigation.global.languages`
@@ -161,7 +161,7 @@ Version switcher in the global nav.
Product switcher in the global nav.
-**Type:** array of object — each with: `product` (string, required), `description` (string), `icon` (string), `iconType` (string)
+**Type:** array of object — each with: `product` (string, required), `name` (string), `description` (string), `icon` (string), `iconType` (string), `color` (string hex or `{ light, dark }` object), `hidden` (boolean)
#### `navigation.languages`