MCP Server
Football Database and Results
io.fdb4/football-database-and-results
What this MCP does
Provides historical football results, team and tournament statistics, head-to-head records, draw probabilities, and no-draw streak analysis.
Capabilities
Tools
11
tools
get_draw_model
Draw probability for one match
[PAID] Every draw reading FDB4 holds for ONE match — use it when someone asks how likely a
specific fixture is to end level, rather than which teams are overdue a draw
(`predict_draws` answers that).
Five readings come back side by side, because they are not interchangeable: the
Dixon-Coles goals model's own probability with the expected goals behind it; the
historical draw rate at this fixture's Elo rating gap; the one-parameter blend of
those two the site has published since September 2026; the five-feature logistic
model that now sits beside it with a 95% band around it; and the bookmaker's draw
price where one is recorded. Also returned: when the logistic model was last fitted,
over how many matches, and its coefficients — so an answer can explain itself.
Identify the match by `match_id`, or by `team` (id or slug) plus an optional `date`;
with no date you get that team's next fixture. `is_forecast` says whether the
logistic figure is a real forecast (a fixture) or an in-sample description of a
match the model was fitted on. Historical pattern, not a betting tip.
Costs 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'date': {'type': 'string', 'description': "With `team`, the match date as YYYY-MM-DD. Omit for that team's next fixture."}, 'team': {'type': 'string', 'description': 'A team id or slug (431, arsenal), from list_teams. Give this or `match_id`.'}, 'match_id': {'type': 'integer', 'description': 'The match id, from search_results or a fixture list. Give this or `team`.'}}}
Output schema
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'object', 'required': ['match'], 'properties': {'elo': {'type': ['object', 'null'], 'properties': {'gap': {'type': ['number', 'null']}, 'away_rating': {'type': ['number', 'null']}, 'home_rating': {'type': ['number', 'null']}, 'historical_draw_rate': {'type': ['number', 'null'], 'description': 'Draw rate of past matches with a similar rating gap, 0 to 1.'}}, 'description': 'Elo ratings and the historical draw rate at this rating gap.'}, 'fit': {'type': ['object', 'null'], 'description': 'When and on what the logistic model was trained.'}, 'blend': {'type': ['object', 'null'], 'properties': {'p_draw': {'type': ['number', 'null'], 'description': 'The blended draw probability, 0 to 1.'}}, 'description': 'Goals model and Elo gap combined.'}, 'match': {'type': 'object', 'required': ['id', 'date'], 'properties': {'id': {'type': 'integer'}, 'date': {'type': 'string'}, 'score': {'type': 'object', 'properties': {'away': {'type': ['integer', 'null']}, 'home': {'type': ['integer', 'null']}}, 'description': 'Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.'}, 'status': {'type': 'string'}, 'away_team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'home_team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'competition': {'type': ['object', 'null']}}, 'description': 'The fixture the readings are for.'}, 'market': {'type': ['object', 'null'], 'description': 'Bookmaker-implied draw probability, when odds are held.'}, 'caveats': {'type': 'array', 'items': {'type': 'string'}, 'description': 'What these numbers do not claim.'}, 'logistic': {'type': ['object', 'null'], 'properties': {'p_draw': {'type': ['number', 'null'], 'description': 'Calibrated draw probability from the logistic model, 0 to 1.'}, 'confidence_95': {'type': ['object', 'null'], 'description': 'low/high bounds of the 95% interval.'}}, 'description': 'The calibrated logistic draw model.'}, 'goals_model': {'type': ['object', 'null'], 'properties': {'p_away': {'type': ['number', 'null'], 'description': 'Away win probability, 0 to 1.'}, 'p_draw': {'type': ['number', 'null'], 'description': 'Draw probability from the goals model, 0 to 1.'}, 'p_home': {'type': ['number', 'null'], 'description': 'Home win probability, 0 to 1.'}}, 'description': 'Dixon-Coles goals model; null when it has no fit for these teams.'}}}}}
get_team
Team profile and draw statistics
[FREE] One team's profile and its all-time draw statistics.
Returns the team's name, country and type alongside the numbers this database is built
on: matches played, draws, draw percentage, the no-draw streak currently running, the
longest one ever, the average of its longest runs, its draw debt and its rank in the
draw-likelihood field. Use it to answer "how often does this team draw?" or "how long
since they last drew?".
Takes a numeric id or a slug, whichever you already hold; both come from list_teams.
Free: no key needed, and it costs a key holder nothing either.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['team'], 'properties': {'team': {'type': 'string', 'description': 'Numeric team id or slug — 431 or "arsenal". Find either with list_teams.'}}}
Output schema
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'type': {'type': ['string', 'null'], 'description': '"national_team" or "club".'}, 'stats': {'type': ['object', 'null'], 'properties': {'draws': {'type': 'integer'}, 'played': {'type': 'integer'}, 'draw_pct': {'type': ['number', 'null'], 'description': 'Share of matches drawn, in percent.'}, 'draw_debt': {'type': ['number', 'null']}, 'draw_rank': {'type': ['integer', 'null']}, 'draw_score': {'type': ['number', 'null']}, 'last_match_date': {'type': ['string', 'null']}, 'max_no_draw_streak': {'type': ['integer', 'null'], 'description': 'Longest run without a draw, ever.'}, 'current_no_draw_streak': {'type': ['integer', 'null'], 'description': 'Matches since the last draw.'}}, 'description': 'All-time draw statistics.'}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'full_name': {'type': ['string', 'null']}, 'exists_now': {'type': 'boolean'}}}}}
get_team_prediction
Draw prediction for one team
[PAID] How overdue a draw one named team is, plus the results that made it so.
Returns the team's draw-likelihood rank and score among all ranked teams, the signals
behind it (draw rate, current no-draw streak, longest ever, draw debt), and its recent
form — every match in the current no-draw run, with opponent, score and side. Use this
when the question is about a specific team ("is Brazil due a draw?"); use predict_draws
when the question is about the field.
The prediction comes back null when the team exists but is not currently ranked (no
played matches, or excluded by the `recent` filter). Historical pattern, not a betting tip.
Costs 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['team'], 'properties': {'team': {'type': 'string', 'description': 'Numeric team id or slug — 431 or "arsenal". Both come from list_teams.'}, 'recent': {'type': 'boolean', 'default': True, 'description': 'Rank within teams that have played recently, matching predict_draws. Default true.'}, 'wc2026': {'type': 'boolean', 'default': False, 'description': 'Rank within the 2026 World Cup team group. Default false.'}}}
Output schema
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'object', 'properties': {'team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}, 'type': {'type': ['string', 'null'], 'description': '"national_team" or "club".'}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'full_name': {'type': ['string', 'null'], 'description': 'Official or long name, when known.'}, 'exists_now': {'type': 'boolean', 'description': 'False for a team that no longer exists.'}}, 'description': 'A team.'}, 'prediction': {'type': ['object', 'null'], 'required': ['rank', 'score'], 'properties': {'rank': {'type': 'integer', 'description': 'Position in the ranking; 1 is the most overdue.'}, 'team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}, 'type': {'type': ['string', 'null'], 'description': '"national_team" or "club".'}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'full_name': {'type': ['string', 'null'], 'description': 'Official or long name, when known.'}, 'exists_now': {'type': 'boolean', 'description': 'False for a team that no longer exists.'}}, 'description': 'A team.'}, 'score': {'type': 'number', 'description': 'The draw-likelihood score the ranking sorts on.'}, 'signals': {'type': 'object', 'properties': {'draws': {'type': 'integer'}, 'played': {'type': 'integer'}, 'draw_pct': {'type': ['number', 'null'], 'description': 'Share of matches drawn, in percent.'}, 'draw_debt': {'type': ['number', 'null'], 'description': 'Draws expected from the draw rate minus draws that came.'}, 'max_no_draw_streak': {'type': ['integer', 'null'], 'description': 'Longest run without a draw, ever.'}, 'current_no_draw_streak': {'type': ['integer', 'null'], 'description': 'Matches since the last draw.'}}, 'description': 'The figures the score is built from.'}, 'last_match_date': {'type': ['string', 'null'], 'description': "Date of the team's most recent match."}}, 'description': "The team's place in the ranking; null when it is not ranked (too few recent matches)."}, 'recent_form': {'type': 'array', 'items': {'type': 'object', 'properties': {'won': {'type': 'boolean'}, 'date': {'type': 'string'}, 'side': {'type': 'string', 'description': '"home" or "away".'}, 'score': {'type': 'object', 'properties': {'away': {'type': ['integer', 'null']}, 'home': {'type': ['integer', 'null']}}, 'description': 'Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.'}, 'is_draw': {'type': 'boolean'}, 'match_id': {'type': 'integer'}, 'opponent': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}}}, 'description': "The team's latest results, newest first."}}}}}
get_team_streaks
No-draw runs of one team
[FREE] Every no-draw run one team has ever had, plus the one it is on now.
A no-draw run is a sequence of matches that ended in a win or a loss. This returns the
run currently in progress with each match in it — date, competition, opponent, score —
so you can say exactly when the team last drew and what has happened since, together
with every recorded run in the team's history, longest first, each with its start and
end dates.
Runs span all competitions; per-competition runs are not split out.
Free: no key needed, and it costs a key holder nothing either.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['team'], 'properties': {'team': {'type': 'string', 'description': 'Numeric team id or slug — 431 or "arsenal". Find either with list_teams.'}}}
Output schema
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'object', 'properties': {'runs': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'length'], 'properties': {'id': {'type': 'integer'}, 'end': {'type': ['string', 'null'], 'description': 'Date of the last match in the run.'}, 'start': {'type': ['string', 'null'], 'description': 'Date of the first match in the run.'}, 'length': {'type': 'integer', 'description': 'Matches in the run without a draw.'}, 'end_match_id': {'type': ['integer', 'null']}, 'start_match_id': {'type': ['integer', 'null']}}, 'description': 'A run of matches without a draw.'}, 'description': 'Every no-draw run the team has had.'}, 'team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}, 'type': {'type': ['string', 'null'], 'description': '"national_team" or "club".'}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'full_name': {'type': ['string', 'null'], 'description': 'Official or long name, when known.'}, 'exists_now': {'type': 'boolean', 'description': 'False for a team that no longer exists.'}}, 'description': 'A team.'}, 'active_streak': {'type': ['object', 'null'], 'properties': {'end': {'type': ['string', 'null']}, 'start': {'type': ['string', 'null']}, 'length': {'type': 'integer', 'description': 'Matches since the team last drew.'}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'date'], 'properties': {'id': {'type': 'integer', 'description': 'Match id, as get_draw_model takes it.'}, 'date': {'type': 'string', 'description': 'Match date, YYYY-MM-DD.'}, 'score': {'type': 'object', 'properties': {'away': {'type': ['integer', 'null']}, 'home': {'type': ['integer', 'null']}}, 'description': 'Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.'}, 'result': {'type': ['string', 'null'], 'description': 'H home win, A away win, D draw; empty until played.'}, 'status': {'type': 'string', 'description': 'PLAYED, SCHEDULED, POSTPONED and so on.'}, 'is_draw': {'type': 'boolean', 'description': 'Whether the match ended level.'}, 'away_team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'home_team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'score_120': {'type': 'object', 'properties': {'away': {'type': ['integer', 'null']}, 'home': {'type': ['integer', 'null']}}, 'description': 'Score after extra time; both values null when unavailable or no extra time was played.'}, 'competition': {'type': ['object', 'null'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'year': {'type': ['integer', 'null']}, 'edition': {'type': ['string', 'null']}, 'edition_id': {'type': ['integer', 'null'], 'description': 'The season or edition id, from list_tournaments.'}}, 'description': 'The competition and edition the match belongs to.'}, 'ninety_score_unknown': {'type': 'boolean', 'description': 'Played extra-time match known to be level at ninety minutes, with the exact ninety-minute score unavailable.'}}, 'description': 'A match.'}}}, 'description': 'The run the team is on now; null if its last match was a draw.'}}}}}
head_to_head
Head-to-head record
[PAID] The complete record between two teams, and every match they have ever played.
Answers "who wins more between these two, and how often do they draw?" — matches
played, wins each way, draws, goals each way and the draw percentage, all from team A's
perspective, followed by every meeting with its date, competition and score. Optionally
narrow to one competition type or a single edition to compare only their league games,
or only one season.
Both teams are given as numeric ids, which list_teams returns.
Costs 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['a', 'b'], 'properties': {'a': {'type': 'integer', 'description': "Team A, as a numeric id from list_teams. The record is reported from this team's point of view."}, 'b': {'type': 'integer', 'description': 'Team B, as a numeric id from list_teams. Must differ from a.'}, 'item': {'type': 'integer', 'description': 'Restrict to a single edition or season id, from list_tournaments with a `tournament` argument.'}, 'type': {'type': 'string', 'description': 'Restrict to one competition type, such as league or cup.'}}}
Output schema
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'object', 'properties': {'record': {'type': 'object', 'properties': {'draws': {'type': 'integer'}, 'played': {'type': 'integer'}, 'team_a_wins': {'type': 'integer'}, 'team_b_wins': {'type': 'integer'}, 'draw_percent': {'type': ['number', 'null']}, 'goals_team_a': {'type': 'integer'}, 'goals_team_b': {'type': 'integer'}}, 'description': 'The overall record between the two.'}, 'team_a': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}, 'type': {'type': ['string', 'null'], 'description': '"national_team" or "club".'}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'full_name': {'type': ['string', 'null'], 'description': 'Official or long name, when known.'}, 'exists_now': {'type': 'boolean', 'description': 'False for a team that no longer exists.'}}, 'description': 'A team.'}, 'team_b': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}, 'type': {'type': ['string', 'null'], 'description': '"national_team" or "club".'}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'full_name': {'type': ['string', 'null'], 'description': 'Official or long name, when known.'}, 'exists_now': {'type': 'boolean', 'description': 'False for a team that no longer exists.'}}, 'description': 'A team.'}, 'meetings': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'date'], 'properties': {'id': {'type': 'integer', 'description': 'Match id, as get_draw_model takes it.'}, 'date': {'type': 'string', 'description': 'Match date, YYYY-MM-DD.'}, 'score': {'type': 'object', 'properties': {'away': {'type': ['integer', 'null']}, 'home': {'type': ['integer', 'null']}}, 'description': 'Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.'}, 'result': {'type': ['string', 'null'], 'description': 'H home win, A away win, D draw; empty until played.'}, 'status': {'type': 'string', 'description': 'PLAYED, SCHEDULED, POSTPONED and so on.'}, 'is_draw': {'type': 'boolean', 'description': 'Whether the match ended level.'}, 'away_team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'home_team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'score_120': {'type': 'object', 'properties': {'away': {'type': ['integer', 'null']}, 'home': {'type': ['integer', 'null']}}, 'description': 'Score after extra time; both values null when unavailable or no extra time was played.'}, 'competition': {'type': ['object', 'null'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'year': {'type': ['integer', 'null']}, 'edition': {'type': ['string', 'null']}, 'edition_id': {'type': ['integer', 'null'], 'description': 'The season or edition id, from list_tournaments.'}}, 'description': 'The competition and edition the match belongs to.'}, 'ninety_score_unknown': {'type': 'boolean', 'description': 'Played extra-time match known to be level at ninety minutes, with the exact ninety-minute score unavailable.'}}, 'description': 'A match.'}, 'description': 'Every match between them.'}}}}}
list_countries
Countries
[FREE] Every country in the database, with its FIFA code and id.
Use it to turn a country name into the id and FIFA code the rest of the data is keyed
by, or to check which countries are covered at all. Search with `q`, which matches a
name prefix or an exact FIFA code ("ENG"). Countries that no longer exist are included
and flagged, because the match archive still holds their games.
Free: no key needed, and it costs a key holder nothing either.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Country name prefix, or an exact FIFA code such as ENG or BRA.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 500, 'minimum': 1, 'description': 'How many countries to return. Default 25; the total is always reported.'}}}
Output schema
{'type': 'object', 'required': ['data', 'total', 'returned'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'integer'}, 'iso2': {'type': ['string', 'null']}, 'name': {'type': 'string'}, 'fifa_code': {'type': ['string', 'null']}, 'exists_now': {'type': 'boolean'}, 'is_international': {'type': 'boolean'}}, 'description': 'A country.'}, 'description': 'Countries matching the search.'}, 'hint': {'type': 'string', 'description': 'Present only when rows were left out: how to narrow the call.'}, 'total': {'type': 'integer', 'description': 'How many rows matched before the limit.'}, 'returned': {'type': 'integer', 'description': 'How many rows are in data.'}}}
list_teams
Find a team
[FREE] Find a team and its id — the lookup every other team tool depends on.
Search by name prefix with `q` ("arse" finds Arsenal), or browse by first letter, or
list one kind of team. Each row carries the numeric id and the slug that get_team,
get_team_streaks, get_team_prediction, head_to_head and search_results take.
The database holds thousands of teams, so an unfiltered call returns the first 25 with
the full total beside them. Always pass `q` when you know the name.
Free: no key needed, and it costs a key holder nothing either.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Name prefix, matched against both the short and the full name. The fastest way to find one team.'}, 'type': {'enum': ['national_team', 'club'], 'type': 'string', 'description': 'Restrict to national teams or to clubs.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 500, 'minimum': 1, 'description': 'How many teams to return. Default 25; the total number of matches is always reported.'}, 'letter': {'type': 'string', 'maxLength': 1, 'description': 'First letter A-Z to browse by, or "#" for names starting with a non-letter.'}}}
Output schema
{'type': 'object', 'required': ['data', 'total', 'returned'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}, 'type': {'type': ['string', 'null'], 'description': '"national_team" or "club".'}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'full_name': {'type': ['string', 'null'], 'description': 'Official or long name, when known.'}, 'exists_now': {'type': 'boolean', 'description': 'False for a team that no longer exists.'}}, 'description': 'A team.'}, 'description': 'Teams matching the search.'}, 'hint': {'type': 'string', 'description': 'Present only when rows were left out: how to narrow the call.'}, 'total': {'type': 'integer', 'description': 'How many rows matched before the limit.'}, 'returned': {'type': 'integer', 'description': 'How many rows are in data.'}}}
list_tournaments
Competitions and seasons
[FREE] Every competition covered — leagues, domestic cups, continental cups, World Cups — with
how many matches and how many draws each one holds.
Two uses. Without `tournament` it answers "what is in this database, and how draw-heavy
is each competition?", returning each competition's id, slug, country, match count, draw
count and draw percentage. With `tournament` (an id or slug) it returns that one
competition in full: the years it covers, every edition newest first with its champion
where one was decided, and the all-time winners ranking with title counts and years.
The competition ids here are what search_results and head_to_head filter by.
Free: no key needed, and it costs a key holder nothing either.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 500, 'minimum': 1, 'description': 'How many competitions to list. Default 25; the total is always reported.'}, 'tournament': {'type': 'string', 'description': 'One competition, by numeric id or slug (53 or "norway-cup"). Returns its editions, champions and all-time winners instead of the list.'}}}
Output schema
{'type': 'object', 'required': ['data', 'total', 'returned'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': 'string'}, 'slug': {'type': ['string', 'null']}, 'type': {'type': ['string', 'null']}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'draws_count': {'type': ['integer', 'null']}, 'draw_percent': {'type': ['number', 'null']}, 'matches_count': {'type': ['integer', 'null']}}, 'description': 'A competition, or with `tournament` given, one of its editions.'}, 'description': "Competitions, or one competition's editions."}, 'hint': {'type': 'string', 'description': 'Present only when rows were left out: how to narrow the call.'}, 'total': {'type': 'integer', 'description': 'How many rows matched before the limit.'}, 'returned': {'type': 'integer', 'description': 'How many rows are in data.'}}}
predict_draws
Teams most overdue a draw
[PAID] Rank teams by how overdue a draw is — the question this database exists to answer.
Every team has a historical draw rate and a run of matches since its last draw. When
the run is long relative to how often that team normally draws, the team is carrying
"draw debt", and this tool ranks the whole field by it, most overdue first. Ask it
"which national teams are most due a draw?" or "who is overdue a draw in the World
Cup 2026 field?" and it answers directly; nothing else here needs to be queried first.
Each entry returns the rank, the score, and the signals behind it: matches played,
draws, draw percentage, the current no-draw streak, the longest ever, and the debt
figure. Filters subset which teams are listed — a team's score and rank are global and
never change with them. Historical pattern, not a betting tip.
Costs 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'type': {'enum': ['national_team', 'club'], 'type': 'string', 'description': 'Restrict the ranking to national teams or to clubs. Omit to rank both together.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 500, 'minimum': 1, 'description': 'How many ranked teams to return. Default 25, max 500. One call, one point, whatever the limit.'}, 'recent': {'type': 'boolean', 'default': True, 'description': 'Only teams with a recent match, so the answer is about teams currently playing. Default true.'}, 'wc2026': {'type': 'boolean', 'default': False, 'description': 'Restrict to the 2026 World Cup team group. Default false.'}}}
Output schema
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['rank', 'score'], 'properties': {'rank': {'type': 'integer', 'description': 'Position in the ranking; 1 is the most overdue.'}, 'team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}, 'type': {'type': ['string', 'null'], 'description': '"national_team" or "club".'}, 'country': {'type': ['object', 'null'], 'required': ['id'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'fifa_code': {'type': ['string', 'null'], 'description': 'Three-letter FIFA code.'}}, 'description': 'The country a team or competition belongs to.'}, 'full_name': {'type': ['string', 'null'], 'description': 'Official or long name, when known.'}, 'exists_now': {'type': 'boolean', 'description': 'False for a team that no longer exists.'}}, 'description': 'A team.'}, 'score': {'type': 'number', 'description': 'The draw-likelihood score the ranking sorts on.'}, 'signals': {'type': 'object', 'properties': {'draws': {'type': 'integer'}, 'played': {'type': 'integer'}, 'draw_pct': {'type': ['number', 'null'], 'description': 'Share of matches drawn, in percent.'}, 'draw_debt': {'type': ['number', 'null'], 'description': 'Draws expected from the draw rate minus draws that came.'}, 'max_no_draw_streak': {'type': ['integer', 'null'], 'description': 'Longest run without a draw, ever.'}, 'current_no_draw_streak': {'type': ['integer', 'null'], 'description': 'Matches since the last draw.'}}, 'description': 'The figures the score is built from.'}, 'last_match_date': {'type': ['string', 'null'], 'description': "Date of the team's most recent match."}}, 'description': 'A ranked team.'}, 'description': 'Teams ranked by how overdue a draw is, most overdue first.'}}}
search_results
Match results archive
[FREE for the last 7 days · PAID for the archive] Search the match archive: finished matches, newest first, with scores.
This is the raw history behind every other tool — decades of results across national
team football, domestic leagues and cups. Filter by team, competition, single season,
outcome (home win, away win or draw) and date range, in any combination: "Arsenal's
draws since 2020", "every match in the 2025/26 Premier League", "all draws in the World
Cup". Each match returns its date, competition and edition, both teams, the score and
whether it was a draw.
Results are paginated, 50 per page by default; `page` walks through them and
`meta.total` tells you how many matches matched before you start.
Free, no key needed, for recent results: the first page of 50, and any `from` date
inside the last 7 days. Reaching further back — an older `from`, a bigger `limit`, or
page 2 onward — is the archive and costs 1 point per call (1 point = 1 cent), one point
per page.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'Latest match date, inclusive, as YYYY-MM-DD.'}, 'from': {'type': 'string', 'description': 'Earliest match date, inclusive, as YYYY-MM-DD. Inside the last 7 days the call is free and needs no key; earlier than that it costs 1 point.'}, 'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Page number, from 1. Page 1 can be free; every page after it is a separate call and costs its own point.'}, 'type': {'enum': ['national_team', 'club'], 'type': 'string', 'description': 'Restrict to national-team or club football.'}, 'limit': {'enum': [50, 100, 250, 500], 'type': 'integer', 'default': 50, 'description': 'Page size: 50, 100, 250 or 500. Default 50, which is also the largest free page. Anything else is treated as 100.'}, 'outcome': {'enum': ['H', 'A', 'D'], 'type': 'string', 'description': 'H for a home win, A for an away win, D for a draw.'}, 'team_id': {'type': 'integer', 'description': 'Matches involving this team, home or away. Numeric id from list_teams.'}, 'competition_id': {'type': 'integer', 'description': 'Restrict to one competition. Id from list_tournaments.'}, 'competition_item_id': {'type': 'integer', 'description': 'Restrict to a single edition or season. Edition ids come from list_tournaments with a `tournament` argument.'}}}
Output schema
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'date'], 'properties': {'id': {'type': 'integer', 'description': 'Match id, as get_draw_model takes it.'}, 'date': {'type': 'string', 'description': 'Match date, YYYY-MM-DD.'}, 'score': {'type': 'object', 'properties': {'away': {'type': ['integer', 'null']}, 'home': {'type': ['integer', 'null']}}, 'description': 'Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.'}, 'result': {'type': ['string', 'null'], 'description': 'H home win, A away win, D draw; empty until played.'}, 'status': {'type': 'string', 'description': 'PLAYED, SCHEDULED, POSTPONED and so on.'}, 'is_draw': {'type': 'boolean', 'description': 'Whether the match ended level.'}, 'away_team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'home_team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'score_120': {'type': 'object', 'properties': {'away': {'type': ['integer', 'null']}, 'home': {'type': ['integer', 'null']}}, 'description': 'Score after extra time; both values null when unavailable or no extra time was played.'}, 'competition': {'type': ['object', 'null'], 'properties': {'id': {'type': 'integer'}, 'name': {'type': ['string', 'null']}, 'year': {'type': ['integer', 'null']}, 'edition': {'type': ['string', 'null']}, 'edition_id': {'type': ['integer', 'null'], 'description': 'The season or edition id, from list_tournaments.'}}, 'description': 'The competition and edition the match belongs to.'}, 'ninety_score_unknown': {'type': 'boolean', 'description': 'Played extra-time match known to be level at ninety minutes, with the exact ninety-minute score unavailable.'}}, 'description': 'A match.'}, 'description': 'Matches, newest first.'}, 'meta': {'type': 'object', 'properties': {'total': {'type': 'integer', 'description': 'Rows across every page.'}, 'per_page': {'type': 'integer'}, 'last_page': {'type': 'integer'}, 'current_page': {'type': 'integer'}}, 'description': 'Pagination: which page this is and how many rows exist.'}, 'links': {'type': 'object', 'description': 'first/last/prev/next page URLs on the REST API.'}}}
top_streaks
Longest no-draw runs of all time
[PAID] The all-time leaderboard of no-draw runs — the longest any team has gone without drawing.
Answers "what is the longest run of matches without a draw on record?" and "who else has
done it?". Each entry is one run: its length, the dates it started and ended, and the
team. A team can appear more than once, since a great side may have several long runs.
Filter to one team, to national teams or clubs, or to runs above a minimum length.
Paginated, 25 per page by default; `page` walks the leaderboard and each page costs its
own point.
Costs 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.
Read only
Idempotent
Input schema
{'type': 'object', 'properties': {'min': {'type': 'integer', 'default': 5, 'minimum': 1, 'description': 'Minimum run length to list. Default 5.'}, 'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': 'Page number, from 1. Each page is a separate call and costs its own point.'}, 'type': {'enum': ['national_team', 'club'], 'type': 'string', 'description': 'Restrict to national teams or to clubs.'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 500, 'minimum': 1, 'description': 'Page size. Default 25, max 500.'}, 'team_id': {'type': 'integer', 'description': 'Restrict to one team. Numeric id from list_teams.'}}}
Output schema
{'type': 'object', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'length'], 'properties': {'id': {'type': 'integer'}, 'end': {'type': ['string', 'null']}, 'team': {'type': 'object', 'required': ['id', 'slug', 'name'], 'properties': {'id': {'type': 'integer', 'description': 'Team id — the argument every team tool takes.'}, 'name': {'type': 'string', 'description': 'Short display name.'}, 'slug': {'type': 'string', 'description': 'URL slug; accepted anywhere an id is.'}}, 'description': 'A team reference.'}, 'start': {'type': ['string', 'null']}, 'length': {'type': 'integer', 'description': 'Matches in the run without a draw.'}, 'end_match_id': {'type': ['integer', 'null']}, 'start_match_id': {'type': ['integer', 'null']}}, 'description': 'A run of matches without a draw, and whose it was.'}, 'description': 'The longest no-draw runs, longest first.'}, 'meta': {'type': 'object', 'properties': {'total': {'type': 'integer', 'description': 'Rows across every page.'}, 'per_page': {'type': 'integer'}, 'last_page': {'type': 'integer'}, 'current_page': {'type': 'integer'}}, 'description': 'Pagination: which page this is and how many rows exist.'}, 'links': {'type': 'object', 'description': 'first/last/prev/next page URLs on the REST API.'}}}
History
Recent tool changes
Changed
head_to_head
Oct. 1, 2026, 2:42 a.m.
Changed
search_results
Oct. 1, 2026, 2:42 a.m.
Changed
get_team_streaks
Oct. 1, 2026, 2:42 a.m.
Changed
get_draw_model
Oct. 1, 2026, 2:42 a.m.
Changed
get_team_prediction
Oct. 1, 2026, 2:42 a.m.
Added
head_to_head
Sept. 25, 2026, 2:40 a.m.
Added
search_results
Sept. 25, 2026, 2:40 a.m.
Added
list_countries
Sept. 25, 2026, 2:40 a.m.
Added
list_tournaments
Sept. 25, 2026, 2:40 a.m.
Added
get_team
Sept. 25, 2026, 2:40 a.m.
Added
list_teams
Sept. 25, 2026, 2:40 a.m.
Added
get_team_streaks
Sept. 25, 2026, 2:40 a.m.
Added
top_streaks
Sept. 25, 2026, 2:40 a.m.
Added
get_draw_model
Sept. 25, 2026, 2:40 a.m.
Added
get_team_prediction
Sept. 25, 2026, 2:40 a.m.
Added
predict_draws
Sept. 25, 2026, 2:40 a.m.
Discover
Similar MCP servers
LiveDataLink
io.github.blackboxfoundry/livedatalink
Exposes public-data tools covering economics, labor, banking, transport, books, legal opinions, carriers, environmental data, and…
AlpineDataWorks Intelligence Server
com.alpinedataworks/adw-intelligence-server
Provides economic, market, supply-chain, real-estate, energy, consumer, labor, and other scored intelligence indices with histori…
SharksAPI.AI
ai.sharksapi/marketing
Provides marketing analytics and actions across GA4, Search Console, Google Ads, social channels, SEO, WordPress, and marketing p…
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…