
golviva
com.golviva/golviva
Football match predictions, title race chances, player valuations, live scores, tables and news.
Documentation
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.
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
| Ask | Golviva 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.
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_leagueshas 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.
| Factor | What it measures |
|---|---|
| Performance | Output against what the player's price predicts inside his position and league-strength cohort: performing above his price lifts the value |
| Potential | Where 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 |
| Contract | Leverage the selling club loses as the contract runs down |
| Durability | Injuries 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
| Tool | What it does |
|---|---|
get_match_prediction | Golviva'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_projection | A 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_predictions | Golviva'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
| Tool | What it does |
|---|---|
get_player | A 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_players | 2–4 players side by side: values, age, position, performance percentile, every valuation factor and this season's output. |
find_players | Scout by league, club, nation, position, age, preferred foot and value range; sort by value, market value, undervalued, overvalued, youth, performance or recent rise. |
get_rankings | Most valuable, most undervalued or overvalued (€10M+), biggest risers or fallers, wonderkids (21 and under). |
search_football | Find players, clubs, leagues and national teams by name, accents optional. |
Leagues, clubs, national teams
| Tool | What it does |
|---|---|
list_leagues | Every league Golviva values, with its code, strength tier, clubs, players and total squad value. |
get_league | A league's clubs ranked by squad value (Golviva against market) and its most valuable players. |
get_club | A club's squad with every player's Golviva value, market value and the gap, plus totals. |
get_national_team | The strongest 26-player squad for a nation (3 GK, 8 DF, 8 MF, 7 FW by value). |
Matches
| Tool | What it does |
|---|---|
get_matches | Live scores, results and fixtures (live, today, yesterday, tomorrow or any date) across leagues, European and domestic cups and national-team tournaments. |
get_match | One match in depth: score, event timeline, team statistics, line-ups with ratings and the model's chances. |
get_team_fixtures | A club's or national team's next or most recent matches. |
get_standings | A competition's table with form and qualification, promotion and relegation zones. |
Statistics & transfers
| Tool | What it does |
|---|---|
get_stat_leaders | Season leaderboards (goals, assists, goals + assists, minutes, appearances) per competition, across national-team competitions, or across all competitions combined. |
get_transfer_news | Latest 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:
| Skill | What it teaches |
|---|---|
follow-matches-and-tables | Scores, 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-players | Read 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-players | Turn a scouting brief into filters, pick the right ranking, read squads, leagues and national teams |
stats-and-transfer-news | Leaderboards 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
- Golviva: https://golviva.com/
- MCP setup page with a live demo: https://golviva.com/mcp
- Today's predictions and the model's record: https://golviva.com/predictions
- How the models work: https://golviva.com/about
- Privacy: https://golviva.com/privacy · Terms: https://golviva.com/terms
- Help & support: https://golviva.com/support · support@golviva.com
- Security reports: SECURITY.md
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.