MCP Server
The Sportradar Model Context Protocol (MCP) server gives AI-powered code editors like Cursor, Windsurf, and VS Code, plus general-purpose tools like Claude Desktop, access to Sportradar API documentation, endpoint listings, and schemas.
Before You Begin
The Sportradar MCP server requires a valid Sportradar API key. If you don't already have one, you can create a free trial through the Sportradar Marketplace:
- Visit the Sportradar Marketplace and register for an account.
- Browse by sport, league, or product type and select a product to start a free 30-day trial.
- Once your trial is approved, copy your API key from your Marketplace account — you'll use it in the MCP client configuration below.
What is MCP?
Model Context Protocol (MCP) is an open standard that allows AI applications to securely access external data sources and tools. The Sportradar MCP server provides AI agents with:
- Documentation access for Sportradar APIs
- Endpoint listing and search across available specs
- Request body, response schema, and security schema details to help build correct calls
- Code snippet generation for calling Sportradar endpoints
The MCP server returns documentation and schema information only. It does not proxy live API calls or return account data — your AI tool uses what it returns to help you build and verify your own requests.
MCP Server Setup
All Sportradar MCP tools are hosted at the same endpoint: https://developer.sportradar.com/mcp.
Configure your AI development tools to connect to this server. Your MCP client configuration may include multiple named profiles, each representing a different tool namespace.
For example, you can define profiles such as:
- sportradar-soccer
- sportradar-football
- sportradar-baseball
- sportradar-odds
Each profile points to the same URL, but allows you to organize and load only the tools relevant to the sport or product area you want to work with.
You can pass in your x-api-key authorization headers via query parameters, or however headers are configured in your MCP client.
Replace
YOUR_API_KEY_HEREin every example below with your Sportradar API key. Don't have one yet? See Before You Begin to register for a free Marketplace trial.
Add to~/.cursor/mcp.json:
{
"mcpServers": {
"sportradar-soccer": {
"type": "http",
"url": "https://developer.sportradar.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY_HERE"
}
}
}
}Replace sportradar-soccer with the profile for your sport or product area. See Available Server Profiles for the full list.
Add to~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"sportradar-soccer": {
"type": "http",
"url": "https://developer.sportradar.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY_HERE"
}
}
}
}Replace sportradar-soccer with the profile for your sport or product area. See Available Server Profiles for the full list.
Add toclaude_desktop_config.json:
{
"mcpServers": {
"sportradar-soccer": {
"type": "http",
"url": "https://developer.sportradar.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY_HERE"
}
}
}
}Replace sportradar-soccer with the profile for your sport or product area. See Available Server Profiles for the full list.
Add to.vscode/mcp.json:
{
"servers": {
"sportradar-soccer": {
"type": "http",
"url": "https://developer.sportradar.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY_HERE"
}
}
}
}Replace sportradar-soccer with the profile for your sport or product area. See Available Server Profiles for the full list.
Add to~/.claude/settings.json:
{
"mcpServers": {
"sportradar-soccer": {
"command": "npx",
"args": [
"mcp-remote",
"https://developer.sportradar.com/mcp?x-api-key=YOUR_API_KEY_HERE"
]
}
}
}Replace sportradar-soccer with the profile for your sport or product area. See Available Server Profiles for the full list.
Note: The Claude Code extension does not support HTTP-type MCP servers.
mcp-remoteacts as a stdio bridge to the Sportradar HTTP endpoint. Install it by runningnpm install -g mcp-remote, then confirm your path withwhich mcp-remote. After updating the config, fully restart VS Code.
Add to~/.codex/config.json:
{
"mcpServers": {
"sportradar-soccer": {
"type": "http",
"url": "https://developer.sportradar.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY_HERE"
}
}
}
}Replace sportradar-soccer with the profile for your sport or product area. See Available Server Profiles for the full list.
Note: Depending on your Codex setup, the config file may also be located at:
~/.config/codex/config.json(Linux/macOS)%APPDATA%\\codex\\config.json(Windows)
Available Server Profiles and Tools
We offer several MCP server profiles, all pointing to the same endpoint (developer.sportradar.com/mcp).
This should help your AI dev tools to focus on the intended data subset. Keep this in mind when setting up your queries. For example, use the sportradar-basketball server to search for NBA data. Below are the available profiles, and their included APIs.
MCP Server Profiles
| Server | APIs |
|---|---|
| sportradar-football | NFL API NCAA Football API Global American Football API UFL API |
| sportradar-soccer | Soccer API Soccer Extended API |
| sportradar-basketball | NBA API WNBA API NCAA Men's Basketball API NCAA Women's Basketball API Global Basketball API NBA G League API Synergy Basketball API Unrivaled API |
| sportradar-hockey | NHL API NCAA Men's Hockey API Global Ice Hockey API |
| sportradar-baseball | MLB API Global Baseball API |
| sportradar-odds | Odds Comparison Regular API Odds Comparison Prematch API Odds Comparison Futures API Odds Comparison Live Odds API Odds Comparison Player Props API Probabilities API Mapping API |
| sportradar-racing | NASCAR API Formula 1 API IndyCar API Formula E API MotoGP API Indy Lights API Rally API |
| sportradar-images-content | Images API Editorial Content API GenAI Automated Content |
| sportradar-insights | NBA Insights API NFL Insights API NHL Insights API MLB Insights API Betting Splits API |
| sportradar-tennis | Tennis API |
| sportradar-golf | Golf API |
| sportradar-handball | Handball API |
| sportradar-cricket | Cricket API |
| sportradar-rugby | Rugby API |
| sportradar-aussie-football | Aussie Rules Football API |
| sportradar-badminton | Badminton API |
| sportradar-bandy | Bandy API |
| sportradar-volleyball | Beach Volleyball API Indoor Volleyball API |
| sportradar-darts | Darts API |
| sportradar-field-hockey | Field Hockey API |
| sportradar-futsal | Futsal API |
| sportradar-mma | MMA API |
| sportradar-snooker | Snooker API |
| sportradar-squash | Squash API |
| sportradar-table-tennis | Table Tennis API |
| sportradar-more-sports | Beach Soccer API Curling API Cycling API Floorball API Olympic Medals API Pesapallo API Waterpolo API Winter Sports API |
MCP Tools
The following tools are available for each of the above profiles:
- get-code-snippet
- get-endpoint
- get-request-body
- get-response-schema
- get-server-variables
- list-endpoints
- list-security-schemas
- list-specs
- search-specs
Testing Your MCP Setup
Once configured, you can test your MCP server connection:
- Open your AI editor (Cursor, Windsurf, VS Code, etc.)
- Connect to the appropriate server
- Start a new chat with the AI assistant
- Ask about our sports data! - try our query suggestions to get started
The AI should now have access to Sportradar documentation through the MCP server.
Tips & FAQs
Query Suggestions
These are just a handful of sample questions you can ask your AI assistant. The MCP server answers them from Sportradar's API documentation, schemas, and specs — it does not fetch live data on your behalf, so use the answers to build your own calls.
- Using the sportradar-[server-profile] MCP server, which endpoint returns live scoring for [sport / API], and what fields does its response include?
- Which [sport / API] endpoint returns the latest standings, and what query parameters does it accept?
- What leagues and competitions does the [sport / API] API cover?
- Which fields does the player profile response schema include for [sport / API]?
- Generate a Python code snippet for calling the NFL Game Play-by-Play endpoint using the sportradar-football MCP server.
- Build a [coding language] script that calls the NFL standings endpoint, using the sportradar-football MCP server for the endpoint path, request parameters, and response schema.
- Which endpoints under sportradar-[server-profile] return live game statistics for [sport / API], and what fields are available?
- Which [sport / API] endpoints and fields would I use to build a playoff bracket?
- Which Images API endpoint returns MLB player headshots, and how do I call it?
DisclaimerPlease keep in mind that AI-generated responses are not curated or validated by Sportradar in any way.
We suggest using our MCP server as a building block in your integration. Always verify responses prior to using in your production environment.
Updated 4 days ago
