Use SportDB with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Access live scores, standings, fixtures, and player data across football, basketball, hockey, and tennis from any AI agent.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 18 capabilities
The complete SportDB capability set.
These are the exact actions your AI can choose when you ask it to work with SportDB.
01-04
4 capabilities in this set.
Part of 18 available through SportDB.
- 01
Get country competitions
G., "england", "spain", "germany"), returns all competitions available in that country. The response includes competition slugs needed to drill deeper into seasons and standings. List competitions (leagues/cups) available in a specific country for a sport
- 02
Get match
Use the match_id obtained from fixtures or live results. Get detailed information for a specific match by its ID
- 03
Get match stats
Requires a valid match_id. Get in-match statistics for a specific match
- 04
Get player profile
Requires the numeric player ID obtained from search results. Get the full profile of a player by their ID
05-08
4 capabilities in this set.
Part of 18 available through SportDB.
- 05
Get player stats
Requires the numeric player ID. Get career and seasonal statistics for a specific player
- 06
Get player transfers
Requires the numeric player ID. Get the complete transfer history of a specific player
- 07
Get live basketball
Use this when the user asks about ongoing basketball games or live NBA/EuroLeague results. Get live basketball match scores happening right now
- 08
Get live football
Use this when the user asks about ongoing football games, current scores, or live results. Get live football (soccer) match scores happening right now
09-12
4 capabilities in this set.
Part of 18 available through SportDB.
- 09
Get live hockey
Use this when the user asks about ongoing hockey games or live NHL/KHL results. Get live ice hockey match scores happening right now
- 10
Search clubs
Returns a list of matching clubs with their IDs and basic metadata. Use this to find a club ID before requesting its profile or player roster. Search for clubs/teams by name keyword
- 11
Get club players
Requires the numeric club ID. List all players currently registered to a specific club
- 12
Get club profile
Requires the numeric club ID obtained from search results. Get the full profile of a club by its ID
13-15
3 capabilities in this set.
Part of 18 available through SportDB.
- 13
Get competition seasons
G., "premier-league"), returns all available seasons. Use this to find the season identifier needed for standings and fixtures queries. List available seasons for a specific competition
- 14
Get fixtures
Includes dates, teams, scores for completed matches, and upcoming schedule. Requires sport, country_slug, competition_slug, and season. Get scheduled and completed match fixtures for a season
- 15
Get match lineups
Returns player names and positions for each side. Get starting lineups and substitutions for a specific match
16-18
3 capabilities in this set.
Part of 18 available through SportDB.
- 16
Get standings
Requires sport, country_slug, competition_slug, and season (e.g., "2024-2025"). This is the primary capability for answering "who is top of the league" questions. Get league table standings for a specific season of a competition
- 17
List countries
The sport parameter should be a slug like "football", "basketball", "hockey", or "tennis". Use this as the starting point to navigate the competition hierarchy. List all countries available for a given sport
- 18
Search players
Returns matching players with their IDs and basic profile data. Use this to find a player ID before requesting their detailed profile, statistics, or transfer history. Search for players by name keyword
Observed, not estimated
941ms average. Fast in production.
SportDB is checked daily against the live service.
- Fastest day
- 772ms
- Slowest day
- 1187ms
- 14-day trend
- Slowing+8%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 18 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of SportDB, so you can see the experience inside your AI.
It does not authenticate your account with SportDB. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
SportDB Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_uW9mHK2ANcNnadcHX4Cr2mVi2FcxdTIlIFMiVxxk/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — SportDB capabilities are ready to use.
{
"mcpServers": {
"sportdb-mcp": {
"url": "https://edge.vinkius.com/vk_preview_uW9mHK2ANcNnadcHX4Cr2mVi2FcxdTIlIFMiVxxk/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions SportDB owners ask.
- 01
Can my AI agent show me live football scores while I work?
Yes! Simply ask your agent to run the get_live_football capability and it will instantly retrieve all ongoing matches with real-time scores, minute markers, and status updates. You can also use get_live_basketball or get_live_hockey for other sports.
- 02
How do I find the Premier League standings for the current season?
Navigate the hierarchy: first use list_countries with sport 'football', then get_country_competitions for 'england', then get_competition_seasons for 'premier-league', and finally get_standings with the season slug. Your agent can chain these steps automatically from a simple question like 'Show me the Premier League table'.
- 03
Can the integration modify any data on SportDB, or is it strictly read-only?
All 18 capabilities are strictly read-only query operations. The integration cannot create, update, or delete any data on SportDB. Your API key is used solely for authenticated reads, ensuring your account remains safe from any destructive operations.
Explore
More in Data Analytics
MySportsFeeds AI Connector
Access real-time and historical sports data for NFL, MLB, NBA, NHL, and more—get standings, player stats, and
ViewNHL AI Connector
Access real-time NHL scores, schedules, standings, and player statistics directly from your AI agent.
ViewOpenDota AI Connector
Explore Dota 2 match data, player stats, heroes, teams and leagues — no API key required for basic access.
ViewAirLabs AI Connector
Access global aviation data via AirLabs — track real-time flights, search airports and airlines, check schedul
View
Suggestions
TVMaze AI Connector
Search TV shows, get episode guides, browse schedules, discover cast and crew — no API key required.
ViewAviationStack AI Connector
Real-time flight tracking and global aviation data — monitor flights, routes, airports, and airline schedules
ViewVSPN Esports DB AI Connector
Automate esports intelligence via VSPN — fetch live tournament brackets, deep player telemetry, and team roste
ViewFlightAware AI Connector
Track global flight status via FlightAware AeroAPI — search flights, monitor airport arrivals and departures,
View
