Exactly! Swagger descriptions+GUI[1], HATEOAS[2], and JSONAPI[3] all coming together in jubilous harmony if MCP pulled its head out of the sand, but instead we get the XKCD#927[4] situation.

1: https://swagger.io/docs/specification/v3_0/adding-examples/

2: https://en.wikipedia.org/wiki/HATEOAS

3: https://jsonapi.org

4: https://xkcd.com/927/