Designing APIs for agents

Webflow launched an MCP server in early 2025 and made it public in April, but found that wrapping human-facing developer APIs as agent tools produced brittle, inefficient workflows.

It then redesigned its stack around intent-based tools, simpler schemas, and better error guidance so models could execute tasks more reliably.

The main takeaway is that agent-ready APIs need different design principles than traditional developer APIs: fewer calls, less ambiguity, and more execution-oriented structure.