Repository avatar
Other Tools
v2.1.0
active

golviva

com.golviva/golviva

Football match predictions, title race chances, player valuations, live scores, tables and news.

Documentation

Golviva

Golviva MCP server

Who wins the match? What is every footballer really worth? Ask your assistant.

Match predictions for 26 leagues, the European club competitions and national teams, season projections, independent player valuations with the reasons behind them, plus live scores, match centres, league tables, stat leaders and transfer news, in Claude, ChatGPT, Cursor, VS Code and any other MCP client.

Setup & live demo MCP Read-only License: MIT

Add to Cursor Install in VS Code

Two Golviva cards: the match prediction for Atlético Madrid against Barcelona, with the win, draw and loss chances, the likeliest scores and scorers and the line-ups, and Lamine Yamal's valuation with the factor breakdown and value history

Golviva is a football site and app built around the goal: live scores and match pages first, and behind them a statistical match model and its own estimated transfer value for every player in 26 leagues, shown next to the market value with the gap explained factor by factor. This repository documents Golviva's hosted MCP server, which puts the predictions, the valuations and the live game straight into your assistant. Answers render as interactive cards in clients that support MCP Apps (Claude, ChatGPT), and as clean structured data everywhere else.

Connect in a minute

Nothing to install, nothing to run. Golviva is a remote server:

https://api.golviva.com/mcp

Sign in with Apple or Google when your client asks. Every account includes a free daily allowance of tool calls; a typical question uses one to three.

Claude (web, desktop, mobile): Settings → Connectors → Add custom connector → name it Golviva, paste the URL → Connect → sign in.

ChatGPT: open Plugins → + → Add custom MCP server → name Golviva, paste the URL, authentication OAuth → confirm and Create as a plugin → sign in, then type @Golviva in a chat (or pick it from the + menu). Custom MCP servers depend on your ChatGPT plan and workspace settings.

Claude Code

claude mcp add --transport http golviva https://api.golviva.com/mcp

Then run /mcp, choose golviva → Authenticate. To get the four skills with it, install this repository as a plugin instead:

/plugin marketplace add target1m/golviva-mcp
/plugin install golviva@golviva-mcp

Gemini CLI: the extension adds the server and the four skills:

gemini extensions install https://github.com/target1m/golviva-mcp

Then run /mcp auth golviva once inside Gemini CLI to sign in.

Cursor: use the Add to Cursor button above, or add it to ~/.cursor/mcp.json and click Needs login (the repository is also a Cursor plugin with the four skills, .cursor-plugin/):

{ "mcpServers": { "golviva": { "url": "https://api.golviva.com/mcp" } } }

VS Code: use the Install in VS Code button above, or:

code --add-mcp '{"name":"golviva","type":"http","url":"https://api.golviva.com/mcp"}'

Any other client: add a remote (Streamable HTTP) server with the URL. The server is a standard OAuth 2.1 resource server with its own authorization server (dynamic client registration, client ID metadata documents, PKCE and OpenID Connect), so clients that speak MCP authorization run the sign-in by themselves.

No browser sign-in? Create a personal API key at golviva.com/mcp (shown once, revocable any time) and send it as a Bearer token:

claude mcp add --transport http golviva https://api.golviva.com/mcp --header "Authorization: Bearer fvk_your_key"

Try asking

AskGolviva answers with
"Predict Real Madrid's next match: chances, likely scorers and line-ups."get_match_prediction: win, draw and loss chances, likeliest scores, goals, likeliest scorers, predicted line-ups
"Who wins when Germany play the Netherlands?"get_match_prediction: national-team matches are predicted too
"Who will win the Premier League, and who will go down?"get_season_projection: every club's title, top-four, Europe and relegation chances
"What are Golviva's match predictions for today?"get_predictions: the model's most confident calls of the day, graded after the final whistle
"What is Lamine Yamal really worth, and why?"get_player: value against market, the verdict, the factors behind it, value history
"Compare Arda Güler, Florian Wirtz and Jamal Musiala."compare_players: one card, every factor side by side
"Left-footed centre-backs under 23 in Serie A worth less than €30M."find_players: a scouting shortlist
"Who are the most undervalued players in the Premier League?"get_rankings: where Golviva sees more than the market
"What are today's scores?"get_matches: live, finished and upcoming, by competition
"Show me the match centre of Atlético against Barcelona."get_match: events, team statistics, line-ups with ratings, the model's call
"Show me the Süper Lig table."get_standings: points, form, qualification and relegation zones
"Who are the Champions League top scorers?"get_stat_leaders: season leaderboards across competitions
"Any Galatasaray transfer news?"get_transfer_news: confirmed deals and rumours with their reliability

What it looks like

Every answer is a card you can explore: click a player, club or match inside it and the next card opens in place.

A daily predictions card with the record of the last 7 and 16 prediction days and each call marked right or postponed, and the Premier League's projected table with every club's title, Champions League and relegation chances A comparison card for Arda Güler, Florian Wirtz and Jamal Musiala with every valuation factor side by side, and a wonderkids ranking card The match centre of Atlético Madrid 1–2 Barcelona with Golviva's pre-match chances, the timeline and the team statistics, and the Premier League table with its qualification and relegation zones

Cards follow the host's language (English, Turkish, German, French, Spanish, Italian, Portuguese and Arabic, right to left) and its light or dark theme. Screenshots show real data from November 2026; values, chances and tables move as Golviva updates them.

Coverage

  • Valuations, squads, club and league pages for every player of 26 leagues: the 21 European top divisions (Premier League, LaLiga, Serie A, Bundesliga, Ligue 1, Eredivisie, Liga Portugal, Süper Lig, Belgium, Scotland, Austria, Switzerland, Greece, Russia, Ukraine, Denmark, Czechia, Poland, Norway, Sweden, Croatia), England's Championship, MLS, the Saudi Pro League, Brazil's Série A and Egypt's Premier League. list_leagues has the full list with codes.
  • Match predictions for every match of those leagues, of the Champions League, Europa League and Conference League, and of senior national teams (World Cup, Euro, Nations League, qualifiers and friendlies), from about a day and a half before kick-off.
  • Season projections for the 17 of those leagues whose final table is the regular season's: the big five, the Eredivisie, Liga Portugal, the Süper Lig, the Championship, the Saudi Pro League, Brazil, Russia, Ukraine, Poland, Croatia, Norway and Sweden. Leagues that split in two or end in play-offs have none.
  • Live scores, match centres and tables for those competitions and many more: second divisions, domestic cups, the other continental club competitions and national-team tournaments.
  • Stat leaders for the leagues, the European and domestic cups and the national-team competitions, back to 2020.

How the predictions work

  • Every probability comes from Golviva's own statistical model: team ratings fitted on goals and expected goals, each side's expected line-up and absences, and one score grid from which every market is read, so the chances never contradict each other. No bookmaker's odds go into it, and the MCP server returns none.
  • Each side's predicted line-up is its recent starters minus the injured and suspended; the confirmed line-ups replace them about an hour before kick-off. A national side's squad changes with every call-up, so its line-ups and likeliest scorers appear only once the official ones are out (final tournaments apart).
  • Every morning before the first kick-off the model locks in its most confident calls of the day (up to 10) and grades each one after the final whistle. The record over the last 7 and 30 prediction days is public on every card and at golviva.com/predictions.
  • Season projections play the rest of the season out 10,000 times with the same ratings and are refreshed every 6 hours.
  • These are model probabilities for information, not betting advice.

How Golviva values a player

Golviva starts from the market value and expresses where it disagrees. Each factor multiplies the value, every factor is bounded, and thin data keeps the estimate close to the market rather than inventing a story.

FactorWhat it measures
PerformanceOutput against what the player's price predicts inside his position and league-strength cohort: performing above his price lifts the value
PotentialWhere players of the same age, position and price have historically gone next: young players read above their price (less so the pricier they already are), players past their prime below it
ContractLeverage the selling club loses as the contract runs down
DurabilityInjuries over the last two seasons

Within ±5 % of the market the verdict is fair; above it the market undervalues the player, below it the market overvalues him. Every call is checked against what happened next: the model is backtested against later market moves and real transfer fees. More on the model: golviva.com/about.

Tools

18 tools, all read-only: Golviva never posts, buys or changes anything. Each one declares a title, all four MCP hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) and its OAuth security scheme, so your client can show what a call does before you allow it. Most arguments take plain names ("Arda Güler", "Süper Lig", "Turkey") as well as ids.

Predictions

ToolWhat it does
get_match_predictionGolviva's prediction for one match, by match id, team (its next match) or league (its upcoming matches): home win, draw and away win chances, the likeliest scores, total goals and both teams to score, the likeliest scorers, the predicted line-ups (the confirmed ones about an hour before kick-off), corners and cards and, after the final whistle, whether it came in.
get_season_projectionA league's projected final table: the rest of the season played out 10,000 times, with each club's chance of the title, the top four and the Champions League places, Europe and relegation (promotion in the Championship), and its expected points.
get_predictionsGolviva's daily match predictions: the model's most confident calls of the day (up to 10), locked in every morning before the first kick-off, each with the model's probability, the likeliest score and scorer, the live or final score and whether it came in, plus the hit rate over the last 7 and 30 days.

Valuations

ToolWhat it does
get_playerA player's Golviva value next to the market value, the gap and its verdict, the factor breakdown, value history, season stats, transfers, contract and similar players.
compare_players2–4 players side by side: values, age, position, performance percentile, every valuation factor and this season's output.
find_playersScout by league, club, nation, position, age, preferred foot and value range; sort by value, market value, undervalued, overvalued, youth, performance or recent rise.
get_rankingsMost valuable, most undervalued or overvalued (€10M+), biggest risers or fallers, wonderkids (21 and under).
search_footballFind players, clubs, leagues and national teams by name, accents optional.

Leagues, clubs, national teams

ToolWhat it does
list_leaguesEvery league Golviva values, with its code, strength tier, clubs, players and total squad value.
get_leagueA league's clubs ranked by squad value (Golviva against market) and its most valuable players.
get_clubA club's squad with every player's Golviva value, market value and the gap, plus totals.
get_national_teamThe strongest 26-player squad for a nation (3 GK, 8 DF, 8 MF, 7 FW by value).

Matches

ToolWhat it does
get_matchesLive scores, results and fixtures (live, today, yesterday, tomorrow or any date) across leagues, European and domestic cups and national-team tournaments.
get_matchOne match in depth: score, event timeline, team statistics, line-ups with ratings and the model's chances.
get_team_fixturesA club's or national team's next or most recent matches.
get_standingsA competition's table with form and qualification, promotion and relegation zones.

Statistics & transfers

ToolWhat it does
get_stat_leadersSeason leaderboards (goals, assists, goals + assists, minutes, appearances) per competition, across national-team competitions, or across all competitions combined.
get_transfer_newsLatest confirmed transfers and rumours with fees, clubs, reliability and dates.

Every argument, type and default, generated from the server's own registrations: skills/value-and-compare-players/references/tools.md.

Privacy & limits

  • Read-only. No tool writes, posts, buys or deletes anything.
  • You sign in with Apple or Google. Golviva sees the tool calls your assistant makes, never your conversation. If your assistant asks for it when you connect (ChatGPT does), Golviva shares your account's e-mail address and name with it; the sign-in screen says so before you allow it.
  • Free daily allowance for every account. Usage, connected apps and API keys live at golviva.com/mcp; disconnecting an app ends its access immediately.
  • Full details: privacy policy · terms of service · help & support.

Skills (plugin)

The tools are the capability; the skills are the judgement about which tool to reach for and how to read the answer. This repository is also an installable plugin with four skills:

SkillWhat it teaches
follow-matches-and-tablesScores, match centres, fixtures, tables, match predictions and season projections: UTC dates, local kick-off times, never an invented score, probabilities never sold as certainties
value-and-compare-playersRead a valuation honestly: value against market, the ±5 % fair band, what each factor means, and when thin data keeps the value close to the market
scout-and-rank-playersTurn a scouting brief into filters, pick the right ranking, read squads, leagues and national teams
stats-and-transfer-newsLeaderboards by competition and season; transfer news with its reliability spelled out
plugin.json                       portable manifest (Agent Plugins 1.0.0) + ChatGPT/Codex listing metadata
.claude-plugin/plugin.json        the same, for clients that read this path
.claude-plugin/marketplace.json   makes this repository a Claude Code plugin marketplace
.cursor-plugin/plugin.json        Cursor plugin (server + skills), also read by Grok Bot
mcp.json                          the hosted server, for Agent Plugins hosts (Codex, ChatGPT)
.mcp.json                         the hosted server, for Claude Code
gemini-extension.json             Gemini CLI extension (server + skills, OAuth sign-in)
server.json                       official MCP Registry manifest (com.golviva/golviva)
glama.json                        Glama maintainers
skills/<name>/SKILL.md            one workflow each
assets/                           logo (1024 px), plugin icon, README screenshots, social preview

Links

About this repository

Documentation, manifests and skills for a hosted service; Golviva's own source is not public. Questions, bugs and ideas about the MCP server are welcome as issues.

No installation packages available.

Remote