AltSportsLeagues MCP Server

MCP-compatible server for the AltSportsLeagues platform — league discovery, valuation, market intelligence, fingerprinting, onboarding pipeline visibility, and time-series market data for AI agents and sportsbooks.

Quick Start

# Install
pip install altsportsleagues-mcp

# Run (stdio)
ALTSPORTSLEAGUES_API_KEY=your_key altsportsleagues-mcp

# Run (HTTP/SSE)
ALTSPORTSLEAGUES_API_KEY=your_key altsportsleagues-mcp --sse --port 8080

Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "altsportsleagues": {
      "command": "altsportsleagues-mcp",
      "env": {
        "ALTSPORTSLEAGUES_API_KEY": "your_api_key",
        "SUPABASE_SERVICE_ROLE_KEY": "your_supabase_key"
      }
    }
  }
}

Connect to Cursor

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "altsportsleagues": {
      "command": "altsportsleagues-mcp",
      "env": {
        "ALTSPORTSLEAGUES_API_KEY": "your_api_key",
        "SUPABASE_SERVICE_ROLE_KEY": "your_supabase_key"
      }
    }
  }
}

Connect to OpenClaw

mcp:
  servers:
    altsportsleagues:
      command: altsportsleagues-mcp
      env:
        ALTSPORTSLEAGUES_API_KEY: your_api_key
        SUPABASE_SERVICE_ROLE_KEY: your_supabase_key

Installation via npm

npx altsportsleagues-mcp

Environment Variables

Variable	Required	Description
ALTSPORTSLEAGUES_API_KEY	Yes	Your AltSportsLeagues API key
API_BASE_URL	No	Override API base URL (default: https://api.altsportsleagues.ai)
SUPABASE_URL	No	Supabase project URL (for context tools)
SUPABASE_SERVICE_ROLE_KEY	No	Supabase service role key (for context tools)

Tools (36)

Discovery (6)

Tool	Description
discover_leagues	AI-powered search for alternative sports leagues
research_league	Deep-research a specific league
list_discovered_leagues	List all previously discovered leagues
get_market_opportunities	Identify underserved market opportunities
get_discovery_stats	Aggregate discovery pipeline statistics
get_trending_discoveries	Trending sports and regions

Valuation (4)

Tool	Description
evaluate_league	Multi-dimensional league evaluation and tier assignment
get_tier_definitions	Tier classification system definitions
score_partnership	Score a potential partnership opportunity
get_qualification_matrix	Qualification decision matrix

Fingerprinting (4)

Tool	Description
generate_fingerprint	Generate a unique DNA profile for a league
get_fingerprint	Retrieve an existing fingerprint profile
search_similar_leagues	Find leagues with similar profiles
check_fingerprint_quality	Check fingerprint quality and completeness

Onboarding Pipeline (4)

Tool	Description
get_questionnaire_status	Questionnaire processing status
get_onboarding_progress	League onboarding pipeline progress
get_pipeline_overview	Full pipeline stage-by-stage breakdown
get_onboarding_stats	Aggregate onboarding statistics

Assessment (7)

Tool	Description
generate_readiness_report	Full readiness report with composite score
classify_sport_archetype	Classify into 5 canonical archetypes
identify_edge_cases	Sport-specific edge cases for betting markets
detect_trading_anomalies	Trading anomaly and integrity risk detection
rank_league_maturity	Maturity and production readiness ranking
get_kb_catalog_alignment	Schema alignment check against ASD canonical schema
assess_league_readiness	5-dimension readiness assessment via Supabase

Context (5)

Tool	Description
get_league_context	Complete intelligence context assembly
compare_leagues	Side-by-side multi-league comparison
query_leagues	Flexible league search with filters
get_league_documents	All uploaded documents for a league
get_data_coverage	Scraped-vs-verified field coverage analysis

Market Data / Time-Series (5)

Tool	Description
get_league_snapshots	Historical valuation snapshots
get_league_quarterly_report	SEC 10-Q style quarterly report
get_league_momentum	Top movers and decliners
get_league_index	Aggregate market index
compare_league_trajectories	Head-to-head trajectory comparison

License

MIT