Football Data for AI Agents
Plug Claude, ChatGPT, or any MCP-compatible client straight into 34 leagues, live scores, ML predictions, and 22+ bookmaker odds. No code. Just one URL.
What is this?
The Model Context Protocol (MCP) lets AI assistants talk to external data sources directly. We expose Bzzoiro Sports Data as an MCP server so any compatible client can:
- Search matches, leagues, teams, players
- Pull live scores with real-time incidents
- Get ML predictions and compare odds
- Read structured football data instead of scraping HTML
Connect in 30 seconds
Claude Claude.ai (web)
- Open Claude → Settings → Connectors
- Click Add custom connector
- Paste:
https://sports.bzzoiro.com/mcp - Click Connect → log in → Approve
Easiest · OAuth 2.1, no config files needed.
ChatGPT OpenAI ChatGPT (Pro/Team/Enterprise)
- Go to Settings → Connectors → Custom
- Add MCP server with URL
https://sports.bzzoiro.com/mcp - Authenticate when prompted
- Use in any conversation by mentioning the connector
Available in ChatGPT Pro, Team, Enterprise & Edu plans.
Gemini Google Gemini CLI
Edit ~/.gemini/settings.json:
{
"mcpServers": {
"bsd": {
"httpUrl": "https://sports.bzzoiro.com/mcp"
}
}
}
First request will trigger OAuth flow in your browser.
Full step-by-step tutorial → by James DAY ONE from Discord
Cursor Cursor IDE
Open Cursor Settings → MCP and add:
{
"mcpServers": {
"bsd": {
"url": "https://sports.bzzoiro.com/mcp"
}
}
}
Or paste the URL directly via the "Add MCP server" button.
Claude Claude Desktop (config)
Edit ~/.config/Claude/claude_desktop_config.json:
{
"mcpServers": {
"bsd": {
"command": "npx",
"args": [
"mcp-remote",
"https://sports.bzzoiro.com/mcp"
]
}
}
}
Useful when you want token-based auth instead of OAuth.
Copilot VS Code (GitHub Copilot Chat)
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"bsd": {
"type": "http",
"url": "https://sports.bzzoiro.com/mcp"
}
}
}
Requires Copilot Chat with MCP support enabled.
Custom integration (raw HTTP)
Any HTTP client can hit the MCP endpoint with JSON-RPC and a Bearer token:
curl -X POST https://sports.bzzoiro.com/mcp \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
22 tools — the most complete football MCP server
| Tool | Description | Example prompt |
|---|---|---|
| Matches | ||
search_matches | Find matches by team/league/date/status | "What matches is Real Madrid playing this week?" |
get_match_detail | Everything about one match | "Tell me everything about Atlético vs Barça" |
get_match_lineups | Confirmed or AI-predicted starting XI | "Who's starting for Liverpool tonight?" |
get_match_incidents | Goals, cards, subs, VAR minute-by-minute | "Show all incidents from El Clásico" |
get_match_shotmap | Per-shot xG with pitch coordinates | "Plot all shots from the City game" |
get_live_scores | All live matches right now | "Show me all live football scores" |
| Teams | ||
search_teams | Find teams by country or league | "List all teams in Serie A" |
get_team_detail | Team profile + current coach | "Tell me about Bayern Munich" |
get_team_fixtures | Upcoming and recent matches | "Next 5 PSG fixtures" |
get_team_squad | Full team squad | "Who are all the Arsenal players?" |
| Players | ||
search_players | Find players by name/team/nationality | "Find Brazilian forwards in Serie A" |
get_player_detail | Profile, market value, transfers | "Player profile for Lamine Yamal" |
get_player_stats | Per-match stats: goals, xG, passes, rating | "Bellingham's stats this season" |
| Leagues & predictions | ||
list_leagues | 34 covered leagues | "Which leagues do you cover?" |
get_standings | League table with xG and form | "Show La Liga standings with xG" |
get_predictions | CatBoost ML for 8 markets | "Predictions for tomorrow's PL games" |
| Odds (22+ bookmakers + Polymarket) | ||
compare_odds | All bookmaker odds for a match | "Compare odds for Liverpool vs Arsenal" |
get_best_odds | Best price per market across books | "Best Over 2.5 odds this weekend" |
list_bookmakers | All supported bookmakers | "Which bookmakers do you cover?" |
get_polymarket_odds | Prediction market prices | "What does Polymarket say?" |
| Managers | ||
search_managers | Find coaches by profile/style/team | "All attacking managers in the PL" |
get_manager_detail | Tactical fingerprint and career | "Pep Guardiola's tactical profile" |
Example conversation
[calls search_matches filtered by Champions League and today's date]
[calls get_predictions for those events]
Two matches today:
· Atlético Madrid vs FC Barcelona (19:00 UTC) — Model: 38% home / 24% draw / 38% away. Predicts BTTS yes (62%), Over 2.5 (58%).
· PSG vs Bayern Munich (19:00 UTC) — Model favors PSG (45%). Expected goals: 2.6.
Security & control
OAuth 2.1 + PKCE
Industry-standard auth. Each client gets its own scope-limited access.
Read-only
All tools are read operations. Agents cannot modify your account or our data.
Revoke anytime
See and disconnect any connected app from your dashboard.
Ready to plug football data into your AI?
Free forever. No rate limits. No credit card.
Create free account View MCP server card