Skip to content

Fix broken Mintlify MCP links in translated docs#5630

Merged
mintlify[bot] merged 1 commit intomainfrom
mintlify/fix-broken-mcp-links-1777660271
May 1, 2026
Merged

Fix broken Mintlify MCP links in translated docs#5630
mintlify[bot] merged 1 commit intomainfrom
mintlify/fix-broken-mcp-links-1777660271

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented May 1, 2026

Summary

mint broken-links flagged 6 broken links pointing at /{lang}/ai/mintlify-mcp in the translated docs. The English page /ai/mintlify-mcp exists, but its translated counterparts (es/ai/mintlify-mcp, fr/ai/mintlify-mcp, zh/ai/mintlify-mcp) have not been created yet, and the page is not registered in es.json, fr.json, or zh.json navigation.

Each broken link was repointed to the existing English page /ai/mintlify-mcp so readers reach valid content. When the page is translated in a future PR, these can be updated back to language-prefixed paths.

Broken links and fixes

File Broken link Fix
es/agent/index.mdx (L56) /es/ai/mintlify-mcp — translated page does not exist Repointed to /ai/mintlify-mcp
es/ai/model-context-protocol.mdx (L18) /es/ai/mintlify-mcp — translated page does not exist Repointed to /ai/mintlify-mcp
fr/agent/index.mdx (L56) /fr/ai/mintlify-mcp — translated page does not exist Repointed to /ai/mintlify-mcp
fr/ai/model-context-protocol.mdx (L18) /fr/ai/mintlify-mcp — translated page does not exist Repointed to /ai/mintlify-mcp
zh/agent/index.mdx (L56) /zh/ai/mintlify-mcp — translated page does not exist Repointed to /ai/mintlify-mcp
zh/ai/model-context-protocol.mdx (L18) /zh/ai/mintlify-mcp — translated page does not exist Repointed to /ai/mintlify-mcp

Validation

  • mint broken-links — passes (no broken links found)
  • mint validate — pre-existing failures unrelated to this change (the validator does not resolve $ref entries in docs.json for the translated nav files); same errors occur on main before this change.

Note

Low Risk
Low risk documentation-only change that updates a handful of internal links; main risk is unintended navigation to English content if localized pages are later added.

Overview
Fixes broken links in the Spanish, French, and Chinese docs by updating references to the (nonexistent) localized /{lang}/ai/mintlify-mcp page to point to the existing English page at /ai/mintlify-mcp.

Reviewed by Cursor Bugbot for commit 490d615. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented May 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🔴 Failed May 1, 2026, 6:32 PM

@mintlify-development
Copy link
Copy Markdown
Contributor

mintlify-development Bot commented May 1, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
userauth 🔴 Failed May 1, 2026, 6:38 PM

@mintlify mintlify Bot merged commit 7a1ed1e into main May 1, 2026
3 of 4 checks passed
@mintlify mintlify Bot deleted the mintlify/fix-broken-mcp-links-1777660271 branch May 1, 2026 18:32
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.

0 participants