Player slugs and search

Slug format

Slugs are URL-safe, usually name + birth year, e.g. lamine-yamal-2007, josko-gvardiol-2002. They are stable keys — use get_scout_player with the slug once you have it.

Discover slugs (no search quota):

• list_scout_players with position / nationality / young_only filters
• list_scout_articles to see recent slug values on articles, then get_scout_article

Text discovery (quota):

• search_scout with a natural language query; subject to the 3 / 9 / unlimited monthly cap for search.

Before a search-heavy UX: call get_scout_usage to show a “N questions left in June”-style message.

Example comparison query for MCP: “U21 full-backs with high defensive radar and top-five league minutes” — the answer lists cited chunk hits; always cross-check a player in get_scout_player for the ground truth row.

Next — Profiles and radars →