Connect to Claude Desktop
Add AltSportsData to Claude Desktop in 60 seconds — copy, paste, restart.
Connect to Claude Desktop
Give Claude Desktop access to live alternative sports data with a single config change.
Open Your Config File
macOS:
open ~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonIf the file doesn't exist, create it.
Add the MCP Server
Paste this into your config (merge with any existing mcpServers):
{
"mcpServers": {
"altsportsdata": {
"command": "uv",
"args": [
"run",
"--directory", "/path/to/altsportsdata-mcp",
"python", "-m", "altsportsdata_mcp.server"
],
"env": {
"ALTSPORTSDATA_API_KEY": "your_api_key"
}
}
}
}Replace /path/to/altsportsdata-mcp with the actual path where you cloned the repo, and your_api_key with your real AltSportsData API key.
If you installed via pip/uv globally, you can simplify:
{
"mcpServers": {
"altsportsdata": {
"command": "altsportsdata-mcp",
"env": {
"ALTSPORTSDATA_API_KEY": "your_api_key"
}
}
}
}Restart Claude Desktop
Quit and reopen Claude Desktop. Click the 🔧 tool icon in the chat input — you should see 29 AltSportsData tools available.
Try It
Type a natural language query:
"What WSL surfing events are happening this month? Show me the top 5 favorites for the next event."
Claude will automatically call get_events and get_favorites behind the scenes.
Troubleshooting
| Issue | Fix |
|---|---|
| No tools visible | Make sure uv is in your PATH. Try running the command manually in terminal first. |
| "API key invalid" | Double-check ALTSPORTSDATA_API_KEY in the config. |
| Server won't start | Run python -m altsportsdata_mcp.server manually to see error output. |
| Tools loading slowly | First call may take 1-2s for cold start. Subsequent calls are fast. |
What's Next?
- Tools Reference → — See what all 29 tools can do
- Claude Code → — Use in the CLI instead