FootVal

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

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. 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:

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 marketplacemcp.json                          the hosted server, for Agent Plugins hosts (Codex, ChatGPT).mcp.json                         the hosted server, for Claude Codegemini-extension.json             Gemini CLI extension (server + skills, OAuth sign-in)server.json                       official MCP Registry manifest (com.footval/footval)glama.json                        Glama maintainersskills/<name>/SKILL.md            one workflow eachassets/                           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 · [email protected]
• 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.