Auth and quotas

Tiers (summary)

Tier	ask_study_assistant (MCP)	search_scout	Other notes
Anonymous	Blocked (AUTH_REQUIRED_FOR_AI)	3 / IP / calendar month	Lessons + Scout list/get are unmetered
Signed-in (member)	9 / month with Bearer	9 / month	Same free read tools
Exam Academy (€169)	Unlimited	Unlimited	Unlocks generate_mock_exam only (exam product)
Agent Pro (€420/year)	Unlimited	Unlimited	Market MCP + Cases + watch lists + dossiers (Exam Academy features included)

Web vs MCP Study Assistant

The website chat still allows a small visitor Study Assistant allowance. The remote MCP ask_study_assistant tool always requires a Bearer token.

Call get_account_status (study) and get_scout_usage (Scout search) to show remaining quota. Reset is per calendar month (UTC).

Scout read tools — list_scout_articles, get_scout_article, list_scout_players, get_scout_player — are unmetered for everyone. Only search_scout is search-quota gated.

Generating a fam_live_ key

1. In app: Account → MCP keys (paid accounts only; max 10 active keys).
2. Operator (repo): with ADMIN_WORKER_SECRET and a premium profile email, npm run mcp:mint (see Ops and the fifa-mcp-server skill).

Use: Authorization: Bearer fam_live_… on every POST https://fifa.qtech.hr/mcp call that should run as that account.

Premium agent-tool key caps

Default fam_live_ limits for paid market / orchestration tools (UTC windows):

• 150 calls / day
• 2000 calls / month

Overrides may exist per key in mcp_api_keys. Usage is audited via agent_interactions.

Paid-only surfaces

Require a paid tier bearer or session:

• Cases Workspace — all 11 Cases MCP tools (see Cases tools →).
• Market / dossier tools — research_player, orchestrate_transfer_dossier, market pulse, etc. (see Paid market tools →).
• Mock exam generator — generate_mock_exam.

OAuth / OpenID (discovery)

• OpenID configuration
• Protected resource

Next steps: MCP endpoint → · Remote connectors →