APIIntermediateClaude API
Every tool needs a sentence about when NOT to use it
If two tools both say 'look up information', Claude cannot tell them apart; an exclusion condition usually fixes the wrong selection.
Claude picks the tool by reading the description field, not your input schema. Write two sentences: when to use it and when not to. And do it on both tools that overlap, not just one. If they still cannot be separated, they may be a single tool with a type parameter.
Example
search_docs: "Use it when the question requires searching content that is not in this conversation. Do not use it if the answer is already in the session context." get_context_summary: "Use it only if the answer is already in the current session. Do not use it to look for new information."