Server definition
- Hash
- sha256:566b0b46f5fe825aba0e9ffb2e4f3ccdca8fdbb69d0021b626967ad2fad014ef
- What it is
- What a remote MCP server returned when asked what it offers: 11 tools
The blob, as servednamed by its sha256
{
"instructions": "11 read-only tools: 6 free with no key, 5 paid (1 point = 1 cent).\n\nFDB4 is a football (soccer) results database covering national-team football,\ndomestic leagues and domestic and continental cups, from the 19th century to\nyesterday. It holds matches, teams, competitions and every edition of them, and\nderives statistics the raw results do not contain.\n\nIts speciality is draws. For every team it tracks how often that team draws, how\nlong its current run without a draw is, how long its longest runs have been, and\nfrom those a ranking of which teams are most \"overdue\" a draw. `predict_draws` is\nthe tool to reach for when someone asks which teams are due one; `top_streaks`\nanswers who has gone longest without one; `get_draw_model` answers how likely ONE\nnamed fixture is to end level, and returns every reading the site holds for it\nrather than a single number. This is descriptive statistics over historical\nresults: a pattern, not a prediction. It is not betting advice, and\nhttps://fdb4.io/not-betting-advice says so at length.\n\nHOW TO USE IT\n\nIds come first. Most tools take a team id or slug; `list_teams` (with `q`) is how\nyou turn a name into one, and `list_tournaments` does the same for competitions\nand their seasons. `search_results` is the raw match archive behind everything\nelse, and `head_to_head` compares two teams directly.\n\nWHAT IT COSTS\n\nSix of the eleven tools need no key at all. Call them straight away, with no\ncredentials and no sign-up:\n\n list_countries, list_tournaments, list_teams, get_team, get_team_streaks,\n and search_results for the last 7 days (first page of 50).\n\nThat covers every reference lookup and the flagship number — how long a team has\ngone without a draw. Keyless callers are limited to 60 calls an hour per address.\n\nThe other five are paid, because their answers are models and rankings rather\nthan stored facts: predict_draws, get_team_prediction, get_draw_model,\ntop_streaks, head_to_head — and search_results reaching further back than a week,\npast the first page, or with a bigger page size.\n\nA paid tool costs 1 point from the account behind the key. 1 point = 1 cent. A\npaginated call costs 1 point per page, so ask for what you need in one call\nrather than walking pages. Connecting, listing tools and reading these\ninstructions are free whether or not you hold a key.\n\nWhich tools are free, and why the line falls where it does, is written out for a\nperson at https://fdb4.io/mcp; the REST API those tools wrap is at\nhttps://fdb4.io/api and has no free tier at all.\n\nA key is free to create — sign in with Google at https://fdb4.io/login, make one\non the account page, send it as `Authorization: Bearer <key>`. New accounts start\nwith 10 points and active ones get 2 more a month. Holding a key never makes a\nfree tool cost anything.\n\nList tools return the first 25 rows by default with the true total beside them —\nif `total` exceeds `returned`, narrow the filters rather than paging blindly.\n\nWHEN A PAID TOOL IS CALLED WITHOUT A KEY\n\nThe tool returns an error result whose text carries this JSON:\n\n {\"error\":{\"code\":\"key_required\",\"tool\":\"predict_draws\",\"free_tools\":[...],\n \"sign_up_url\":\"https://fdb4.io/login?next=%2Faccount\",\n \"documentation\":\"https://fdb4.io/mcp\",\"welcome_points\":10,\n \"monthly_grant\":2,\"price\":\"1 call = 1 point = 1 cent\"}}\n\nNothing was charged. Either fall back to one of the `free_tools`, or tell the\nperson they can create a free key at `sign_up_url` and what it costs; do not\nretry the same call unauthenticated.\n\nWHEN THE BALANCE RUNS OUT\n\nThe tool returns an error result (not a transport failure) whose text carries this\nJSON:\n\n {\"error\":{\"code\":\"insufficient_balance\",\"balance\":0,\n \"top_up_url\":\"https://fdb4.io/account/balance\",\"monthly_grant\":2}}\n\nNothing was charged and no data was returned. Tell the human their FDB4 balance\nis empty and give them the top_up_url; do not retry, the next call will fail the\nsame way. Accounts that sign in receive free points monthly.\n\nA 401 means a key WAS sent and is invalid, revoked or expired — see\nhttps://fdb4.io/mcp. Sending no key at all is not a 401 here; it simply puts you\non the free tier. A 429 means a rate limit was hit — the key's per-minute cap, or\n60 calls an hour if you have no key; wait and retry. Neither costs a point.",
"tools": [
{
"description": "[PAID] Every draw reading FDB4 holds for ONE match — use it when someone asks how likely a\nspecific fixture is to end level, rather than which teams are overdue a draw\n(`predict_draws` answers that).\n\nFive readings come back side by side, because they are not interchangeable: the\nDixon-Coles goals model's own probability with the expected goals behind it; the\nhistorical draw rate at this fixture's Elo rating gap; the one-parameter blend of\nthose two the site has published since September 2026; the five-feature logistic\nmodel that now sits beside it with a 95% band around it; and the bookmaker's draw\nprice where one is recorded. Also returned: when the logistic model was last fitted,\nover how many matches, and its coefficients — so an answer can explain itself.\n\nIdentify the match by `match_id`, or by `team` (id or slug) plus an optional `date`;\nwith no date you get that team's next fixture. `is_forecast` says whether the\nlogistic figure is a real forecast (a fixture) or an in-sample description of a\nmatch the model was fitted on. Historical pattern, not a betting tip.\n\nCosts 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.",
"inputSchema": {
"properties": {
"date": {
"description": "With `team`, the match date as YYYY-MM-DD. Omit for that team's next fixture.",
"type": "string"
},
"match_id": {
"description": "The match id, from search_results or a fixture list. Give this or `team`.",
"type": "integer"
},
"team": {
"description": "A team id or slug (431, arsenal), from list_teams. Give this or `match_id`.",
"type": "string"
}
},
"type": "object"
},
"name": "get_draw_model",
"outputSchema": {
"properties": {
"data": {
"properties": {
"blend": {
"description": "Goals model and Elo gap combined.",
"properties": {
"p_draw": {
"description": "The blended draw probability, 0 to 1.",
"type": [
"number",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"caveats": {
"description": "What these numbers do not claim.",
"items": {
"type": "string"
},
"type": "array"
},
"elo": {
"description": "Elo ratings and the historical draw rate at this rating gap.",
"properties": {
"away_rating": {
"type": [
"number",
"null"
]
},
"gap": {
"type": [
"number",
"null"
]
},
"historical_draw_rate": {
"description": "Draw rate of past matches with a similar rating gap, 0 to 1.",
"type": [
"number",
"null"
]
},
"home_rating": {
"type": [
"number",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"fit": {
"description": "When and on what the logistic model was trained.",
"type": [
"object",
"null"
]
},
"goals_model": {
"description": "Dixon-Coles goals model; null when it has no fit for these teams.",
"properties": {
"p_away": {
"description": "Away win probability, 0 to 1.",
"type": [
"number",
"null"
]
},
"p_draw": {
"description": "Draw probability from the goals model, 0 to 1.",
"type": [
"number",
"null"
]
},
"p_home": {
"description": "Home win probability, 0 to 1.",
"type": [
"number",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"logistic": {
"description": "The calibrated logistic draw model.",
"properties": {
"confidence_95": {
"description": "low/high bounds of the 95% interval.",
"type": [
"object",
"null"
]
},
"p_draw": {
"description": "Calibrated draw probability from the logistic model, 0 to 1.",
"type": [
"number",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"market": {
"description": "Bookmaker-implied draw probability, when odds are held.",
"type": [
"object",
"null"
]
},
"match": {
"description": "The fixture the readings are for.",
"properties": {
"away_team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"competition": {
"type": [
"object",
"null"
]
},
"date": {
"type": "string"
},
"home_team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"id": {
"type": "integer"
},
"score": {
"description": "Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.",
"properties": {
"away": {
"type": [
"integer",
"null"
]
},
"home": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"status": {
"type": "string"
}
},
"required": [
"id",
"date"
],
"type": "object"
}
},
"required": [
"match"
],
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "[FREE] One team's profile and its all-time draw statistics.\n\nReturns the team's name, country and type alongside the numbers this database is built\non: matches played, draws, draw percentage, the no-draw streak currently running, the\nlongest one ever, the average of its longest runs, its draw debt and its rank in the\ndraw-likelihood field. Use it to answer \"how often does this team draw?\" or \"how long\nsince they last drew?\".\n\nTakes a numeric id or a slug, whichever you already hold; both come from list_teams.\n\nFree: no key needed, and it costs a key holder nothing either.",
"inputSchema": {
"properties": {
"team": {
"description": "Numeric team id or slug — 431 or \"arsenal\". Find either with list_teams.",
"type": "string"
}
},
"required": [
"team"
],
"type": "object"
},
"name": "get_team",
"outputSchema": {
"properties": {
"data": {
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"exists_now": {
"type": "boolean"
},
"full_name": {
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"stats": {
"description": "All-time draw statistics.",
"properties": {
"current_no_draw_streak": {
"description": "Matches since the last draw.",
"type": [
"integer",
"null"
]
},
"draw_debt": {
"type": [
"number",
"null"
]
},
"draw_pct": {
"description": "Share of matches drawn, in percent.",
"type": [
"number",
"null"
]
},
"draw_rank": {
"type": [
"integer",
"null"
]
},
"draw_score": {
"type": [
"number",
"null"
]
},
"draws": {
"type": "integer"
},
"last_match_date": {
"type": [
"string",
"null"
]
},
"max_no_draw_streak": {
"description": "Longest run without a draw, ever.",
"type": [
"integer",
"null"
]
},
"played": {
"type": "integer"
}
},
"type": [
"object",
"null"
]
},
"type": {
"description": "\"national_team\" or \"club\".",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "[PAID] How overdue a draw one named team is, plus the results that made it so.\n\nReturns the team's draw-likelihood rank and score among all ranked teams, the signals\nbehind it (draw rate, current no-draw streak, longest ever, draw debt), and its recent\nform — every match in the current no-draw run, with opponent, score and side. Use this\nwhen the question is about a specific team (\"is Brazil due a draw?\"); use predict_draws\nwhen the question is about the field.\n\nThe prediction comes back null when the team exists but is not currently ranked (no\nplayed matches, or excluded by the `recent` filter). Historical pattern, not a betting tip.\n\nCosts 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.",
"inputSchema": {
"properties": {
"recent": {
"default": true,
"description": "Rank within teams that have played recently, matching predict_draws. Default true.",
"type": "boolean"
},
"team": {
"description": "Numeric team id or slug — 431 or \"arsenal\". Both come from list_teams.",
"type": "string"
},
"wc2026": {
"default": false,
"description": "Rank within the 2026 World Cup team group. Default false.",
"type": "boolean"
}
},
"required": [
"team"
],
"type": "object"
},
"name": "get_team_prediction",
"outputSchema": {
"properties": {
"data": {
"properties": {
"prediction": {
"description": "The team's place in the ranking; null when it is not ranked (too few recent matches).",
"properties": {
"last_match_date": {
"description": "Date of the team's most recent match.",
"type": [
"string",
"null"
]
},
"rank": {
"description": "Position in the ranking; 1 is the most overdue.",
"type": "integer"
},
"score": {
"description": "The draw-likelihood score the ranking sorts on.",
"type": "number"
},
"signals": {
"description": "The figures the score is built from.",
"properties": {
"current_no_draw_streak": {
"description": "Matches since the last draw.",
"type": [
"integer",
"null"
]
},
"draw_debt": {
"description": "Draws expected from the draw rate minus draws that came.",
"type": [
"number",
"null"
]
},
"draw_pct": {
"description": "Share of matches drawn, in percent.",
"type": [
"number",
"null"
]
},
"draws": {
"type": "integer"
},
"max_no_draw_streak": {
"description": "Longest run without a draw, ever.",
"type": [
"integer",
"null"
]
},
"played": {
"type": "integer"
}
},
"type": "object"
},
"team": {
"description": "A team.",
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"exists_now": {
"description": "False for a team that no longer exists.",
"type": "boolean"
},
"full_name": {
"description": "Official or long name, when known.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
},
"type": {
"description": "\"national_team\" or \"club\".",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
}
},
"required": [
"rank",
"score"
],
"type": [
"object",
"null"
]
},
"recent_form": {
"description": "The team's latest results, newest first.",
"items": {
"properties": {
"date": {
"type": "string"
},
"is_draw": {
"type": "boolean"
},
"match_id": {
"type": "integer"
},
"opponent": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"score": {
"description": "Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.",
"properties": {
"away": {
"type": [
"integer",
"null"
]
},
"home": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"side": {
"description": "\"home\" or \"away\".",
"type": "string"
},
"won": {
"type": "boolean"
}
},
"type": "object"
},
"type": "array"
},
"team": {
"description": "A team.",
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"exists_now": {
"description": "False for a team that no longer exists.",
"type": "boolean"
},
"full_name": {
"description": "Official or long name, when known.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
},
"type": {
"description": "\"national_team\" or \"club\".",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
}
},
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "[FREE] Every no-draw run one team has ever had, plus the one it is on now.\n\nA no-draw run is a sequence of matches that ended in a win or a loss. This returns the\nrun currently in progress with each match in it — date, competition, opponent, score —\nso you can say exactly when the team last drew and what has happened since, together\nwith every recorded run in the team's history, longest first, each with its start and\nend dates.\n\nRuns span all competitions; per-competition runs are not split out.\n\nFree: no key needed, and it costs a key holder nothing either.",
"inputSchema": {
"properties": {
"team": {
"description": "Numeric team id or slug — 431 or \"arsenal\". Find either with list_teams.",
"type": "string"
}
},
"required": [
"team"
],
"type": "object"
},
"name": "get_team_streaks",
"outputSchema": {
"properties": {
"data": {
"properties": {
"active_streak": {
"description": "The run the team is on now; null if its last match was a draw.",
"properties": {
"end": {
"type": [
"string",
"null"
]
},
"length": {
"description": "Matches since the team last drew.",
"type": "integer"
},
"matches": {
"items": {
"description": "A match.",
"properties": {
"away_team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"competition": {
"description": "The competition and edition the match belongs to.",
"properties": {
"edition": {
"type": [
"string",
"null"
]
},
"edition_id": {
"description": "The season or edition id, from list_tournaments.",
"type": [
"integer",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"integer",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"date": {
"description": "Match date, YYYY-MM-DD.",
"type": "string"
},
"home_team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"id": {
"description": "Match id, as get_draw_model takes it.",
"type": "integer"
},
"is_draw": {
"description": "Whether the match ended level.",
"type": "boolean"
},
"ninety_score_unknown": {
"description": "Played extra-time match known to be level at ninety minutes, with the exact ninety-minute score unavailable.",
"type": "boolean"
},
"result": {
"description": "H home win, A away win, D draw; empty until played.",
"type": [
"string",
"null"
]
},
"score": {
"description": "Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.",
"properties": {
"away": {
"type": [
"integer",
"null"
]
},
"home": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"score_120": {
"description": "Score after extra time; both values null when unavailable or no extra time was played.",
"properties": {
"away": {
"type": [
"integer",
"null"
]
},
"home": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"status": {
"description": "PLAYED, SCHEDULED, POSTPONED and so on.",
"type": "string"
}
},
"required": [
"id",
"date"
],
"type": "object"
},
"type": "array"
},
"start": {
"type": [
"string",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"runs": {
"description": "Every no-draw run the team has had.",
"items": {
"description": "A run of matches without a draw.",
"properties": {
"end": {
"description": "Date of the last match in the run.",
"type": [
"string",
"null"
]
},
"end_match_id": {
"type": [
"integer",
"null"
]
},
"id": {
"type": "integer"
},
"length": {
"description": "Matches in the run without a draw.",
"type": "integer"
},
"start": {
"description": "Date of the first match in the run.",
"type": [
"string",
"null"
]
},
"start_match_id": {
"type": [
"integer",
"null"
]
}
},
"required": [
"id",
"length"
],
"type": "object"
},
"type": "array"
},
"team": {
"description": "A team.",
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"exists_now": {
"description": "False for a team that no longer exists.",
"type": "boolean"
},
"full_name": {
"description": "Official or long name, when known.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
},
"type": {
"description": "\"national_team\" or \"club\".",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
}
},
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "[PAID] The complete record between two teams, and every match they have ever played.\n\nAnswers \"who wins more between these two, and how often do they draw?\" — matches\nplayed, wins each way, draws, goals each way and the draw percentage, all from team A's\nperspective, followed by every meeting with its date, competition and score. Optionally\nnarrow to one competition type or a single edition to compare only their league games,\nor only one season.\n\nBoth teams are given as numeric ids, which list_teams returns.\n\nCosts 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.",
"inputSchema": {
"properties": {
"a": {
"description": "Team A, as a numeric id from list_teams. The record is reported from this team's point of view.",
"type": "integer"
},
"b": {
"description": "Team B, as a numeric id from list_teams. Must differ from a.",
"type": "integer"
},
"item": {
"description": "Restrict to a single edition or season id, from list_tournaments with a `tournament` argument.",
"type": "integer"
},
"type": {
"description": "Restrict to one competition type, such as league or cup.",
"type": "string"
}
},
"required": [
"a",
"b"
],
"type": "object"
},
"name": "head_to_head",
"outputSchema": {
"properties": {
"data": {
"properties": {
"meetings": {
"description": "Every match between them.",
"items": {
"description": "A match.",
"properties": {
"away_team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"competition": {
"description": "The competition and edition the match belongs to.",
"properties": {
"edition": {
"type": [
"string",
"null"
]
},
"edition_id": {
"description": "The season or edition id, from list_tournaments.",
"type": [
"integer",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"integer",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"date": {
"description": "Match date, YYYY-MM-DD.",
"type": "string"
},
"home_team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"id": {
"description": "Match id, as get_draw_model takes it.",
"type": "integer"
},
"is_draw": {
"description": "Whether the match ended level.",
"type": "boolean"
},
"ninety_score_unknown": {
"description": "Played extra-time match known to be level at ninety minutes, with the exact ninety-minute score unavailable.",
"type": "boolean"
},
"result": {
"description": "H home win, A away win, D draw; empty until played.",
"type": [
"string",
"null"
]
},
"score": {
"description": "Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.",
"properties": {
"away": {
"type": [
"integer",
"null"
]
},
"home": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"score_120": {
"description": "Score after extra time; both values null when unavailable or no extra time was played.",
"properties": {
"away": {
"type": [
"integer",
"null"
]
},
"home": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"status": {
"description": "PLAYED, SCHEDULED, POSTPONED and so on.",
"type": "string"
}
},
"required": [
"id",
"date"
],
"type": "object"
},
"type": "array"
},
"record": {
"description": "The overall record between the two.",
"properties": {
"draw_percent": {
"type": [
"number",
"null"
]
},
"draws": {
"type": "integer"
},
"goals_team_a": {
"type": "integer"
},
"goals_team_b": {
"type": "integer"
},
"played": {
"type": "integer"
},
"team_a_wins": {
"type": "integer"
},
"team_b_wins": {
"type": "integer"
}
},
"type": "object"
},
"team_a": {
"description": "A team.",
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"exists_now": {
"description": "False for a team that no longer exists.",
"type": "boolean"
},
"full_name": {
"description": "Official or long name, when known.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
},
"type": {
"description": "\"national_team\" or \"club\".",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"team_b": {
"description": "A team.",
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"exists_now": {
"description": "False for a team that no longer exists.",
"type": "boolean"
},
"full_name": {
"description": "Official or long name, when known.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
},
"type": {
"description": "\"national_team\" or \"club\".",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
}
},
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "[FREE] Every country in the database, with its FIFA code and id.\n\nUse it to turn a country name into the id and FIFA code the rest of the data is keyed\nby, or to check which countries are covered at all. Search with `q`, which matches a\nname prefix or an exact FIFA code (\"ENG\"). Countries that no longer exist are included\nand flagged, because the match archive still holds their games.\n\nFree: no key needed, and it costs a key holder nothing either.",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "How many countries to return. Default 25; the total is always reported.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Country name prefix, or an exact FIFA code such as ENG or BRA.",
"type": "string"
}
},
"type": "object"
},
"name": "list_countries",
"outputSchema": {
"properties": {
"data": {
"description": "Countries matching the search.",
"items": {
"description": "A country.",
"properties": {
"exists_now": {
"type": "boolean"
},
"fifa_code": {
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"is_international": {
"type": "boolean"
},
"iso2": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
}
},
"required": [
"id",
"name"
],
"type": "object"
},
"type": "array"
},
"hint": {
"description": "Present only when rows were left out: how to narrow the call.",
"type": "string"
},
"returned": {
"description": "How many rows are in data.",
"type": "integer"
},
"total": {
"description": "How many rows matched before the limit.",
"type": "integer"
}
},
"required": [
"data",
"total",
"returned"
],
"type": "object"
}
},
{
"description": "[FREE] Find a team and its id — the lookup every other team tool depends on.\n\nSearch by name prefix with `q` (\"arse\" finds Arsenal), or browse by first letter, or\nlist one kind of team. Each row carries the numeric id and the slug that get_team,\nget_team_streaks, get_team_prediction, head_to_head and search_results take.\n\nThe database holds thousands of teams, so an unfiltered call returns the first 25 with\nthe full total beside them. Always pass `q` when you know the name.\n\nFree: no key needed, and it costs a key holder nothing either.",
"inputSchema": {
"properties": {
"letter": {
"description": "First letter A-Z to browse by, or \"#\" for names starting with a non-letter.",
"maxLength": 1,
"type": "string"
},
"limit": {
"default": 25,
"description": "How many teams to return. Default 25; the total number of matches is always reported.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Name prefix, matched against both the short and the full name. The fastest way to find one team.",
"type": "string"
},
"type": {
"description": "Restrict to national teams or to clubs.",
"enum": [
"national_team",
"club"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_teams",
"outputSchema": {
"properties": {
"data": {
"description": "Teams matching the search.",
"items": {
"description": "A team.",
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"exists_now": {
"description": "False for a team that no longer exists.",
"type": "boolean"
},
"full_name": {
"description": "Official or long name, when known.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
},
"type": {
"description": "\"national_team\" or \"club\".",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"type": "array"
},
"hint": {
"description": "Present only when rows were left out: how to narrow the call.",
"type": "string"
},
"returned": {
"description": "How many rows are in data.",
"type": "integer"
},
"total": {
"description": "How many rows matched before the limit.",
"type": "integer"
}
},
"required": [
"data",
"total",
"returned"
],
"type": "object"
}
},
{
"description": "[FREE] Every competition covered — leagues, domestic cups, continental cups, World Cups — with\nhow many matches and how many draws each one holds.\n\nTwo uses. Without `tournament` it answers \"what is in this database, and how draw-heavy\nis each competition?\", returning each competition's id, slug, country, match count, draw\ncount and draw percentage. With `tournament` (an id or slug) it returns that one\ncompetition in full: the years it covers, every edition newest first with its champion\nwhere one was decided, and the all-time winners ranking with title counts and years.\n\nThe competition ids here are what search_results and head_to_head filter by.\n\nFree: no key needed, and it costs a key holder nothing either.",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "How many competitions to list. Default 25; the total is always reported.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"tournament": {
"description": "One competition, by numeric id or slug (53 or \"norway-cup\"). Returns its editions, champions and all-time winners instead of the list.",
"type": "string"
}
},
"type": "object"
},
"name": "list_tournaments",
"outputSchema": {
"properties": {
"data": {
"description": "Competitions, or one competition's editions.",
"items": {
"description": "A competition, or with `tournament` given, one of its editions.",
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"draw_percent": {
"type": [
"number",
"null"
]
},
"draws_count": {
"type": [
"integer",
"null"
]
},
"id": {
"type": "integer"
},
"matches_count": {
"type": [
"integer",
"null"
]
},
"name": {
"type": "string"
},
"slug": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"name"
],
"type": "object"
},
"type": "array"
},
"hint": {
"description": "Present only when rows were left out: how to narrow the call.",
"type": "string"
},
"returned": {
"description": "How many rows are in data.",
"type": "integer"
},
"total": {
"description": "How many rows matched before the limit.",
"type": "integer"
}
},
"required": [
"data",
"total",
"returned"
],
"type": "object"
}
},
{
"description": "[PAID] Rank teams by how overdue a draw is — the question this database exists to answer.\n\nEvery team has a historical draw rate and a run of matches since its last draw. When\nthe run is long relative to how often that team normally draws, the team is carrying\n\"draw debt\", and this tool ranks the whole field by it, most overdue first. Ask it\n\"which national teams are most due a draw?\" or \"who is overdue a draw in the World\nCup 2026 field?\" and it answers directly; nothing else here needs to be queried first.\n\nEach entry returns the rank, the score, and the signals behind it: matches played,\ndraws, draw percentage, the current no-draw streak, the longest ever, and the debt\nfigure. Filters subset which teams are listed — a team's score and rank are global and\nnever change with them. Historical pattern, not a betting tip.\n\nCosts 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "How many ranked teams to return. Default 25, max 500. One call, one point, whatever the limit.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"recent": {
"default": true,
"description": "Only teams with a recent match, so the answer is about teams currently playing. Default true.",
"type": "boolean"
},
"type": {
"description": "Restrict the ranking to national teams or to clubs. Omit to rank both together.",
"enum": [
"national_team",
"club"
],
"type": "string"
},
"wc2026": {
"default": false,
"description": "Restrict to the 2026 World Cup team group. Default false.",
"type": "boolean"
}
},
"type": "object"
},
"name": "predict_draws",
"outputSchema": {
"properties": {
"data": {
"description": "Teams ranked by how overdue a draw is, most overdue first.",
"items": {
"description": "A ranked team.",
"properties": {
"last_match_date": {
"description": "Date of the team's most recent match.",
"type": [
"string",
"null"
]
},
"rank": {
"description": "Position in the ranking; 1 is the most overdue.",
"type": "integer"
},
"score": {
"description": "The draw-likelihood score the ranking sorts on.",
"type": "number"
},
"signals": {
"description": "The figures the score is built from.",
"properties": {
"current_no_draw_streak": {
"description": "Matches since the last draw.",
"type": [
"integer",
"null"
]
},
"draw_debt": {
"description": "Draws expected from the draw rate minus draws that came.",
"type": [
"number",
"null"
]
},
"draw_pct": {
"description": "Share of matches drawn, in percent.",
"type": [
"number",
"null"
]
},
"draws": {
"type": "integer"
},
"max_no_draw_streak": {
"description": "Longest run without a draw, ever.",
"type": [
"integer",
"null"
]
},
"played": {
"type": "integer"
}
},
"type": "object"
},
"team": {
"description": "A team.",
"properties": {
"country": {
"description": "The country a team or competition belongs to.",
"properties": {
"fifa_code": {
"description": "Three-letter FIFA code.",
"type": [
"string",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
}
},
"required": [
"id"
],
"type": [
"object",
"null"
]
},
"exists_now": {
"description": "False for a team that no longer exists.",
"type": "boolean"
},
"full_name": {
"description": "Official or long name, when known.",
"type": [
"string",
"null"
]
},
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
},
"type": {
"description": "\"national_team\" or \"club\".",
"type": [
"string",
"null"
]
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
}
},
"required": [
"rank",
"score"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "[FREE for the last 7 days · PAID for the archive] Search the match archive: finished matches, newest first, with scores.\n\nThis is the raw history behind every other tool — decades of results across national\nteam football, domestic leagues and cups. Filter by team, competition, single season,\noutcome (home win, away win or draw) and date range, in any combination: \"Arsenal's\ndraws since 2020\", \"every match in the 2025/26 Premier League\", \"all draws in the World\nCup\". Each match returns its date, competition and edition, both teams, the score and\nwhether it was a draw.\n\nResults are paginated, 50 per page by default; `page` walks through them and\n`meta.total` tells you how many matches matched before you start.\n\nFree, no key needed, for recent results: the first page of 50, and any `from` date\ninside the last 7 days. Reaching further back — an older `from`, a bigger `limit`, or\npage 2 onward — is the archive and costs 1 point per call (1 point = 1 cent), one point\nper page.",
"inputSchema": {
"properties": {
"competition_id": {
"description": "Restrict to one competition. Id from list_tournaments.",
"type": "integer"
},
"competition_item_id": {
"description": "Restrict to a single edition or season. Edition ids come from list_tournaments with a `tournament` argument.",
"type": "integer"
},
"from": {
"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.",
"type": "string"
},
"limit": {
"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.",
"enum": [
50,
100,
250,
500
],
"type": "integer"
},
"outcome": {
"description": "H for a home win, A for an away win, D for a draw.",
"enum": [
"H",
"A",
"D"
],
"type": "string"
},
"page": {
"default": 1,
"description": "Page number, from 1. Page 1 can be free; every page after it is a separate call and costs its own point.",
"minimum": 1,
"type": "integer"
},
"team_id": {
"description": "Matches involving this team, home or away. Numeric id from list_teams.",
"type": "integer"
},
"to": {
"description": "Latest match date, inclusive, as YYYY-MM-DD.",
"type": "string"
},
"type": {
"description": "Restrict to national-team or club football.",
"enum": [
"national_team",
"club"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_results",
"outputSchema": {
"properties": {
"data": {
"description": "Matches, newest first.",
"items": {
"description": "A match.",
"properties": {
"away_team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"competition": {
"description": "The competition and edition the match belongs to.",
"properties": {
"edition": {
"type": [
"string",
"null"
]
},
"edition_id": {
"description": "The season or edition id, from list_tournaments.",
"type": [
"integer",
"null"
]
},
"id": {
"type": "integer"
},
"name": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"integer",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"date": {
"description": "Match date, YYYY-MM-DD.",
"type": "string"
},
"home_team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
},
"id": {
"description": "Match id, as get_draw_model takes it.",
"type": "integer"
},
"is_draw": {
"description": "Whether the match ended level.",
"type": "boolean"
},
"ninety_score_unknown": {
"description": "Played extra-time match known to be level at ninety minutes, with the exact ninety-minute score unavailable.",
"type": "boolean"
},
"result": {
"description": "H home win, A away win, D draw; empty until played.",
"type": [
"string",
"null"
]
},
"score": {
"description": "Ninety-minute score; both values null before play or when the exact score is unknown, including played extra-time draws.",
"properties": {
"away": {
"type": [
"integer",
"null"
]
},
"home": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"score_120": {
"description": "Score after extra time; both values null when unavailable or no extra time was played.",
"properties": {
"away": {
"type": [
"integer",
"null"
]
},
"home": {
"type": [
"integer",
"null"
]
}
},
"type": "object"
},
"status": {
"description": "PLAYED, SCHEDULED, POSTPONED and so on.",
"type": "string"
}
},
"required": [
"id",
"date"
],
"type": "object"
},
"type": "array"
},
"links": {
"description": "first/last/prev/next page URLs on the REST API.",
"type": "object"
},
"meta": {
"description": "Pagination: which page this is and how many rows exist.",
"properties": {
"current_page": {
"type": "integer"
},
"last_page": {
"type": "integer"
},
"per_page": {
"type": "integer"
},
"total": {
"description": "Rows across every page.",
"type": "integer"
}
},
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "[PAID] The all-time leaderboard of no-draw runs — the longest any team has gone without drawing.\n\nAnswers \"what is the longest run of matches without a draw on record?\" and \"who else has\ndone it?\". Each entry is one run: its length, the dates it started and ended, and the\nteam. A team can appear more than once, since a great side may have several long runs.\nFilter to one team, to national teams or clubs, or to runs above a minimum length.\n\nPaginated, 25 per page by default; `page` walks the leaderboard and each page costs its\nown point.\n\nCosts 1 point per call (1 point = 1 cent); paginated calls cost 1 point per page.",
"inputSchema": {
"properties": {
"limit": {
"default": 25,
"description": "Page size. Default 25, max 500.",
"maximum": 500,
"minimum": 1,
"type": "integer"
},
"min": {
"default": 5,
"description": "Minimum run length to list. Default 5.",
"minimum": 1,
"type": "integer"
},
"page": {
"default": 1,
"description": "Page number, from 1. Each page is a separate call and costs its own point.",
"minimum": 1,
"type": "integer"
},
"team_id": {
"description": "Restrict to one team. Numeric id from list_teams.",
"type": "integer"
},
"type": {
"description": "Restrict to national teams or to clubs.",
"enum": [
"national_team",
"club"
],
"type": "string"
}
},
"type": "object"
},
"name": "top_streaks",
"outputSchema": {
"properties": {
"data": {
"description": "The longest no-draw runs, longest first.",
"items": {
"description": "A run of matches without a draw, and whose it was.",
"properties": {
"end": {
"type": [
"string",
"null"
]
},
"end_match_id": {
"type": [
"integer",
"null"
]
},
"id": {
"type": "integer"
},
"length": {
"description": "Matches in the run without a draw.",
"type": "integer"
},
"start": {
"type": [
"string",
"null"
]
},
"start_match_id": {
"type": [
"integer",
"null"
]
},
"team": {
"description": "A team reference.",
"properties": {
"id": {
"description": "Team id — the argument every team tool takes.",
"type": "integer"
},
"name": {
"description": "Short display name.",
"type": "string"
},
"slug": {
"description": "URL slug; accepted anywhere an id is.",
"type": "string"
}
},
"required": [
"id",
"slug",
"name"
],
"type": "object"
}
},
"required": [
"id",
"length"
],
"type": "object"
},
"type": "array"
},
"links": {
"description": "first/last/prev/next page URLs on the REST API.",
"type": "object"
},
"meta": {
"description": "Pagination: which page this is and how many rows exist.",
"properties": {
"current_page": {
"type": "integer"
},
"last_page": {
"type": "integer"
},
"per_page": {
"type": "integer"
},
"total": {
"description": "Rows across every page.",
"type": "integer"
}
},
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:566b0b46f5fe825aba0e9ffb2e4f3ccdca8fdbb69d0021b626967ad2fad014ef | sha256sum