Tips // Claude in practice

Tips for working better with Claude

One short tip at a time, with an example you can copy. Move through them at random or search for what you need.

MCPAdvancedMCP

If Claude ignores your MCP tool, strengthen its description

With a weak description the agent prefers Grep or Read; tell it what unique data your tool provides and when it is the better choice.

Claude picks tools by their description. If two look alike, it tends to use the built-in ones. Write what your tool returns that the built-ins cannot, the input formats and when to use it versus the alternatives. Also rename tools with overlapping functions (analyze_content and analyze_document step on each other).

Example
Before: "Looks up customer information"
After: "Looks up a customer by email or customer_id and returns profile, order history and account status. Use it BEFORE lookup_order to verify identity. To search text in repo files use Grep, not this tool."
#descriptions#tool-selection#mcp