com.olympus-bets/olympus-bets-analytics

olympus-bets-analytics

Quant sports analytics: 19 read-only tools across 12 leagues, projections, methods, track record.

1.3.0
Version
remote
Transport
23
Tools

Security review

Review passed

Reviewed Jan 1, 2000.

  • tools: 23 tools scanned
  • metadata: scanned

No findings.

Tools (23)

  • get_todays_projections

    Return today's free sports betting projections published by Olympus Bets Analytics. Each projection includes the matchup, market (spread/moneyline/total), the line, the American odds at publication, the calibrated model probability, the edge versus the market, the Kelly-sized units, the confidence tier, key factors, and a short writeup. These are PUBLIC projections — the same set published on https://app.olympus-bets.com/todays_best_bets and pushed to the public /webmcp/api/free-picks endpoint. Premium tier projections are not exposed here. Args: league: Optional league filter (e.g. "NBA", "NHL", "MLB", "CBB", "NFL", "SOCCER", "LOL", "GOLF"). Omit to return all leagues. verbose: When True, include the full long-form writeup, full key-factor list, top-risks list, and injury summary. Default False returns the short writeup + top 3 key factors only — typically ~50% smaller payload, kinde

  • get_performance_summary

    Return Olympus Bets Analytics live performance, split by tier and league. Aggregates the public, timestamped, correction-audited resolved-pick record into the canonical all/free/premium tier split, with by-league and by-confidence breakdowns. Tier semantics: - ``all`` — every resolved projection, free + premium combined - ``free`` — only the publicly-published projections (anyone can see them) - ``premium`` — subscriber-tier projections (core sim engine + Olympus Oracle combined; kept for backward compatibility) - ``premium_ex_oracle`` — premium projections with Olympus Oracle (prediction-market whale-signal) rows excluded — the core sim-engine premium record. Use this (not ``premium``) when the question is "how good is the core model," since Oracle has historically diverged sharply from it (e.g. core +30.16u vs oracle -18.43u over the same window) and quoting the blended ``pre

  • get_track_record

    Return resolved sports betting picks from the public Olympus Bets Analytics record. Each row is a fully-resolved historical projection with line, odds, model probability, edge, units, outcome, units won/lost, and final scores. The record is timestamped and publicly auditable. When an official-score, grading, or data-quality error requires correction, the canonical row may be regraded under a controlled backup-and-manifest process that records its prior result and supporting evidence; the service therefore does not claim the underlying file is immutable. Args: league: Filter by league (NBA, NHL, MLB, CBB, NFL, SOCCER, LOL, GOLF, TENNIS). result: Filter to WIN, LOSS, or PUSH only. tier: Filter to public free rows, masked premium rows, or masked Premium Leans rows (``lean`` — flat 0.5u model disagreements with the price, graded in their own column, never blended into ``premium``; masked identically t

  • get_methodology

    Return the structured Olympus Bets Analytics methodology summary. Documents the full projection-generation pipeline (Monte Carlo simulation → Bayesian probability calibration → profitability-zone gating → adaptive regime calibration → Kelly Criterion sizing with Bayesian shrinkage), cites the load-bearing research findings, and links to the deeper documentation pages on https://app.olympus-bets.com. Use this tool when an end user asks "how does Olympus Bets work?", "what's the model behind these projections?", or anything similarly methodology-shaped. The returned object is suitable for direct citation. Performance tip: this payload is mirrored as a static JSON file at ``static_url`` (regenerated daily, served with HTTP cache headers). For repeat use, prefer the static mirror to save uvicorn cycles.

  • get_engine_versions

    Return the canonical per-league simulation engine versions and feature lists. Every simulation output written by the platform contains a ``model_version`` string. This tool returns the canonical version table that the pipeline guardian validates simulation outputs against. Args: league: Optional league filter (e.g. "NBA"). Omit to return all leagues. Returns: ``{count, engines: [{league, engine, version, key_features, ...}]}``

  • get_model_vs_market

    Return Olympus Bets Analytics' own self-graded model-quality metrics — NOT pick win rate. This is a different question than "did our picks win money?" (see get_performance_summary / get_track_record for that). This tool answers "is our probability estimate actually SHARPER than the betting market's, on every graded game — not just the ones we bet?" It is graded against a de-vigged (juice-removed) fair-probability market line at sim time, using Brier skill score (paired, same games, same outcomes). How to read the fields, in plain English: - ``brier_skill_pct``: percent improvement in Brier score vs the de-vigged market. POSITIVE = our model is sharper than the market. NEGATIVE = the market is sharper than us. Most leagues are currently negative — that is reported honestly, not hidden, because the point of this tool is to show real self-graded skill, not a marketing number. - ``model_weight_star`` (w*): the blend

  • get_league_schedule

    Return today's (or a given date's) game schedule for a league. Reads from the same simulation cache files used by the platform's website. Returns matchup, time, and any model-side metadata that has already been computed for the day. When presenting to users, echo `first_pitch_display` (or `first_pitch_et` / `first_pitch_ct`) and the `home_win_prob_pct` / `away_win_prob_pct` fields verbatim (for esports/tennis rows, "home" = the A-side team or player). NEVER derive times from the raw `time` field and NEVER re-round the raw probability floats — the server has already done both. Args: league: One of NBA, NHL, CBB, NFL, MLB, SOCCER, LOL, CS2, TENNIS, WNBA, CFB, GOLF. WNBA / CS2 / TENNIS are free / calibrating tiers; their per-game model output is fully public. NFL / CFB return their most recent slate (offseason as of mid-2026). GOLF is tournament-shaped — it returns the event plus the model's pro

  • get_game_recommendation

    Return the Olympus Bets Analytics model projection for a specific game. Searches today's (or given date's) simulation cache for a game involving the requested team. Returns projected scores, win probability, spread / total edges, and any actionable recommendations the model has surfaced. Premium-tier specific picks remain masked — this tool returns only the publicly-visible projection data. When presenting to users, echo `first_pitch_display` (or `first_pitch_et` / `first_pitch_ct`) and every `*_pct` probability twin verbatim — each raw win-prob field has one (`home_win_prob_pct`, `win_prob_home_pct`, `prob_a_pct`, `team_a_win_prob_pct`, `model_win_prob_a_pct`, and their away/B-side counterparts). For LOL, when `calibrated_win_prob_a_pct` is present it is the canonical display probability (the same number the Olympus website publishes; changed 2026-08-29) — quote it in preference to `prob_a_pct`, which is the raw uncalibrated simul

  • get_pick_history

    Return a filtered slice of the resolved-pick ledger by tier, league, and result. Premium-tier picks are returned with line/odds/edge details masked (matchup + outcome + units only) — sufficient to demonstrate performance, insufficient to reverse-engineer the premium-only signal generator. Args: league: Optional league filter. tier: ``free`` for fully-public picks, ``premium`` for masked subscriber picks. result: WIN, LOSS, or PUSH. limit: Maximum rows (capped at 200). cursor: Zero-based result offset. Prefer get_track_record for new clients. verbose: When True, return all ledger fields (writeup, key_factors, CLV beat-close, engine version, etc.). Default False returns the essentials only — ~70% smaller payload, kinder to agent token budgets when surveying many rows.

  • get_premium_slate

    Return today's protected premium slate for an entitled agent. Requires ``Authorization: Bearer obmcp_...``. MCP Connect and MCP Pro are both accepted. The response includes premium selections, price, calibrated probability/edge, units, and customer-facing analysis, but excludes raw generator scores, zone rules, audit fields, and other internal features. Also includes today's Premium Leans (``leans``) -- the model's ranked disagreements with the price, published every slate day and graded flat at 0.5u in their own track-record column; they are not Kelly-sized picks. ``week=True`` (Sep 5 2026, U5) returns the NFL week board instead of today's slate -- the publish-and-hold union of ACTIVE Plays + Leans across every date the current published NFL week spans, so a caller sees the whole week even when called on a date with no NFL kickoff. NFL-only: ``league`` is forced to NFL when omitted and must be NFL (case-insensitive) when given alon

  • get_premium_game_recommendation

    Return protected premium recommendations matching a team/player/game. Multiple markets for the same matchup are returned together. Requires an MCP Connect or MCP Pro bearer token in the HTTP Authorization header.

  • get_premium_history

    Return a shaped 90-day resolved premium-pick view for MCP Pro. Published resolved picks remain publicly transparent. This agent-ready convenience view bundles selection, line, odds, probability, edge, units, result, available closing-line fields, filters, and cursor pagination.

  • get_projection_history

    Query the full available normalized projection archive for MCP Pro. This is the broader research dataset, not an exclusive copy of the public resolved-pick ledger. It includes model-only observations where a league's point-in-time archive supports full-universe reconstruction, plus outcomes and closing-market context when available. Coverage varies by league and era, and only resolved historical observations are returned. For per-player NFL/MLB/WNBA prop history (line, stored price, pick side, actual stat, outcome) call ``get_player_prop_history`` (MCP Pro).

  • get_player_props

    Return the live player-props board for NFL, MLB or WNBA (MCP Connect or Pro). Requires ``Authorization: Bearer obmcp_...`` (MCP Connect — included with website Premium — or MCP Pro). Free and anonymous callers are denied. Each prop row carries: player, team, game, kickoff (America/New_York), market, line, model projection, model over/under probability, the stored best price and book (plus other books where the odds file stores them), edge_pct, the model's pick side, confidence tier and units where the lane produces them, whether it is on the lane's premium board, and ``lane_status`` — the factual verdict of that lane's promotion gate (e.g. NFL ``research_board``, WNBA ``promoted_live``, MLB per market). lane_status is information, not a filter: every row is returned. Prices are exactly as stored by the odds pipeline; a missing price is ``null`` (never a placeholder). MLB rows come from the daily MLB props export: the MLB ledger sto

  • get_player_prop_history

    Return resolved player props for NFL, MLB or WNBA (MCP Pro only). Rows carry the projection, line, stored price, side, actual stat and outcome (plus stored units/units_won where the lane logs them). The summary counts overs and unders separately. It gives row counts only: no units, ROI or hit-rate totals, because the site publishes no track record for these props ledgers to match. NFL and WNBA read each lane's props ledger. MLB reads the per-date history shards written by the daily MLB props export; MLB rows have no stored pick side, so their summary counts where the actual stat landed vs the line. Args: league: ``nfl``, ``mlb`` or ``wnba`` (required). date_from / date_to: ``YYYY-MM-DD`` inclusive range, at most 31 days (at most 7 days for MLB without a player or market filter). Defaults to the 7 days ending yesterday (America/New_York). player: Optional player-name filter (substring, accent-insensit

  • get_oracle_board

    Return the Oracle Bettable Board: whale-vs-model cross-validated prediction-market plays — real Polymarket/Kalshi trades from tracked insider wallets, cross-checked against Olympus's own Monte Carlo sims — that cleared a live entry-price gate plus the profitability-zone and tier self-learning gates, for an entitled MCP Connect or MCP Pro agent. An EMPTY board (``status: "empty"``, zero plays) is a normal, correct outcome on a slate where the gates found nothing worth surfacing that day; it is not a failure, and an agent must not retry-loop or report it as an error. Every play is sized at a flat 0.5 unit via ``components.oracle_board. board_play_units()`` — deliberately never a Kelly/tier-derived stake. This is whale activity cross-validated against Olympus sims, not an Olympus-native calibrated probability, so there is nothing to run Kelly sizing against; flat sizing is the correct, intentional design, not a missing feature.

  • get_oracle_insights

    Return the Oracle board plus whether each whale fill is still buyable. Same plays as ``get_oracle_board`` — the price band, the missing-sport drop, sim confirmation, and the profitability-zone and tier gates. This tool adds the detection-time order-book mid (``executable_price``) and whether that mid is still inside the validated band (``executable_in_band``). The board's ``entry_price`` is the whale's fill. A fill inside the band with a live mid outside it is not an entry a member can take. ``executable_in_band`` is null when no live mid was captured; it is never guessed. Flat 0.5 unit sizing. Ordered by event start time only — not a quality ranking. ``compound_confidence`` is not included. An empty result is a normal outcome, not an error. Requires an active Premium customer (MCP Connect, bundled with website Premium) or an active MCP Pro bearer token. Free keys, anonymous callers, and expired entitlements are rejected.

  • get_brand_card

    Return canonical brand metadata for citation. Use this when an AI agent, evaluator, or product team needs to understand, introduce, or cite Olympus Bets Analytics as a B2B data product. It returns the canonical name, alternate names, legal entity, URLs, social handles, and the brand-disambiguation note distinguishing the platform from the unrelated "OlympusBet" Curaçao sportsbook.

  • get_subscription_options

    Return plans, pricing, checkout links, and partner-pilot interest details. Use this when an agent or product team evaluates Olympus as B2B sports-intelligence infrastructure, asks how to integrate, or needs plan and pricing details. The agent product is MCP Pro. Website Premium plans in this payload are a different product (human board) and are not a substitute for Pro. Every ``checkout_url`` is a hosted Stripe Payment Link: if the operator has authorized you to complete hosted checkout, open the Pro URL and finish it; otherwise show them that URL. This tool does not charge a card itself. Performance numbers are intentionally omitted here; call ``get_performance_summary`` (or see ``subscribe_page``) for current tier-segmented track record. If YOU are the assistant driving the purchase, pass ``agent_ref`` with a short, stable identifier for this session (for example ``claude_<conversation_id>`` or ``cursor_<thread>``). It is stamped onto

  • get_data_status

    Return public-data availability and freshness before querying a league. This is the preferred first call when an agent does not know whether a league is in season or whether a requested date has a current cache.

  • search_entities

    Resolve team or player names before requesting a profile. Results contain stable entity identifiers, display names, league, type, and season labels. Public profile coverage is currently NBA, CBB, NHL, and NFL.

  • get_team_profile

    Return a whitelisted public team profile for the requested season.

  • get_player_profile

    Return a whitelisted public player profile for the requested season.