# PlayCaller — Full Reference (llms-full.txt) > Complete, single-fetch reference for AI agents: every endpoint, every validated model, full pricing, and MCP tool definitions. See llms.txt for the curated index; this file inlines everything it links to. Generated 2026-07-26 by scripts/generate-llms-txt.js from docs/openapi.json (91 endpoints across 89 paths) + live model_registry + player_identities. --- ## Full Endpoint Reference ### NFL — 11 endpoints - GET /v1/nfl/teams — All 32 NFL teams (params: conference, division) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nfl/teams/{team}/roster — NFL team roster (params: team, position) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nfl/players — NFL players (params: search, position, team, limit, offset) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nfl/players/rankings — NFL draft rankings (consensus ADP) (params: position, format, limit, offset) Tier access: Growth, Pro Insights, Syndicate Alpha - GET /v1/nfl/players/{id} — NFL player profile by ID (params: id) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nfl/players/{id}/stats — Weekly game log for an NFL player (params: id, season, week, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nfl/games — NFL schedule and scores (params: season, week, status, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nfl/standings — NFL division standings (params: conference, division, season) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - POST /v1/nfl/rankings/custom — NFL custom scoring rankings (Pro Insights+) Tier access: Pro Insights, Syndicate Alpha - GET /v1/nfl/depth-chart/changes — NFL depth chart changes (Growth+) (params: since, team, position, change_type, limit) Tier access: Growth, Pro Insights, Syndicate Alpha - GET /v1/nfl/players/{id}/camp-intel — NFL camp intelligence snapshot for a player (Build+) (params: id) Tier access: Build, Growth, Pro Insights, Syndicate Alpha ### MLB — 10 endpoints - GET /v1/mlb/players — List active MLB players (params: position, team, status, search, limit, offset) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/mlb/players/{id} — Get MLB player by ID (params: id) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/mlb/players/{id}/stats — Game-by-game stats for an MLB player (params: id, date, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/mlb/teams — All 30 MLB teams Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/mlb/teams/{team}/roster — MLB team roster (params: team, position) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/mlb/games — Live and scheduled MLB games (params: date, state, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/mlb/standings — MLB division standings (params: season, division) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/mlb/scoring/leaders — MLB fantasy scoring leaders (Pro) (params: date, position, team, limit) Tier access: Pro Insights, Syndicate Alpha - GET /v1/mlb/scoring/categories — MLB rotisserie category leaders (Pro) (params: date) Tier access: Pro Insights, Syndicate Alpha - GET /v1/mlb/transactions — MLB transactions — IL moves, call-ups, DFAs (Build+) (params: startDate, endDate, type) Tier access: Build, Growth, Pro Insights, Syndicate Alpha ### NBA — 9 endpoints - GET /v1/nba/games — NBA game scores and schedule (params: date, state, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nba/standings — NBA conference standings (params: season, conference) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nba/teams — All 30 NBA teams (params: conference) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nba/players — NBA players (3,252 seeded) (params: search, position, team, limit, offset) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nba/players/{id} — NBA player profile by ID (params: id) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nba/players/{id}/stats — Game-by-game stats for an NBA player (params: id, season, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nba/teams/{team}/roster — NBA team roster (params: team, position) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nba/confidence — NBA confidence model — raw score + components (Pro Insights, AUC 0.855) (params: player) Tier access: Pro Insights, Syndicate Alpha - GET /v1/nba/players/{id}/game-log — NBA player game log (Build+) (params: id, season) Tier access: Build, Growth, Pro Insights, Syndicate Alpha ### NHL — 7 endpoints - GET /v1/nhl/games — NHL game scores and schedule (params: date, state, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nhl/standings — NHL standings by division (params: season, division) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nhl/teams — All 32 NHL teams (params: conference, division) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nhl/teams/{team}/roster — NHL team roster (params: team, position) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nhl/players — NHL player list with filters (params: search, team, position, limit, offset) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nhl/players/{id} — NHL player detail (params: id) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/nhl/players/{id}/stats — NHL player game log (params: id, season, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha ### CFB — 7 endpoints - GET /v1/cfb/games — College football scoreboard (Pro) (params: date, state, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/cfb/standings — College football conference standings (Pro) (params: season, conference) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/cfb/rankings — AP / Coaches Poll / CFP rankings (Pro) (params: season, poll, week) Tier access: Pro Insights, Syndicate Alpha - GET /v1/cfb/teams — CFB FBS team list Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/cfb/teams/{team}/roster — CFB team roster (params: team, position) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/cfb/players — CFB player list with filters (params: search, team, position, limit, offset) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/cfb/players/{id} — CFB player detail (params: id) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha ### Soccer — 6 endpoints - GET /v1/soccer/players — Soccer player list with filters (params: search, team, league, position, limit, offset) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/soccer/players/{id} — Soccer player detail (params: id) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/soccer/teams — Soccer team list (params: league) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/soccer/teams/{team}/roster — Soccer team roster (params: team, position) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/soccer/games — Soccer match scores (EPL + MLS) (params: league, date, state, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/soccer/standings — Soccer league table (EPL, MLS, La Liga, Bundesliga, Serie A, UCL) (params: league, season) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha ### Tennis — 1 endpoints - GET /v1/tennis/matches — ATP and WTA match scores (params: tour, date, state, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha ### Golf — 2 endpoints - GET /v1/golf/tournaments — Active and recent golf tournaments (params: tour, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/golf/leaderboard — Current tournament leaderboard (params: tour, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha ### UFC — 2 endpoints - GET /v1/ufc/events — UFC fight cards and bout results (params: state, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/ufc/fighters — Distinct fighters on upcoming UFC cards (params: limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha ### Intelligence — 6 endpoints - GET /intelligence/news — Live multi-sport player signals (params: severity, sport, team, position, signal_type, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /intelligence/injuries — Active injury feed (multi-sport) (params: severity, sport, team, player, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /analytics/trends — Historical performance trends (Pro) (params: sport, player_name, team, position, season, week, limit) Tier access: Pro Insights, Syndicate Alpha - GET /v1/intelligence/signals — Filterable beat reporter signal feed (Pro Insights+) (params: sport, severity, type, since, limit) Tier access: Pro Insights, Syndicate Alpha - GET /v1/model/predictions/{playerId} — ML prediction history for a player (Pro Insights+) (params: playerId, limit, season, model_type) Tier access: Pro Insights, Syndicate Alpha - GET /v1/{sport}/waiver-priority — Ranked waiver wire candidates by anomaly signal (Growth+) (params: sport, limit, position, exclude_injured) Tier access: Growth, Pro Insights, Syndicate Alpha ### Multi — 19 endpoints - GET /v1/{sport}/players/{id}/alpha — Alpha Metrics for a player (Pro Insights+) (params: sport, id) Tier access: Pro Insights, Syndicate Alpha - GET /v1/players/similar/{id} — Find players with similar stat profiles (Pro Insights+) (params: id, sport, limit) Tier access: Pro Insights, Syndicate Alpha - GET /v1/audit/events — Audit log for API key (Build+) (params: limit, before, action) Tier access: Build, Growth, Pro Insights, Syndicate Alpha - POST /v1/batch/signals — Batch player signals — confidence + alpha + projection (Pro Insights+) Tier access: Pro Insights, Syndicate Alpha - GET /v1/{sport}/odds/history/{gameId} — Odds line movement history for a game (Pro Insights+) (params: sport, gameId) Tier access: Pro Insights, Syndicate Alpha - GET /v1/{sport}/teams/{team}/roster-pulse — Team roster pulse — roster + injuries + depth changes + anomalies (Growth+) (params: sport, team) Tier access: Growth, Pro Insights, Syndicate Alpha - POST /v1/batch/players — Batch player lookup — up to 50 players in one call (Growth+) Tier access: Growth, Pro Insights, Syndicate Alpha - GET /v1/{sport}/players/{id}/news — Player news and injury signals (params: sport, id, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/{sport}/teams/{team}/injuries — Active injury report for a team (params: sport, team, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/{sport}/teams/{team}/schedule — Team game schedule (past and upcoming) (params: sport, team, status, season, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/data/status — Data freshness and coverage status Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/players/compare — Side-by-side player comparison (params: player1, player2, sport) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/events/stream — Real-time SSE event stream (Pro Insights+) (params: sport) Tier access: Pro Insights, Syndicate Alpha - GET /v1/players/search — Cross-sport player search (params: q, sport, position, limit) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/trending — Trending hashtags/topics (all tiers, including free Sandbox) (params: sport) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /v1/articles/waiver — Waiver wire articles with signal audit trail (Pro Insights) (params: sport, season, week, limit) Tier access: Pro Insights, Syndicate Alpha - GET /v1/{sport}/games/history — Raw per-game historical box lines (Pro Insights) (params: sport, player_name, season, limit) Tier access: Pro Insights, Syndicate Alpha - GET /v1/sports — Supported sports and endpoint discovery Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /api/public/stats — Platform stats (unauthenticated) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha ### Account — 8 endpoints - POST /daas/webhooks — Register a webhook endpoint (Syndicate Alpha) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /daas/webhooks — List registered webhooks (Syndicate Alpha) - DELETE /daas/webhooks/{id} — Deactivate a webhook (Syndicate Alpha) (params: id) - GET /daas/webhooks/{id}/deliveries — Webhook delivery log (Syndicate Alpha) (params: id) - GET /daas/usage — API key quota and usage breakdown Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - GET /daas/key-info — API key metadata (params: key) Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - POST /daas/trial/start — Start a 14-day free trial - POST /daas/register-key — Register an existing API key ### MCP — 3 endpoints - GET /mcp — MCP server info and tool discovery - POST /mcp — MCP JSON-RPC 2.0 endpoint Tier access: Developer Sandbox, Build, Growth, Pro Insights, Syndicate Alpha - POST /mcp/start-trial — Get a free 14-day MCP trial key instantly --- ## Validated Machine Learning Models (Full Detail) PlayCaller ships 7 AUC-validated ML models in production. Every model has a published AUC, decile lift, and a model_registry entry — no hollow scores, no unvalidated heuristics presented as intelligence. ### MLB confidence (Active, v5) - AUC-ROC: 0.625 - Decile lift: 27.0x - Endpoint: /v1/feed (Pro Insights+) ### MLB pitcher_form (Active, v1) - AUC-ROC: 0.636 - Decile lift: 2.5x - Endpoint: /v1/feed (Pro Insights+) ### NBA confidence (Active, v3) - AUC-ROC: 0.847 - Decile lift: 71.3x - Endpoint: /v1/feed (Pro Insights+) ### NBA heat (Active, v2) - AUC-ROC: 0.741 - Decile lift: 4.7x - Endpoint: /v1/feed (Pro Insights+) ### NFL confidence (Active, v1) - AUC-ROC: 0.697 - Decile lift: 4.6x - Endpoint: /v1/feed (Pro Insights+) ### NFL heat (Active, v2) - AUC-ROC: 0.623 - Decile lift: 25.6x - Endpoint: /v1/feed (Pro Insights+) ### NHL confidence (Active, v1) - AUC-ROC: 0.669 - Decile lift: 37.0x - Endpoint: /v1/feed (Pro Insights+) --- ## Player Identity Resolution 34,806+ players across 9 sports with canonical PlayCaller IDs (format: pc_{sport}_{id}). - NFL: 10,575 players - MLB: 1,327 players - NBA: 6,345 players - NHL: 1,047 players - CFB: 12,928 players - Soccer: 2,584 players NFL/MLB/NBA/NHL players normalized across ESPN, Sleeper, Yahoo, NFL.com, Rotowire, and BallDontLie platform IDs. Endpoint: GET /v1/:sport/players/:id or GET /mcp → get_player_identity tool Use: Import fantasy lineups from any platform, resolve to a single canonical ID, query intelligence against it. --- ## Semantic Player Similarity (pgvector) Available at GET /v1/players/similar/:id (Pro Insights+). - 8-dimensional stat embedding per player (avg_fp, usage, opportunity, rushing_yds, receiving_yds, consistency, momentum_norm, ceiling) - IVFFlat cosine similarity index - No LLM required — vectors are purely computed from historical_performance + alpha_metrics - Use case: trade target discovery, handcuff identification, DFS correlation stacking --- ## Alpha Metrics (Pre-computed Weekly) Available at GET /v1/:sport/players/:id/alpha for NFL, MLB, NBA, and NHL (Pro Insights+). - **Consistency Score (0-100):** Higher = more reliable floor. 100 x (1 - stddev/avg) of snap_pct or minutes_played over last 8 games. - **Momentum Delta (signed float):** Avg fantasy points last 3 games minus avg games 4-6 back. Positive = trending up. - **Opportunity Ceiling (float):** 90th-percentile target_share or usage_rate from last 8 games. --- ## MCP Server (AI Agent Integration) POST https://api.playcallerapp.com/mcp — JSON-RPC 2.0 protocol (Anthropic MCP spec 2024-11-05) Auth: X-PlayCaller-Key header Discovery: GET https://api.playcallerapp.com/mcp — returns tool list without auth ### 10 Production Tools 1. **get_injury_signals** — Active beat reporter injury and intelligence signals. Params: sport (nfl|mlb|nba|all), severity (high|medium|low|all), limit (max 50). 2. **get_player_identity** — Resolve player name or platform ID to canonical PlayCaller identity with all platform mappings. Params: name (fuzzy), sport, platform, platform_id. 3. **get_anomaly_scores** — Players with anomalous usage/performance deviation from baseline. Anomaly score 0-100; >70 is meaningful. Params: sport, min_score, limit. 4. **get_prediction_markets** — Beat reporter signals tagged as prediction market props. Params: sport, limit. 5. **get_player_projections** — Trailing 10-game fantasy point average with active injury signal overlay. Params: player_name (required), sport (required), scoring. 6. **get_player_stats** — Per-game stat history. Params: player_name (required), sport (required), season, limit. 7. **get_team_roster** — Active roster by team abbreviation. Params: team (required), sport (required), position, limit (max 100). 8. **get_games** — Scheduled, live, and final game scores across all 9 sports. Params: sport (required), date, week (NFL), status (live|final|upcoming|all), limit. 9. **get_standings** — Division and conference standings for NFL, MLB, NBA, NHL, CFB, and Soccer. Params: sport (required), conference, division. 10. **get_player_dossier** — Full consolidated player profile in one call: identity + injury status + anomaly/heat score + recent game stats. Params: player_name (required), sport (required). ### Structured Error Self-Correction - Rate limit: { error_code: "RATE_LIMIT_EXCEEDED", limit_per_minute, retry_after_seconds: 60 } - Quota exceeded: { error_code: "MONTHLY_QUOTA_EXCEEDED", quota, used, upgrade_url } - Unknown tool: { error_code: -32602, available: [list of valid tool names] } ### Claude Desktop Config ```json { "mcpServers": { "playcaller": { "command": "npx", "args": ["-y", "@playcaller/sdk", "mcp"], "env": { "PLAYCALLER_API_KEY": "pc_sbx_your_key_here" } } } } ``` --- ## Real-Time: SSE Event Stream GET /v1/events/stream (Pro Insights+). Persistent HTTP connection, 30-second heartbeat. Events: - player.injured — fires on every injury refresh cycle (every 4h); payload: { player, team, severity, signal_type, sport } - game.score_updated — fires during live game pipeline; payload: { game_id, home_team, away_team, home_score, away_score, status } - anomaly.detected — fires on anomaly refresh; payload: { player, team, anomaly_score, recommendation } ```js const source = new EventSource("https://api.playcallerapp.com/v1/events/stream", { headers: { "X-PlayCaller-Key": "pc_pri_your_key" } }); source.addEventListener("player.injured", e => console.log(JSON.parse(e.data))); ``` --- ## Webhooks (Syndicate Alpha) HMAC-SHA256 signed push delivery to any HTTPS endpoint. Every delivery includes: - X-PlayCaller-Signature: sha256= - X-PlayCaller-Delivery-Id: UUID (idempotent dedup) - X-PlayCaller-Event: event type string Retry logic: 3 attempts (immediate, 30s, 5min). Auto-deactivates + emails owner after 3 consecutive failures. --- ## SDKs ### TypeScript ``` npm install @playcaller/sdk ``` ```typescript import { PlaycallerApiClient } from "@playcaller/sdk"; const client = new PlaycallerApiClient({ apiKey: "pc_sbx_your_key" }); const injuries = await client.intelligence.getIntelligenceInjuries({ sport: "nfl" }); const alpha = await client.v1.getAlpha({ sport: "nfl", id: "pc_nfl_4046533" }); ``` ### Python ``` pip install playcaller-sdk ``` ```python from playcaller import PlaycallerApi client = PlaycallerApi(api_key="pc_sbx_your_key") injuries = client.intelligence.get_intelligence_injuries(sport="nfl") ``` --- ## Pricing (Full Detail) | Tier | Price | Cap | Endpoints | ML/SSE/Vectors | |------|-------|-----|-----------|----------------| | Developer Sandbox | $0 | 200 req/day, 20 req/min | 60 | Blocked | | Starter | $19/mo | 500 req/day (15,000/mo), 30 req/min | 60 | Blocked | | Build | $99/mo | 2,000 req/day (60,000/mo), 60 req/min | 60 | Blocked (per-sport add-ons $49/mo) | | Growth | $199/mo | 6,000 req/day (180,000/mo), 180 req/min | 69 | Blocked (per-sport add-ons or Pro Insights) | | Pro Insights | $499/mo | 20,000 req/day (600,000/mo), 300 req/min | 84 | Included, rate-capped | | Syndicate Alpha | $1,499/mo | No daily ceiling, no per-minute limit | 84 | Uncapped + webhooks + bulk export | Free sandbox at https://playcallerapp.com/developer — no credit card, no sales call, API key in 60 seconds. Syndicate Alpha is contact-only by design (mailto:api@playcallerapp.com) — no self-serve checkout for that tier. --- ## Key URLs - Developer landing: https://playcallerapp.com/developer - API docs: https://playcallerapp.com/developer/docs - OpenAPI spec (JSON): https://playcallerapp.com/openapi.json - OpenAPI spec (YAML): https://playcallerapp.com/docs/openapi.yaml - RapidAPI listing: https://rapidapi.com/teoforfootbowl/api/playcaller-data-api - Sitemap: https://playcallerapp.com/sitemap.xml - MCP endpoint: https://api.playcallerapp.com/mcp