You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Document the tools array returned by the MCP server-card discovery endpoints and the read-only/non-destructive annotations advertised for the built-in search and docs-filesystem tools.
Changes
Added a Server card endpoints subsection to the Search MCP page describing /.well-known/mcp/server-card.json and /.well-known/mcp/server-cards.json, including an example payload, a field reference table for tools[], and the read-only annotations advertised for the built-in tools.
Mirrored the new content in the Spanish, French, and Chinese localized copies; also added the missing paragraph about the additional discovery endpoints in the Chinese version.
Context
Upstream change: mintlify/mint#8111 — adds tool definitions and read-only annotations to the MCP server-card discovery responses.
Note
Low Risk
Documentation-only updates to MCP discovery pages with no runtime, auth, or data-handling changes.
Overview
Documents MCP server-card discovery on the Search MCP page: what /.well-known/mcp/server-card.json and server-cards.json return, how the tools array lets clients preload tool metadata without initialize, plus an example payload and field reference for tools[].
Also explains read-only MCP tool annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) for the built-in search and docs-filesystem tools. Same content is added to Spanish and French locales; Chinese gets that section plus a previously missing paragraph on the extra discovery URLs.
Reviewed by Cursor Bugbot for commit 68a050b. Bugbot is set up for automated code reviews on this repo. Configure here.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Document the
toolsarray returned by the MCP server-card discovery endpoints and the read-only/non-destructive annotations advertised for the built-in search and docs-filesystem tools.Changes
/.well-known/mcp/server-card.jsonand/.well-known/mcp/server-cards.json, including an example payload, a field reference table fortools[], and the read-only annotations advertised for the built-in tools.Context
Upstream change: mintlify/mint#8111 — adds tool definitions and read-only annotations to the MCP server-card discovery responses.
Note
Low Risk
Documentation-only updates to MCP discovery pages with no runtime, auth, or data-handling changes.
Overview
Documents MCP server-card discovery on the Search MCP page: what
/.well-known/mcp/server-card.jsonandserver-cards.jsonreturn, how thetoolsarray lets clients preload tool metadata withoutinitialize, plus an example payload and field reference fortools[].Also explains read-only MCP tool annotations (
readOnlyHint,destructiveHint,idempotentHint,openWorldHint) for the built-in search and docs-filesystem tools. Same content is added to Spanish and French locales; Chinese gets that section plus a previously missing paragraph on the extra discovery URLs.Reviewed by Cursor Bugbot for commit 68a050b. Bugbot is set up for automated code reviews on this repo. Configure here.