PropProfessor MCP

Standalone MCP server for PropProfessor, plus a small query CLI for local analysis.

Quick start

• Auth guide
• Config guide

git clone https://github.com/j17drake/propprofessor-mcp.git
cd propprofessor-mcp
npm install

You also need a saved PropProfessor browser session at auth.json in the repo root. That file is ignored by git, so copy it from your existing setup or save a fresh browser session into this repo.

Run locally

Run the MCP server over stdio:

npm run mcp
# or, after npm link
pp-mcp

Run the query CLI:

npm run query -- screen --league NBA --market Moneyline
# or
pp-query tennis --market Moneyline --limit 10
# or
pp-query screen --league NBA --market Points
# or
pp-query sport --league WNBA --market Moneyline
# or
pp-query wnba --market Moneyline

You can also use these aliases directly:

• NBA, query_nba_screen or pp-query nba
• WNBA, query_wnba_screen or pp-query wnba
• MLB, query_mlb_screen or pp-query mlb
• NFL, query_nfl_screen or pp-query nfl
• NHL, query_nhl_screen or pp-query nhl
• Soccer, query_soccer_screen or pp-query soccer
• NCAAB, query_ncaab_screen or pp-query ncaab
• NCAAF, query_ncaaf_screen or pp-query ncaaf

npm link workflow

If you want the binaries available on your PATH while developing:

npm link
pp-mcp
pp-query health

pp-query command inventory

• opinion, analyze a single prop from the sportsbook screen
• sportsbook, fetch sportsbook +EV rows
• smart, fetch smart money rows
• fantasy, fetch fantasy rows
• tennis, query and rank tennis screen rows
• screen, query any sport screen with --league
• sport, alias for screen, use --league to pick the sport
• nba, NBA screen shorthand
• wnba, WNBA screen shorthand
• mlb, MLB screen shorthand
• nfl, NFL screen shorthand
• nhl, NHL screen shorthand
• soccer, Soccer screen shorthand
• ncaab, NCAAB screen shorthand
• ncaaf, NCAAF screen shorthand
• presets, show the active league presets
• list, show the command inventory
• health, check auth and endpoint health

MCP config example

Add this to your Hermes or Claude MCP config when you want to use the local repo:

{
  "mcpServers": {
    "propprofessor": {
      "command": "pp-mcp",
      "args": [],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

If you prefer a direct repo path instead of a global link, use the local file path to scripts/propprofessor-mcp-server.js as the command target in your MCP launcher.

Available tools

• query_screen_odds
• query_fantasy
• query_fantasy_sorted
• query_screen_odds_best_comps
• query_screen_odds_ranked
• query_sport_screen
• query_nba_screen
• query_wnba_screen
• query_mlb_screen
• query_nfl_screen
• query_nhl_screen
• query_soccer_screen
• query_ncaab_screen
• query_ncaaf_screen
• query_tennis_screen
• hide_fantasy_row
• hide_ev_row
• get_hidden_bets
• unhide_bet
• clear_hidden_bets
• league_presets
• health_status

Requirements

• Node.js 18 or newer
• A saved PropProfessor browser session at auth.json in the repo root

Packaging

This repo is set up for npm packaging and tagged GitHub releases.

• main points at the MCP server entrypoint
• pp-mcp and pp-query are exposed as binaries
• npm test runs the node:test suite

Repository layout

• lib/, PropProfessor auth, requests, and analysis helpers
• scripts/, MCP stdio server and CLI
• test/, node:test coverage for the API, MCP contract, and CLI