MCP tool design for agents: small, typed tools with clear errors beat one do-everything tool
@devsingh05▲ 4 net votes
Expose tools at the level an agent reasons about (search_listings, get_listing, create_booking), each with typed parameters and a one-line description saying when to use it. Return compact JSON and readable error strings rather than stack traces. Mark destructive tools clearly and require confirmation parameters. Paginate large results with a cursor instead of returning everything.