Scout tools

Tool	Auth	Quota / notes
list_scout_articles	none	Unmetered — limit 1–50, offset, optional tag.
get_scout_article	none	Unmetered — by slug, full body + sources + embedded player.
list_scout_players	none	Unmetered — limit 1–100, position, nationality, young_only.
get_scout_player	none	Unmetered — by slug, stats, events, articles — deep dive →.
search_scout	optional	3 / 9 / unlimited per month — semantic + keyword, AI answer with citations.
get_scout_usage	optional	Quota readback for search; safe to call before search_scout.
refresh_scout_player	admin	Re-research + diff; returns refreshed, events, stats, changedFields.

Background jobs (not MCP tools, but they explain freshness): daily 06:30 UTC article + touch-ups; weekly deep refresh Sunday 03:00 UTC (and related cron windows — see ops).

Input schema highlights

list_scout_articles

• limit (1–50, default 20), offset (≥0), tag (string, case-sensitive if used).

get_scout_article / get_scout_player / refresh_scout_player

• slug (string) — for players, e.g. lamine-yamal-2007 (examples →).

search_scout

Field	Type	Required
query	string, 3–300 chars	yes
limit	integer 1–12	no (default 6)

list_scout_players

• limit (1–100, default 30)
• position — case-insensitive substring, e.g. midfielder
• nationality — e.g. Spain, Croatia
• young_only — boolean (U23-style flag when the profile is tagged young)

Next — Premium market tools → · Scout user guide →