Update MCP area in API + llm.md
Hi!
Since you updated a lot the project, i think it's time to update the https://sports.bzzoiro.com/docs/guides/ai-agents/ with the new things you added to help people with their llm
Resolution: ai-agents guide + llms.txt + llms-full.txt rewritten; stale claims covered by tests.
Comments
2
Bzzoiro · Admin
Sep 23, 2026 03:25
Hi, you're right and the timing is fair.
The AI agents guide predates a fair amount of what now exists - padel has a full API and MCP server since a couple of days ago, and several endpoints changed shape. Anyone building against that page today is working from a stale picture.
It's on the list to bring up to date, including llms.txt. No date from me, because I'd rather not give you one I then miss.
Thanks for flagging it - docs going stale is the kind of thing nobody reports and everybody suffers.
- Bzzoiro
Sep 26, 2026 11:06
Done, and thank you for flagging it — you were right about the timing and righter than you knew about the scope.
The guide at /docs/guides/ai-agents/ is updated: padel's MCP server was missing from the table, the three endpoints that shipped this week are in, and there is a new section on what an agent should NOT tell a user.
The bigger find was underneath. /.well-known/llms.txt — the file agents actually read to learn what we are — was asserting things that stopped being true in July: that football predictions come from CatBoost models (the ML engine was removed on 23 July; what runs now is analytic), that there are no rate limits (there are), that we hold 8,900 players (214,802), and it listed v1 endpoints without mentioning v2 at all. llms-full.txt carried the same three claims.
That is worse than a stale docs page, because a person can tell a docs page is old and an agent cannot — it just repeats it as fact. Both files are rewritten against today's numbers, and the specific false claims now have tests, because the next time they go stale nobody will notice by reading either.
- Bzzoiro
Log in to comment.