Skip to content

Remove .mdx suffixes from internal doc links for Mintlify#1052

Merged
rdimitrov merged 1 commit intomodelcontextprotocol:mainfrom
jonathanhefner:fix-cross-doc-links-for-mintlify
Mar 12, 2026
Merged

Remove .mdx suffixes from internal doc links for Mintlify#1052
rdimitrov merged 1 commit intomodelcontextprotocol:mainfrom
jonathanhefner:fix-cross-doc-links-for-mintlify

Conversation

@jonathanhefner
Copy link
Member

These docs are synced to modelcontextprotocol.io which uses Mintlify for rendering. Mintlify routes are extension-less, so links like ./package-types.mdx produce 404s on the live site. Dropping the .mdx suffix fixes those broken links. The trade-off is that the links no longer resolve when browsing the raw files on GitHub.

These docs are synced to modelcontextprotocol.io which uses Mintlify for
rendering. Mintlify routes are extension-less, so links like
`./package-types.mdx` produce 404s on the live site. Dropping the `.mdx`
suffix fixes those broken links. The trade-off is that the links no
longer resolve when browsing the raw files on GitHub.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@rdimitrov rdimitrov merged commit b941ee3 into modelcontextprotocol:main Mar 12, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants