TKB Picks MCP Server (v1.1.1)

MCP server wrapping SportsGameOdds (odds, schedules, props, results) and BALLDONTLIE (injuries, standings) for building TKB Picks betting threads across MLB, WNBA, NFL, and CFB.

Deploy

Render Web Service, Node environment:

• Build command: npm install && npm run build

• Start command: npm start

• Env vars: SGO_API_KEY, BDL_API_KEY

• MCP endpoint: https://<your-app>.onrender.com/mcp

• Health check: /health

Related MCP server: MLB V3 Scores MCP Server

Tools (15)

What changed in v1.1.0

Correctness

• Injury team resolution now handles NFL (full_name) and MLB/WNBA (display_name); comment field reads comment, short_comment, description, or long_comment. Previously every NFL record returned team: "unknown" with no detail.

• Empty team-filtered injury results no longer report "this is a good sign." When team-data coverage is below 50% the tool returns CANNOT VERIFY instead of a false all-clear.

• includeOpposingOdds corrected to includeOpposingOddIDs. The old name is not a real SGO parameter and was silently ignored on every request.

• Pricing guardrail: a market is only usable if a real sportsbook priced it. SGO's modelled fairOdds is never published. This prevents the NFL Week 1 case where an unpriced prop returned "-137" on both sides with no line.

• Hit rates are labelled by season, so prior-season games can't masquerade as current form.

Cost and performance

• New /players endpoint replaces using the debug event dump for playerIDs.

• Home/road splits use BDL standings (one free call) instead of tallying up to 100 billed SGO event objects, and now also return point differential, streak, and division/conference records.

• BDL injury pagination raised to per_page=100 from the default 25.

• tkb_get_api_usage exposes quota. SGO bills per event object returned, and hit-rate checks are the heaviest consumer.

New coverage

• NFL stadiums (all 32) and CFB stadiums with roof types, enabling weather beyond MLB.

• CFB tiering filters out the Division II teams SGO's NCAAF feed returns, plus a named-rivalry list.

• Futures and pick grading.

Fixed in v1.1.1 (both found by live testing v1.1.0)

Bookmaker attribution in the pricing guardrail. SGO's byBookmaker map contains a literal key named unknown. The guardrail treated it as a real sportsbook, so the NFL Week 1 Drake Maye prop still returned -137 on both sides sourced to "unknown". It also accepted SGO's cross-book consensus bookOdds when no named book had priced anything. A price is now only usable if it is traceable to a named sportsbook. unknown, consensus, average, and fair are all rejected.

MLB standings field names. BALLDONTLIE does not share a standings schema across sports. MLB returns home / road / total / intra_division / streak where NFL returns home_record / road_record / overall_record / division_record / win_streak. Only the NFL names were read, so every MLB standings lookup missed and fell back to tallying up to 100 billed SGO event objects. A new src/services/standingsNormalizer.ts resolves every known alias, prefers MLB's numeric home_wins / home_losses over string parsing, and adds runs per game and last-ten to the output. Team matching is exact-first so "Chicago White Sox" cannot match "Chicago Cubs" on shared location.

Known gaps

• CFB injuries are unavailable through BALLDONTLIE on the current plan. Use preview articles for notable CFB injuries.

• Retractable roofs are never assumed. Roof status is a same-day team decision; the weather tool flags these for manual verification.

• CFB top-25 filtering takes rankings as an input rather than looking them up, because SGO does not expose a verified ranking field. Pass the current Top 25.

• Player props appear close to game time. A live test showed 6 markets on an NFL preseason game, 266 on Week 1 five weeks out, and 1,180 on an MLB game starting within the hour. Build threads inside the normal pre-game window.