Bring Live Scores
to OpenAI Agents SDK
Create your Vinkius account to connect SportDB to OpenAI Agents SDK and start using all 18 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
GDPR Free for SubscribersCompatible with every major AI agent and IDE
Gemini
What is the SportDB MCP Server?
Turn your AI agent into a dedicated sports analyst with SportDB. Query real-time match data, historical league tables, and deep player intelligence across multiple sports — all through natural conversation.
What you can do
- Live Match Tracking — Retrieve real-time scores for football, basketball, hockey, and tennis as they happen
- League Standings — Fetch full league tables with points, wins, draws, losses, and goal difference for any season
- Fixture Schedules — Browse completed and upcoming matches for specific leagues and seasons
- Match Deep Dive — Inspect individual matches with lineups, formations, substitutions, and in-game statistics
- Club Intelligence — Search for clubs, view profiles with stadium information, and retrieve current squad rosters
- Player Analytics — Search players, view career profiles, seasonal statistics, and complete transfer histories
How it works
- Subscribe to this server
- Enter your SportDB API Key from the SportDB Dashboard
- Start querying sports data from Claude, Cursor, or any MCP-compatible client
Your agent navigates the entire competition hierarchy — from country to league to season to match — so you never have to dig through sports websites manually.
Who is this for?
- Sports Analysts & Journalists — instantly pull live scores, standings, and player stats to enrich reporting
- Fantasy League Managers — monitor player form, transfer activity, and team performance from your workspace
- Developers & Data Engineers — integrate professional-grade multi-sport data into AI-powered applications
Built-in capabilities (18)
Requires the numeric club ID. List all players currently registered to a specific club
Requires the numeric club ID obtained from search results. Get the full profile of a club by its ID
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
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
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
Use this when the user asks about ongoing basketball games or live NBA/EuroLeague results. Get live basketball match scores happening right now
Use this when the user asks about ongoing football games, current scores, or live results. Get live football (soccer) match scores happening right now
Use this when the user asks about ongoing hockey games or live NHL/KHL results. Get live ice hockey match scores happening right now
Use the match_id obtained from fixtures or live results. Get detailed information for a specific match by its ID
Returns player names and positions for each side. Get starting lineups and substitutions for a specific match
Requires a valid match_id. Get in-match statistics for a specific match
Requires the numeric player ID obtained from search results. Get the full profile of a player by their ID
Requires the numeric player ID. Get career and seasonal statistics for a specific player
Requires the numeric player ID. Get the complete transfer history of a specific player
Requires sport, country_slug, competition_slug, and season (e.g., "2024-2025"). This is the primary tool for answering "who is top of the league" questions. Get league table standings for a specific season of a competition
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
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
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
Why OpenAI Agents SDK?
The OpenAI Agents SDK auto-discovers all 18 tools from SportDB through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries SportDB, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
- —
Native MCP integration via
MCPServerSse, pass the URL and the SDK auto-discovers all tools with full type safety - —
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
- —
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
- —
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
SportDB in OpenAI Agents SDK
Why run SportDB with Vinkius?
The SportDB connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 18 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.
* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.
Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect SportDB using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
SportDB and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect SportDB to OpenAI Agents SDK through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
SportDB for OpenAI Agents SDK
Every request between OpenAI Agents SDK and SportDB is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
Can my AI agent show me live football scores while I work?
Yes! Simply ask your agent to run the get_live_football tool 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.
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'.
Can the integration modify any data on SportDB, or is it strictly read-only?
All 18 tools 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.
How does the OpenAI Agents SDK connect to MCP?
Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.
Can I use multiple MCP servers in one agent?
Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.
Does the SDK support streaming responses?
Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.
MCPServerStreamableHttp not found
Ensure you have the latest version: pip install --upgrade openai-agents
Agent not calling tools
Make sure your prompt explicitly references the task the tools can help with.
Explore More MCP Servers
View all →
HTML XSS Sanitizer
1 toolsProtect your database from malicious code. Clean and sanitize user-generated HTML payloads instantly local.
2Chat
5 toolsProgrammable WhatsApp automation — send messages, manage groups, and verify numbers via AI.
ParseHub
10 toolsControl advanced cloud scraping projects via ParseHub — list targets, dispatch headless runs, trace crawler status, and fetch extracted datasets directly via AI.
Ghostfolio (Investment Tracker)
9 toolsTrack your wealth and manage investment portfolios via Ghostfolio — monitor holdings, record activities, and analyze performance through AI.