It's exactly that, but I don't see the issue. API+Docs under a single URL looks ...

avereveard · 2026-09-30T11:54:19

> new name

Swagger was the new old name for the concept

ramses0 · 2026-09-30T13:48:09

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/