How to design effective tools for AI agents: guidance from OpenAI, Anthropic, Google and MCP

This post consolidates what OpenAI, Anthropic, Google and the MCP spec recommend for designing tools for AI agents, and covers what their guides leave out. It argues tools should be built around workflows rather than API endpoints, that names, descriptions and schemas act as a contract the model reads literally, and that responses and errors are part of the prompt.