FootVal

FootVal MCP server

What is every footballer really worth? Ask your assistant.

Independent player valuations with the reasons behind them, daily match predictions with a public track record, 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 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 *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

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.

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

16 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

Leagues, clubs, national teams

Matches

Predictions

Statistics & transfers

| get_stat_leaders | Season leaderboards — goals, assists, goals + assists, minutes, appearances — per competition, across national-team competitions, or across all competitions combin