MCP Integration

Use AI agents like Cursor, Windsurf, and Claude Desktop to interact with SportsAPI Pro using natural language

What is MCP?

Model Context Protocol (MCP) is an open protocol that enables AI assistants to interact with external tools and data sources. With our MCP integration, you can ask your AI coding assistant questions like:

“Get the current Premier League standings”

And it will automatically call the correct SportsAPI Pro endpoint with the right parameters!

Supported AI Clients

Our MCP server works with any MCP-compatible AI client:

Client	Support
Cursor	✅ Full support
Windsurf	✅ Full support
Claude Desktop	✅ Full support
VS Code + Continue	✅ Full support
Any MCP client	✅ Full support

Supported Sports

All 25 sports are supported using the V2 Enhanced API by default. All shared tools accept an optional sport parameter (defaults to 'football').

Category	Sports
Major Sports	Football, Basketball, Tennis, Hockey, Cricket, Baseball
Team Sports	American Football, Rugby, Handball, Volleyball, Beach Volleyball, Water Polo, Aussie Rules
Combat & Motorsport	MMA, Motorsport, Cycling
Racquet & Cue	Table Tennis, Badminton, Snooker, Darts
Indoor & Ice	Futsal, Minifootball, Floorball, Bandy, Esports

All tools route through the V2 Enhanced API:

• https://v2.{sport}.sportsapipro.com

A small number of sport-specific tools (e.g. get_player_stats, get_transfers) still use the legacy V1 API internally for football and basketball. No action is needed from users — the MCP server handles routing automatically.

Quick Setup

Step 1: Get Your API Key

1. Sign up at sportsapipro.com
2. Go to your Dashboard
3. Copy your API key

Step 2: Configure Your AI Client

Add the following to your AI client’s MCP configuration:

Cursor Claude Desktop

{
  "mcpServers": {
    "SportsApiPro": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.sportsapipro.com/mcp?sportsapiproApiKey=YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with your actual API key.

Configuration File Locations

Client	Config File Path
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Claude Desktop (Mac)	~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows)	%APPDATA%\Claude\claude_desktop_config.json
VS Code + Continue	.continue/config.json in your project

Available Tools

Once connected, your AI assistant can use 45+ tools organized into categories. All shared tools use the V2 Enhanced API for richer, more detailed data:

Documentation & Code Generation Tools

These tools help AI agents understand the API and generate code:

Tool	Description	Example Query
get_api_documentation	Get complete docs for any endpoint	”How do I use the results endpoint?”
get_code_template	Get React/TypeScript code templates	”Give me code for a results page”
get_image_url_pattern	Get image URL construction patterns	”How do I show team logos?”
get_full_api_reference	Get all endpoints summary	”What endpoints are available?”

Shared Tools (All Sports — V2 Enhanced API)

These tools work across all 25 sports using the V2 Enhanced API via the sport parameter:

Tool	Description	Example Query
get_live_scores	Get currently live matches	”What games are happening now?”
get_fixtures	Get upcoming matches	”Show me tomorrow’s Premier League games”
get_results	Get completed match results	”What were yesterday’s La Liga results?”
get_standings	Get league tables	”Show me the Serie A standings”
get_match_details	Get full match info	”Get details for game ID 12345”
get_game_stats	Get detailed match statistics	”Show me the box score for game 12345”
get_game_commentary	Get play-by-play commentary	”Get the live commentary for Liverpool vs Arsenal”
get_game_highlights	Get video highlights	”Show me Man City’s recent video highlights”
get_game_predictions	Get match predictions	”What are the predictions for this match?”
get_related_games	Get suggested games	”What games are similar to this match?”
get_head_to_head	Get H2H history	”Liverpool vs Man United head to head”
search	Search teams/players/competitions	”Find Manchester United’s team ID”
get_betting_odds	Get betting lines	”What are the odds for the Lakers game?”
get_betting_trends	Get betting trends	”What are the betting trends for today?”
get_outright_odds	Get futures/outrights	”Who’s the favorite to win the Premier League?”
get_teaser_bets	Get teaser bet lines	”Get teaser bets for game 12345”
get_account_status	Check API usage	”How many API calls have I made today?”
get_competitions	List available leagues	”Show me all available football leagues”
get_featured_competitions	Get featured/popular leagues	”What are the top football leagues?”
get_competition_details	Get competition metadata	”Get details for the Premier League”
get_competitor_details	Get team statistics	”Get Arsenal’s detailed stats”
get_team_form	Get team’s recent form	”How is Liverpool performing lately?”
get_top_teams	Get popular teams	”Show me the most popular teams”
get_tournament_brackets	Get knockout brackets	”Show me the EFL Cup bracket for Man City”
get_athlete_lineups	Get match lineups	”Show me the starting lineups for game 12345”
get_related_entities	Get related entities	”What’s related to the Premier League?”
get_news	Get latest sports news	”Get latest Premier League news”
get_countries	List countries with leagues	”What countries have football leagues?”
get_sports	List available sports	”What sports does the API support?”
get_common_ids	Get reference IDs	”Show me common team and league IDs”
get_supported_sports	List all 25 supported sports	”What sports does SportsAPI Pro support?”

Football-Specific Tools (Legacy V1)

Tool	Description	Example Query
get_player_stats	Get player statistics	”Show me Haaland’s stats this season”
get_player_next_game	Get player’s next match	”When does Salah play next?”
get_player_games	Get player’s match history	”Get Haaland’s last 10 games with stats”
get_player_chart_events	Get player events for charts	”Show me Salah’s goal timeline”
get_transfers	Get transfer news	”Show me latest transfer news”
get_top_athletes	Get top-rated players	”Who are the top rated players?”
get_team_squad	Get team roster	”Show me Liverpool’s squad”

Basketball-Specific Tools (Legacy V1)

Tool	Description	Example Query
get_player_props	Get player prop bets	”Get player props for tonight’s Lakers game”
get_predictions	Get AI predictions	”Predict the Celtics vs Heat game”

The v2_get_live_matches, v2_get_today_matches, and v2_search tools have been merged into the shared tools above (get_live_scores, get_fixtures, search). The v2_get_match_details and v2_get_standings tools remain available for V2-specific parameter options (e.g. requesting lineups, incidents, shotmap in a single call).

Historical Data Tools

Tool	Description	Example Query
get_historical_seasons	Discover available seasons	”What seasons are available for La Liga?”
get_season_results	Get a specific season’s data	”Get the 2022-23 Premier League standings”

Common Entity IDs

The AI agent has access to a resource with common IDs. Here are some frequently used ones:

Football Competitions

Competition	ID
Premier League	7
La Liga	8
Serie A	17
Bundesliga	35
Ligue 1	24
Champions League	572
Europa League	573
World Cup	16

Basketball Competitions

Competition	ID
NBA	132
WNBA	2004
EuroLeague	138
NCAA Men’s	2065

Tennis Competitions

Competition	ID
ATP Tour	225
WTA Tour	226
Australian Open	227
French Open	228
Wimbledon	229
US Open	230

Hockey Competitions

Competition	ID
NHL	207
KHL	208
SHL (Sweden)	209
Liiga (Finland)	210

You don’t need to memorize IDs! Just ask the AI to search for a team or competition by name, and it will find the ID for you.

Example Conversations

Get Live Scores

You: “What Premier League games are on right now?”

AI: Uses get_live_scores tool with sport=“football”, competition_id=7

{
  "games": [
    {
      "id": 4521234,
      "homeCompetitor": { "name": "Liverpool", "score": 2 },
      "awayCompetitor": { "name": "Arsenal", "score": 1 },
      "gameTime": 67,
      "statusText": "2nd Half"
    }
  ]
}

Get NHL Standings

You: “Show me the current NHL standings”

AI: Uses get_standings tool with sport=“hockey”, competition_id=207

Get Tennis Live Scores

You: “Any tennis matches happening right now?”

AI: Uses get_live_scores tool with sport=“tennis”

Get Match Lineups

You: “Show me the starting lineups for match 12345”

AI: Uses get_athlete_lineups tool with game_id=12345

Get Player Match History

You: “Get Haaland’s last 10 games with stats”

AI: Uses get_player_games tool with athlete_id=934235 and num_of_games=10

Get Standings

You: “Show me who’s top of La Liga”

AI: Uses get_standings tool with competition_id=8

Find a Team ID

You: “What’s Real Madrid’s team ID?”

AI: Uses search tool with query=“Real Madrid”

Response: “Real Madrid’s team ID is 86”

Check Your Usage

You: “How many API calls do I have left today?”

AI: Uses get_account_status tool

Response: “You’ve used 245 of your 7,500 daily requests. 7,255 remaining.”

Code Generation Examples

The MCP server includes documentation and code templates that enable AI agents to generate production-ready code.

Build a Results Page

You: “Create a page showing yesterday’s UEFA Champions League results with team logos”

AI workflow:

1. Uses get_api_documentation to learn about the results endpoint (V2 Enhanced API)
2. Uses get_common_ids to find Champions League ID (572)
3. Uses get_image_url_pattern to understand image URLs
4. Uses get_code_template with template_name=“results-page”
5. Generates customized React component with date filtering

Available Code Templates

Template	Description
results-page	Match results with team logos, date filtering, pagination
standings-table	League table with team logos and full stats
live-scores	Real-time live scores with auto-refresh
match-card	Single match card for any status
fixtures-list	Upcoming fixtures grouped by date
api-hook	Reusable React hook for any endpoint

Ask the AI to combine templates or customize them for your specific needs. For example: “Take the results-page template and add a competition selector dropdown.”

Rate Limits

MCP tool calls count against your normal API quota:

Plan	Daily Limit
Free	100
Pro	7,500
Ultra	75,000
Mega	150,000

Each tool call counts as one API request. Complex queries may result in multiple tool calls. Documentation and template tools (get_api_documentation, get_code_template, get_image_url_pattern) do NOT count against your quota.

Testing with MCP Inspector

You can test your MCP connection using the official MCP Inspector:

npx @modelcontextprotocol/inspector

Enter your MCP URL: https://mcp.sportsapipro.com/mcp?sportsapiproApiKey=YOUR_API_KEY

Troubleshooting

”Invalid API key” Error

• Verify your API key is correct
• Check that your API key is active in the Dashboard
• Ensure there are no extra spaces in the URL

”Missing API key” Error

Make sure you include the sportsapiproApiKey query parameter in the URL:

https://mcp.sportsapipro.com/mcp?sportsapiproApiKey=YOUR_KEY

Connection Timeout

• Check your internet connection
• Verify the MCP server is accessible: visit https://mcp.sportsapipro.com/health
• Try restarting your AI client

Tool Not Found

Make sure you’re using the correct tool name. The AI should automatically discover available tools, but you can ask:

“What SportsAPI Pro tools are available?”

Security

• Your API key is passed via query parameter (required for MCP remote protocol)
• All requests are made over HTTPS
• API keys can be regenerated in your Dashboard if compromised
• Consider using IP restrictions in your account settings for additional security

Need Help?

• Documentation: docs.sportsapipro.com
• Support: [e-mail]
• Dashboard: sportsapipro.com/dashboard