mintlify · mintlify · Apr 10, 2026 · Apr 10, 2026 · Apr 10, 2026
diff --git a/ai/model-context-protocol.mdx b/ai/model-context-protocol.mdx
@@ -30,6 +30,7 @@
 
 - **Search**: Searches across your documentation to find relevant content, returning snippets with titles and links. Use this when you need to discover information or find pages matching a query.
 - **Get page**: Retrieves the full content of a specific documentation page by its path. Use this when you already know the page path, such as from search results, and need the complete content rather than a snippet.
+- **Skills**: Lists and reads [skill files](/ai/skillmd) available on your MCP server.
 
 AI applications determine when to use each tool based on the context of the conversation. For example, an AI application might first search your documentation to find relevant pages, then use the get page tool to retrieve the full content of the most relevant result.
 
@@ -38,7 +39,7 @@
 The MCP search tool supports optional parameters that AI applications use to control and refine search results.

 - **`pageSize`**: Number of results to return, between 1 and 50. Defaults to 10.
 - **`scoreThreshold`**: Minimum relevance score between 0 and 1. Only returns results at or above this threshold. Use this to filter out low-relevance matches.
 - **`version`**: Filter results to a specific documentation version. For example, `'v0.7'`. Only returns content tagged with the specified version or content available across all versions.
 - **`language`**: Filter results to a specific language code. For example, `'en'`, `'zh'`, or `'es'`. Only returns content in the specified language or content available across all languages.

@@ -50,6 +51,14 @@
 
 - **`page`**: The page path to retrieve, such as `'api-reference/create-customer'`. Use page paths returned from search results.
 
+### Skills
+
+If your documentation includes skill files, your MCP server exposes each skill as an MCP resource. These resources let AI applications read your skill files directly through the MCP protocol instead of fetching them over HTTP.
+
+Each skill registers as a resource at a `mintlify://skills/{slug}` URI with a `text/markdown` MIME type. AI applications call `resources/list` to discover available skills and `resources/read` to retrieve the content of a specific skill.
+
+If your documentation has no skill files, the MCP server does not advertise the skills resources capability.
+
 ### MCP compared to web search
 
 AI tools can search the web, but MCP provides distinct advantages for documentation.

diff --git a/ai/skillmd.mdx b/ai/skillmd.mdx
@@ -46,7 +46,7 @@
  better results using your product with their AI tools.
 </Tip>

 ## `skill.md` structure

 Mintlify generates a `skill.md` file following the [agentskills.io specification](https://agentskills.io/specification). The generated file includes:

@@ -105,7 +105,7 @@
  docs.json
 ```

 Mintlify resolves symlinks during deployment, so the skill files are discovered and served as if they were directly inside `.mintlify/skills/`. This works with both directory symlinks and individual skill symlinks.

 ### Frontmatter fields

@@ -191,3 +191,9 @@
 ### Individual skill files
 
 `GET /.well-known/skills/{name}/skill.md` returns the `skill.md` file for a specific skill identified by its slugified name from the index.
+
+### Access skills through MCP
+
+Your documentation site exposes any skill files as MCP resources. AI applications connected to your MCP server can discover and read your skills using `resources/list` and `resources/read` without making separate HTTP requests.
+
+Each skill is available at a `mintlify://skills/{slug}` URI with a `text/markdown` MIME type. This works on both the `/mcp` and `/authed/mcp` endpoints.
diff --git a/es/ai/model-context-protocol.mdx b/es/ai/model-context-protocol.mdx
@@ -12,7 +12,7 @@ import { PreviewButton } from "/snippets/previewbutton.jsx"
 
 El Model Context Protocol (MCP) es un protocolo abierto que crea conexiones estandarizadas entre aplicaciones de IA y servicios externos, como la documentación. Mintlify genera un servidor MCP a partir de tu documentación, preparando tu contenido para el ecosistema de IA más amplio, donde cualquier cliente MCP (como Claude, Cursor, Goose y otros) puede conectarse a tu documentación.
 
-Tu servidor MCP expone herramientas para que las aplicaciones de IA puedan buscar en tu documentación y obtener el contenido completo de las páginas. Tus usuarios deben conectar tu servidor MCP a sus herramientas.
+Tu servidor MCP expone herramientas para que las aplicaciones de IA puedan buscar en tu documentación y obtener el contenido completo de las páginas. Si tu documentación incluye [archivos skill](/es/ai/skillmd), tu servidor MCP también los expone como recursos que las aplicaciones de IA pueden leer directamente. Tus usuarios deben conectar tu servidor MCP a sus herramientas.
 
 <div id="how-mcp-servers-work">
   ### Cómo funcionan los servidores MCP
@@ -60,6 +60,16 @@ La herramienta get page acepta un parámetro obligatorio:
 
 - **`page`**: La ruta de la página a obtener, como `'api-reference/create-customer'`. Usa las rutas de página devueltas por los resultados de búsqueda.
 
+<div id="mcp-resources">
+  ### Recursos MCP
+</div>
+
+Si tu documentación incluye [archivos skill](/es/ai/skillmd), tu servidor MCP expone cada skill como un recurso MCP. Los recursos permiten que las aplicaciones de IA lean tus archivos skill directamente a través del protocolo MCP en lugar de obtenerlos por HTTP.
+
+Cada skill se registra como un recurso con un URI `mintlify://skills/{slug}` y un tipo MIME `text/markdown`. Las aplicaciones de IA pueden llamar a `resources/list` para descubrir los skills disponibles y a `resources/read` para obtener el contenido de un skill específico.
+
+Si tu documentación no tiene archivos skill, el servidor MCP no anuncia la capacidad de recursos.
+
 <div id="mcp-compared-to-web-search">
   ### MCP en comparación con la búsqueda en la web
 </div>

diff --git a/es/ai/skillmd.mdx b/es/ai/skillmd.mdx
@@ -146,6 +146,14 @@ metadata:
 ---
 ```
 
+<div id="access-skills-through-mcp">
+  ## Acceder a skills a través de MCP
+</div>
+
+Si tu documentación tiene un [servidor MCP](/es/ai/model-context-protocol), tus archivos skill se exponen automáticamente como recursos MCP. Las aplicaciones de IA conectadas a tu servidor MCP pueden descubrir y leer tus skills usando `resources/list` y `resources/read` sin realizar solicitudes HTTP separadas.
+
+Cada skill está disponible en un URI `mintlify://skills/{slug}` con un tipo MIME `text/markdown`. Esto funciona en los endpoints `/mcp` y `/authed/mcp`.
+
 <div id="skills-discovery-endpoints">
   ## Endpoints de descubrimiento de skills
 </div>

diff --git a/fr/ai/model-context-protocol.mdx b/fr/ai/model-context-protocol.mdx
@@ -12,7 +12,7 @@ import { PreviewButton } from "/snippets/previewbutton.jsx"
 
 Le Model Context Protocol (MCP) est un protocole ouvert qui crée des connexions standardisées entre les applications d&#39;IA et des services externes, comme la documentation. Mintlify génère un serveur MCP à partir de votre documentation, en préparant votre contenu pour un écosystème d&#39;IA plus vaste dans lequel n&#39;importe quel client MCP comme Claude, Cursor, Goose, ChatGPT et d&#39;autres peut se connecter à votre documentation.
 
-Votre serveur MCP expose des outils permettant aux applications d'IA de rechercher dans votre documentation et de récupérer le contenu complet des pages. Vos utilisateurs doivent connecter votre serveur MCP à leurs outils.
+Votre serveur MCP expose des outils permettant aux applications d'IA de rechercher dans votre documentation et de récupérer le contenu complet des pages. Si votre documentation inclut des [fichiers skill](/fr/ai/skillmd), votre serveur MCP les expose également en tant que ressources que les applications d'IA peuvent lire directement. Vos utilisateurs doivent connecter votre serveur MCP à leurs outils.
 
 <div id="how-mcp-servers-work">
   ### Fonctionnement des serveurs MCP
@@ -60,6 +60,16 @@ L’outil get page accepte un paramètre obligatoire :
 
 - **`page`** : Le chemin de la page à récupérer, par exemple `'api-reference/create-customer'`. Utilisez les chemins de page renvoyés par les résultats de recherche.
 
+<div id="mcp-resources">
+  ### Ressources MCP
+</div>
+
+Si votre documentation inclut des [fichiers skill](/fr/ai/skillmd), votre serveur MCP expose chaque skill en tant que ressource MCP. Les ressources permettent aux applications d'IA de lire vos fichiers skill directement via le protocole MCP au lieu de les récupérer par HTTP.
+
+Chaque skill est enregistré en tant que ressource avec un URI `mintlify://skills/{slug}` et un type MIME `text/markdown`. Les applications d'IA peuvent appeler `resources/list` pour découvrir les skills disponibles et `resources/read` pour récupérer le contenu d'un skill spécifique.
+
+Si votre documentation ne contient pas de fichiers skill, le serveur MCP n'annonce pas la capacité resources.
+
 <div id="mcp-compared-to-web-search">
   ### MCP par rapport à la recherche sur le web
 </div>

diff --git a/fr/ai/skillmd.mdx b/fr/ai/skillmd.mdx
@@ -147,6 +147,14 @@ metadata:
 ---
 ```
 
+<div id="access-skills-through-mcp">
+  ## Accéder aux skills via MCP
+</div>
+
+Si votre documentation dispose d'un [serveur MCP](/fr/ai/model-context-protocol), vos fichiers skill sont automatiquement exposés en tant que ressources MCP. Les applications d'IA connectées à votre serveur MCP peuvent découvrir et lire vos skills en utilisant `resources/list` et `resources/read` sans effectuer de requêtes HTTP séparées.
+
+Chaque skill est disponible à un URI `mintlify://skills/{slug}` avec un type MIME `text/markdown`. Cela fonctionne sur les endpoints `/mcp` et `/authed/mcp`.
+
 <div id="skills-discovery-endpoints">
   ## Endpoints de découverte des skills
 </div>

diff --git a/zh/ai/model-context-protocol.mdx b/zh/ai/model-context-protocol.mdx
@@ -12,7 +12,7 @@ import { PreviewButton } from "/snippets/previewbutton.jsx"
 
 Model Context Protocol (MCP，模型上下文协议) 是一个开放协议，用于在 AI 应用与外部服务 (例如文档) 之间建立标准化连接。Mintlify 会基于你的文档生成一个 MCP 服务器，为更广泛的 AI 生态系统做好准备，让任何 MCP 客户端例如 Claude、Cursor、Goose、ChatGPT 等都可以连接到你的文档。
 
-你的 MCP 服务器会向 AI 应用提供搜索文档和获取完整页面内容的工具。你的用户必须将你的 MCP 服务器连接到他们的工具中。
+你的 MCP 服务器会向 AI 应用提供搜索文档和获取完整页面内容的工具。如果你的文档包含 [skill 文件](/zh/ai/skillmd)，MCP 服务器还会将它们作为资源暴露，供 AI 应用直接读取。你的用户必须将你的 MCP 服务器连接到他们的工具中。
 
 <div id="how-mcp-servers-work">
   ### MCP 服务器的工作方式
@@ -60,6 +60,16 @@ get page 工具接受一个必填参数：
 
 - **`page`**：要获取的页面路径，例如 `'api-reference/create-customer'`。使用搜索结果中返回的页面路径。
 
+<div id="mcp-resources">
+  ### MCP 资源
+</div>
+
+如果你的文档包含 [skill 文件](/zh/ai/skillmd)，你的 MCP 服务器会将每个 skill 作为 MCP 资源暴露。资源让 AI 应用可以通过 MCP 协议直接读取你的 skill 文件，而无需通过 HTTP 单独获取。
+
+每个 skill 都注册为一个资源，URI 为 `mintlify://skills/{slug}`，MIME 类型为 `text/markdown`。AI 应用可以调用 `resources/list` 来发现可用的 skill，调用 `resources/read` 来获取特定 skill 的内容。
+
+如果你的文档没有 skill 文件，MCP 服务器不会通告资源能力。
+
 <div id="mcp-compared-to-web-search">
   ### MCP 与网页搜索的对比
 </div>

diff --git a/zh/ai/skillmd.mdx b/zh/ai/skillmd.mdx
@@ -146,6 +146,14 @@ metadata:
 ---
 ```
 
+<div id="access-skills-through-mcp">
+  ## 通过 MCP 访问 skills
+</div>
+
+如果你的文档有 [MCP 服务器](/zh/ai/model-context-protocol)，你的 skill 文件会自动作为 MCP 资源暴露。连接到你的 MCP 服务器的 AI 应用可以使用 `resources/list` 和 `resources/read` 来发现和读取你的 skills，而无需单独发起 HTTP 请求。
+
+每个 skill 都可以通过 `mintlify://skills/{slug}` URI 访问，MIME 类型为 `text/markdown`。这在 `/mcp` 和 `/authed/mcp` 端点上都可用。
+
 <div id="skills-discovery-endpoints">
   ## Skills 发现端点
 </div>