FootVal MCP server

What is every footballer really worth? Ask your assistant.

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.

FootVal doesn't mirror the market — it challenges it. For every player in Europe's top divisions, MLS and the Saudi Pro League it computes its own estimated transfer value, shows it next to the market value, and explains the gap factor by factor. This repository documents FootVal's hosted MCP server, which puts those 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 — FootVal is a remote server:

https://api.footval.com/mcp

Sign in with 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 FootVal, paste the URL → Connect → sign in.

ChatGPT — open Plugins → + → Add custom MCP server → name FootVal, paste the URL, authentication OAuth → confirm and Create as a plugin → sign in, then type @FootVal 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 footval https://api.footval.com/mcp

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

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

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

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

Then run /mcp auth footval 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:

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

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

code --add-mcp '{"name":"footval","type":"http","url":"https://api.footval.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 footval.com/en/mcp (shown once, revocable any time) and send it as a Bearer token:

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

Try asking

Ask	FootVal answers with
"What is Lamine Yamal really worth — and why?"	get_player — value vs 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 FootVal sees more than the market
"What are today's scores?"	get_matches — live, finished and upcoming, by competition
"Show me the match centre of the last Champions League final."	get_match — events, team stats, line-ups with ratings
"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 (7 languages) and light/dark theme. Screenshots show sample data — values update as FootVal re-runs its valuations.

How FootVal values a player

FootVal 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 price inside the player's position and league-strength cohort — performing above his price lifts the value
Potential	The age curve around each position's prime: development premium when young, depreciation past the peak
Contract	Leverage the selling club loses as the contract runs down
Durability	Injuries and availability over the last two seasons
Reputation	International caps and trophies
Form	The latest season against the previous one

Within ±5 % of the market the verdict is fair; above it the market undervalues the player, below it the market overvalues him. More on the model: footval.com/en/about.

Tools

15 tools, all read-only — FootVal 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.

Valuations

Tool	What it does
get_player	A player's FootVal 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 last-season 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 / overvalued (€10M+), biggest risers / 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 FootVal values, with strength tier, clubs, players and total squad value.
get_league	A league's clubs ranked by squad value (FootVal vs market) and its most valuable players.
get_club	A club's squad with every player's FootVal 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 and line-ups with ratings.
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 / 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 Google. FootVal sees the tool calls your assistant makes — never your conversation. If your assistant asks for it when you connect (ChatGPT does), FootVal 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 footval.com/en/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
value-and-compare-players	Read a valuation honestly: value vs 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
follow-matches-and-tables	Scores, match centres, fixtures and tables — UTC dates, local kick-off times, never an invented score
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
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.footval/footval)
glama.json                        Glama maintainers
skills/<name>/SKILL.md            one workflow each
assets/                           logo, plugin icons and README screenshots

Links

• FootVal: https://footval.com/
• MCP setup page with a live demo: https://footval.com/en/mcp
• How the model works: https://footval.com/en/about
• Privacy: https://footval.com/en/privacy
• Terms: https://footval.com/en/terms
• Help & support: https://footval.com/en/support · admin@footval.com
• Official MCP Registry: com.footval/footval
• Security reports: SECURITY.md
• X: @footval_en

About this repository

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