Growing Discord community — direct access to the developer, live coverage & picks. Join now →
FREE · OAUTH 2.1 · CLAUDE / CHATGPT READY

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.

MCP server URL:
https://sports.bzzoiro.com/mcp

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)

  1. Open Claude → Settings → Connectors
  2. Click Add custom connector
  3. Paste: https://sports.bzzoiro.com/mcp
  4. Click Connect → log in → Approve

Easiest · OAuth 2.1, no config files needed.

ChatGPT OpenAI ChatGPT (Pro/Team/Enterprise)

  1. Go to Settings → Connectors → Custom
  2. Add MCP server with URL https://sports.bzzoiro.com/mcp
  3. Authenticate when prompted
  4. 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

ToolDescriptionExample prompt
Matches
search_matchesFind matches by team/league/date/status"What matches is Real Madrid playing this week?"
get_match_detailEverything about one match"Tell me everything about Atlético vs Barça"
get_match_lineupsConfirmed or AI-predicted starting XI"Who's starting for Liverpool tonight?"
get_match_incidentsGoals, cards, subs, VAR minute-by-minute"Show all incidents from El Clásico"
get_match_shotmapPer-shot xG with pitch coordinates"Plot all shots from the City game"
get_live_scoresAll live matches right now"Show me all live football scores"
Teams
search_teamsFind teams by country or league"List all teams in Serie A"
get_team_detailTeam profile + current coach"Tell me about Bayern Munich"
get_team_fixturesUpcoming and recent matches"Next 5 PSG fixtures"
get_team_squadFull team squad"Who are all the Arsenal players?"
Players
search_playersFind players by name/team/nationality"Find Brazilian forwards in Serie A"
get_player_detailProfile, market value, transfers"Player profile for Lamine Yamal"
get_player_statsPer-match stats: goals, xG, passes, rating"Bellingham's stats this season"
Leagues & predictions
list_leagues34 covered leagues"Which leagues do you cover?"
get_standingsLeague table with xG and form"Show La Liga standings with xG"
get_predictionsCatBoost ML for 8 markets"Predictions for tomorrow's PL games"
Odds (22+ bookmakers + Polymarket)
compare_oddsAll bookmaker odds for a match"Compare odds for Liverpool vs Arsenal"
get_best_oddsBest price per market across books"Best Over 2.5 odds this weekend"
list_bookmakersAll supported bookmakers"Which bookmakers do you cover?"
get_polymarket_oddsPrediction market prices"What does Polymarket say?"
Managers
search_managersFind coaches by profile/style/team"All attacking managers in the PL"
get_manager_detailTactical fingerprint and career"Pep Guardiola's tactical profile"

Example conversation

You
Who's playing in the Champions League today and what does your model predict?
Claude (with BSD)

[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