Developer Information
For better or worse, Fantasy Bumps provides a read-only JSON API and MCP server for all public data.
But before we go any further, are you sure that you don't have anything better to do with your time?
Like your degree?
Or training?
... Really?
Ok, well in that case...
JSON API
A read-only JSON API is available on several of the standard pages, including events, markets, leaderboards, and team crews.
It can be accessed by setting the Accept: application/json header or by appending ?format=json to the URL.
Because the API is read-only and only supplying data already fully public, no authentication is needed.
The full list of supported pages is:
/
/events/ |
Returns a list with basic information for all events, recent & historical. |
/eights2026/ |
Returns the full details of a specific event, along with crew popularity rankings. |
/eights2026/men/
/eights2026/women/ |
Returns the market data for the specified event and respective gender, including start orders, crew prices, and projected payouts. |
/eights2026/leaderboard/
/eights2026/leaderboard/men/
/eights2026/leaderboard/women/ |
Returns the overall, men's, and women's leaderboards for the specified event.
Additionally accepts the following filters as query parameters (all default to true):
invalid-entries – Include/exclude invalid entries
allow-subs – Include/exclude crews with substitutions
returners – Include/exclude returning players
|
/eights2026/teams/MyTeam/ |
Returns the full details of a team's crew lists for a specified event, including all results & payouts. |
There is no published schema for any of these pages, because that sounds like far too much effort.
However, you go to Oxford, you're smart, you can probably figure it out, and for my part I will endeavour to keep it consistent.
MCP
All of the same data available via the API is also available in your chatbot of choice via an MCP (Model Context Protocol) server.
This can be accessed by pointing your MCP-aware client at: https://fantasybumps.org.uk/mcp/
The tools available are:
get_server_instructions – The starting point for using and understanding the tools available via the MCP server
list_events – Retrieves a list of all available events
get_event_details – Retrieves details for a specific event
get_event_market – Retrieves market data for a specific event, for men or women as appropriate
get_event_leaderboard – Retrieves leaderboard data for a specific event, accepting the same sorting & filtering as the API view
get_event_team_crews – Retrieves team crew data for a specific event
Final Thoughts
These connections are provided as much for my own enjoyment in creating them as for any practical purpose.
Fantasy Bumps is ultimately a game for people, not for computers, and as such it was a conscious choice not to add API support for the actions
– buy, sell, switch – both now and in future, so that crew selection always requires the appropriate human touch.
Also, if you find yourself trying to script up the perfect crew selection using these tools, please go outside and touch some grass water 🚣💙.