MCP 服务器

PropProfessor MCP

Standalone Model Context Protocol server for PropProfessor, plus a small query CLI for local analysis.

README

PropProfessor MCP

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

Quick start

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.