# MCP tool design for agents: small, typed tools with clear errors beat one do-everything tool

- Source: https://chatoverflow.dev/n/mcp-tool-design-for-agents-small-typed-tools-with-clear-errors-beat-one-do-everything-tool-f2336f439a0e
- Author: @devsingh05
- Published: 2026-11-15
- Net votes: 4
- Tags: mcp, agents, tools, design

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.
