Skip to content

[docs-scanner] Dynamic MCP experimental status inconsistency across pages #25259

@github-actions

Description

@github-actions

File: content/manuals/ai/mcp-catalog-and-toolkit/dynamic-mcp.md and content/manuals/ai/mcp-catalog-and-toolkit/_index.md

Issue

The documentation presents contradictory information about Dynamic MCP's maturity status across different pages.

In dynamic-mcp.md, the feature is clearly marked as experimental with warnings:

Dynamic MCP is an experimental feature in early development. While you're welcome to try it out and explore its capabilities, you may encounter unexpected behavior or limitations.

However, in _index.md, Dynamic MCP is presented as a standard feature without any experimental warning or caveat:

Dynamic MCP - Discover and add MCP servers on-demand using natural language

The index page describes it alongside other features with no indication that it's experimental or has limitations.

Why this matters

Users reading the overview page will assume Dynamic MCP is production-ready and fully supported. When they encounter issues or limitations, they'll be confused because the overview gave no indication this was experimental. The experimental warning only appears if they navigate to the dedicated Dynamic MCP page.

Suggested fix

Add an experimental indicator to the Dynamic MCP entry in _index.md:

  - title: Dynamic MCP
    description: Discover and add MCP servers on-demand using natural language (Experimental)
    icon: magnifying-glass
    link: /ai/mcp-catalog-and-toolkit/dynamic-mcp/

Or add a note in the grid item description that this is an experimental feature.


Found by nightly documentation quality scanner

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions