Model Context Protocol

ScoutWizz AI Connector

Ask your AI assistant about players, statistics and your own scouting reports. The connector gives Claude, ChatGPT, Cursor and your own agents secure, read-mostly access to ScoutWizz — within the permissions you grant.

Connector URL

https://mcp.scoutwizz.com/mcp

Connect

Claude, ChatGPT and other apps with connectors

Open the app's connector settings and add a custom connector.
Paste the connector URL above.
Sign in with your ScoutWizz account (or an API key you were given) and allow access.

Claude Code, Cursor, Claude Desktop and your own agents

These connect with an API key. Organization admins create keys in the ScoutWizz app under AI connector → API keys.

Claude Code

claude mcp add --transport http scoutwizz https://mcp.scoutwizz.com/mcp \
  --header "Authorization: Bearer sw_live_…"

Cursor / Claude Desktop (config)

{
  "mcpServers": {
    "scoutwizz": {
      "type": "http",
      "url": "https://mcp.scoutwizz.com/mcp",
      "headers": { "Authorization": "Bearer sw_live_…" }
    }
  }
}

Any HTTP client

curl https://mcp.scoutwizz.com/mcp \
  -H "Authorization: Bearer sw_live_…" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

What you can ask

“Find left backs under 21 in the Croatian league with at least 3 assists this season.”
“Who are younger, cheaper centre-backs with a similar profile to Domagoj Vida?”
“Rank U23 strikers in the Eredivisie by expected goals per 90.”
“Summarize what our scouts wrote about this player and compare it with the ScoutWizz consensus.”

Tools

Your AI app only sees the tools your permissions allow. Organization tools (reports, notes) are available to ScoutWizz organizations only.

Tool	Permission	What it does
search_players	players:read	Find players by name or by position, age, market value, league, season and stat ranges.
get_player_profile	players:read	Bio, current club, transfers, season history and the ScoutWizz scouting score.
search_teams	players:read	Find clubs and national teams by name.
get_team_squad	players:read	Current squad with positions, ages, market values and contract end dates.
search_leagues	players:read	Find competitions by name or country, with recent seasons.
get_player_stats	stats:read	Season statistics per competition: totals, per-90 values and percentiles.
compare_players	stats:read	Side-by-side comparison of 2–5 players.
find_similar_players	stats:read	Players with the closest statistical profile — filters for league, age and value.
rank_players	stats:read	Leaderboards for any statistic in a season, per 90 or in total.
list_stat_definitions	stats:read	All available statistic codes and what they mean.
get_consensus_report	consensus:read	Anonymized ScoutWizz consensus on a player from many clubs' reports.
list_reports	reports:read	Your organization's scouting reports.
get_report	reports:read	One full scouting report: ratings, scores, potential and the scout's comment.
list_notes	notes:read	Your private notes on players.
save_note	notes:write	Create or update your private note on a player.

Security and privacy

Sign-in uses OAuth 2.1 with PKCE; API keys are shown once and stored only as hashes. Every connection and key can be revoked instantly by your organization admin.
Each organization sees only its own reports and notes. Access always follows the signed-in user's membership and your subscription.
Consensus reports are anonymized aggregates: they exist only when at least three different clubs reported on a player, and never reveal clubs, scouts, counts or wording. Organizations decide whether their published reports contribute.
Text written by users (report comments, notes) is marked as untrusted data for the AI, so it is not followed as instructions.
Requests are rate limited and counted against a monthly quota. Your AI provider processes the answers it receives under your agreement with that provider.

Availability

The AI connector is included in the Club Pro plan and can be added to other plans. Clubs, agencies and data partners without a ScoutWizz organization can get an API account — contact us at support@scoutwizz.com.