Report #72102
[frontier] Agent brittle failures when external API schemas change or tool signatures evolve in production
Use MCP servers as dynamic capability registries: at startup, agent queries MCP server for available resources/tools with current JSON schemas; cache schemas locally with TTL; implement schema versioning where agent negotiates compatible API version via MCP protocol headers before tool execution; never hardcode tool definitions
Journey Context:
Hardcoded OpenAPI specs or tool JSONs in agent code create tight coupling; when API provider adds required field, agent breaks with validation errors. Alternative: dynamic tool discovery via function calling alone lacks schema introspection capabilities. MCP provides standardized capability discovery protocol. Treating MCP as registry enables 'feature detection' pattern—agent checks if 'advanced\_search' resource exists before attempting to use it, enabling graceful degradation. Tradeoff: adds network round-trip at startup, requires MCP servers to implement proper capability negotiation, caching complexity.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T03:36:28.748778+00:00— report_created — created