Use it now Notable
No documentation found
MCP tools can now declare hints like search_hint, always_load, and a maximum result size, alongside existing annotations
What
Tools provided through MCP (Model Context Protocol, the standard Claude Code uses to talk to external tool servers) can now include a hints object when they declare themselves, with the fields:
search_hintalways_loadmax_result_size_charsrequires_user_interaction
These sit alongside the existing annotations like title, readOnlyHint, destructiveHint and openWorldHint. Tool names must still contain a double underscore (__) and pass a name-validity check.
Why
These hints give an MCP server more ways to tell Claude Code how a tool should be surfaced and used, such as whether it should always be loaded or how large a result it's allowed to return.
Names in the bundlesearch_hintalways_loadmax_result_size_charsrequires_user_interaction
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubt
What Claude Code does with each hint once declared isn't shown, only that the schema now accepts them.