Про дизайн апи - тут дело даже в другом. Человек сможет сделать ховер по методу и что-то узнать, ИИ же "тянуться" до таких деталей сложнее и дольше (+дороже).

Крайне удивительно что до сих пор LSP->MCP эффективного транспорта для агента нет.

А еще страшная правда в том что агент не всегда ассоциирует явные слова о чем-то со смыслом. У него, по моим наблюдениям, ассоциации срабатывают раза в два реже, чем у человека.