Search / io.fdb4/football-database-and-results
protogridR0· no sign-inHistorical football results, draws and no-draw streaks. 11 read-only tools, 6 need no API key.
v1.1.0 · active · website · descriptor JSON · versions
{
"mcpServers": {
"football-database-and-results": {
"type": "http",
"url": "https://fdb4.io/mcp",
"headers": {
"Authorization": "Bearer ${api_key}"
}
}
}
}claude mcp add --transport http football-database-and-results https://fdb4.io/mcp --header "Authorization: Bearer ${api_key}"[mcp_servers.football-database-and-results]
url = "https://fdb4.io/mcp"
bearer_token_env_var = "api_key"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"football-database-and-results": {
"type": "remote",
"url": "https://fdb4.io/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer {env:api_key}"
}
}
}
}{
"mcpServers": {
"football-database-and-results": {
"type": "http",
"url": "https://fdb4.io/mcp",
"headers": {
"Authorization": "Bearer ${api_key}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=football-database-and-results&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZmRiNC5pby9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHthcGlfa2V5fSJ9fQ%3D%3D"
}{
"servers": {
"football-database-and-results": {
"type": "http",
"url": "https://fdb4.io/mcp",
"headers": {
"Authorization": "Bearer ${api_key}"
}
}
}
}{
"mcpServers": {
"football-database-and-results": {
"httpUrl": "https://fdb4.io/mcp",
"headers": {
"Authorization": "Bearer ${api_key}"
}
}
}
}extensions:
"football-database-and-results":
enabled: true
name: "football-database-and-results"
type: streamable_http
uri: "https://fdb4.io/mcp"
headers:
"Authorization": "Bearer ${api_key}"
timeout: 300
Placeholders to fill from your own secret store: ${api_key}. The registry never accepts secret values.
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every useauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_length1 tools have descriptions over 1,024 characters, which crowds the contexttools.schemasevery tool has an object input schematools.annotations11 of 11 tools declare readOnlyHint or destructiveHinttools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_draw_model (destructiveHint, openWorldHint); top_streaks (destructiveHint, openWorldHint); predict_draws (destructiveHint, openWorldHint); …tools.token_costabout 3,479 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes5 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packagehead_to_headchangedoutput schemasearch_resultschangedoutput schemaget_team_streakschangedoutput schemaget_draw_modelchangedoutput schemaget_team_predictionchangedoutput schemaFull history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-97% +updated-28d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://fdb4.io/mcp streamable-http | none | yes | 97% | 476 ms | 2026-07-28 | 2026-10-20 |
get_draw_modelread-only | [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. |
get_teamread-only | [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. |
get_team_predictionread-only | [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. |
get_team_streaksread-only | [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. |
head_to_headread-only | [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. |
list_countriesread-only | [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. |
list_teamsread-only | [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. |
list_tournamentsread-only | [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. |
predict_drawsread-only | [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. |
search_resultsread-only | [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. |
top_streaksread-only | [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. |
Schemas: list_tools.
{
"name": "io.fdb4/football-database-and-results",
"title": "Football Database and Results",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://fdb4.io/mcp",
"type": "streamable-http",
"headers": [
{
"name": "Authorization",
"value": "Bearer {api_key}",
"isSecret": true,
"variables": {
"api_key": {
"isSecret": true,
"description": "FDB4 API key — optional, create one at https://fdb4.io/mcp"
}
},
"description": "OPTIONAL. Six tools answer without it: get_team_streaks, list_teams, get_team, list_tournaments, list_countries and search_results over the last 7 days. A key opens the draw models, the all-time leaderboard, full head-to-head records and the whole results archive; it is free to create at https://fdb4.io/mcp and starts with 10 points, then 1 call = 1 point = 1 cent."
}
]
}
],
"version": "1.1.0",
"websiteUrl": "https://fdb4.io/mcp",
"description": "Historical football results, draws and no-draw streaks. 11 read-only tools, 6 need no API key."
}