DFS 정산, 배팅 배당률 계산, 기대 가치 산출 및 스포츠 엔터테인먼트 예측을 위한 AI agent용 도구를 제공합니다.
다른 이름 Buzzr-app/dfs-engine, dfs-engine, @buzzr/mcp
- 스타
- 1
- Tools
- 11
- 다운로드, 30일
- 220
- 최신 버전
- 5.1.0
- 마지막 커밋
- 2026년 9월 13일
- 라이선스
- MIT
Buzzr Sports Engine MCP란?
DFS 정산, 배팅 배당률 계산, 기대 가치 산출 및 스포츠 엔터테인먼트 예측을 위한 AI agent용 도구를 제공합니다. 11개 도구를 제공합니다. 예: grade_dfs_entry, grade_dfs_entries, validate_dfs_entry.
프로젝트 README에서 생성된 요약
Buzzr Sports Engine MCP server 정보
Buzzr Sports Engine은 AI agent가 복잡한 스포츠 관련 계산 및 정산을 수행할 수 있도록 전문화된 도구 세트를 제공합니다. 이 서버는 Claude Desktop, Claude Code, Cursor, Codex와 같은 클라이언트에 연결되는 로컬 stdio MCP server로 작동합니다. 서버는 DFS 정산, 배팅 수학, 엔터테인먼트 예측이라는 세 가지 핵심 엔진을 위한 가벼운 스키마 검증 인터페이스 역할을 합니다. 실시간 배당률이나 개인 사용자 데이터를 가져오지 않으며, 대신 agent가 제공하는 입력을 기반으로 작동합니다.
개발자는 제공되는 11개의 도구를 사용하여 Kelly stake 계산, 두 방향 시장의 vig 제거, 데일리 판타지 스포츠(DFS) 엔트리 정산 등의 작업을 처리할 수 있습니다. DFS 엔진은 PrizePicks 및 Underdog과 같은 플랫폼을 위한 특정 정책을 지원하여 pick-em 엔트리의 검증 및 등급 산정을 가능하게 합니다. 엔터테인먼트 엔진은 머신러닝을 사용하여 게임 버즈 스코어와 개인화된 순위를 제공합니다. 이 서버는 npx를 통한 로컬 실행을 위해 설계되었으며 Node.js 22 이상의 버전이 필요합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Buzzr Sports Engine MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Buzzr Sports Engine MCP 설치
$ claude mcp add dfs-engine -- npx -y @buzzr/mcpCursor에 Buzzr Sports Engine MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"dfs-engine": {
"command": "npx",
"args": [
"-y",
"@buzzr/mcp"
]
}
}
}VS Code에 Buzzr Sports Engine MCP 설치
.vscode/mcp.json
{
"servers": {
"dfs-engine": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@buzzr/mcp"
]
}
}
}VS Code CLI에 Buzzr Sports Engine MCP 설치
$ code --add-mcp '{"name":"dfs-engine","type":"stdio","command":"npx","args":["-y","@buzzr/mcp"]}'Claude Desktop에 Buzzr Sports Engine MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"dfs-engine": {
"command": "npx",
"args": [
"-y",
"@buzzr/mcp"
]
}
}
}Codex에 Buzzr Sports Engine MCP 설치
$ codex mcp add dfs-engine -- npx -y @buzzr/mcpCodex config.toml에 Buzzr Sports Engine MCP 설치
~/.codex/config.toml
[mcp_servers.dfs-engine] command = "npx" args = ["-y", "@buzzr/mcp"]
Gemini CLI에 Buzzr Sports Engine MCP 설치
$ gemini mcp add -s user dfs-engine npx -- -y @buzzr/mcpGemini settings.json에 Buzzr Sports Engine MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"dfs-engine": {
"command": "npx",
"args": [
"-y",
"@buzzr/mcp"
]
}
}
}Buzzr Sports Engine MCP 도구 11
README에서 감지됨grade_dfs_entrygrade_dfs_entriesvalidate_dfs_entrylist_book_policiesfair_lineclosing_line_valueparlay_valuekelly_stakesummarize_bet_historypredict_game_buzzrank_games
| grade_dfs_entry | — | |
| grade_dfs_entries | — | |
| validate_dfs_entry | — | |
| list_book_policies | — | |
| fair_line | — | |
| closing_line_value | — | |
| parlay_value | — | |
| kelly_stake | — | |
| summarize_bet_history | — | |
| predict_game_buzz | — | |
| rank_games | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능buzzr-app/dfs-engine is public and reachablegithub.com/buzzr-app/dfs-engine ↗통과
- 패키지가 이 저장소를 소스로 명시@buzzr/mcp names buzzr-app/dfs-engine as sourcenpmjs.com/package/@buzzr/mcp ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @buzzr/mcpnpmjs.com/package/@buzzr/mcp/v/5.1.0#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-09-13github.com/buzzr-app/dfs-engine ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @buzzr/mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음102 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음11 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기@buzzr/mcp
MCP server exposing the @buzzr sports engines to AI agents — DFS settlement, odds math, and entertainment predictions as tools.
@buzzr/mcp is a Model Context Protocol stdio
server that puts the whole @buzzr engine family in front of any MCP-capable agent
(Claude Desktop, Claude Code, or your own client). All math and policy logic lives
in the underlying engines — this package is a thin, schema-validated tool surface:
@buzzr/dfs-engine— pick-em settlement with versioned compatibility and custom policies@buzzr/bets-core— no-vig fair lines, parlay pricing, expected value, Kelly staking@buzzr/entertainment-engine— ML buzz-score predictions and personalized game ranking
Install
Run it directly with npx (Node 22+). Pin the version you reviewed instead of
silently accepting a future latest release:
npx -y @buzzr/mcp@5.1.0
The server speaks MCP over stdio: JSON-RPC on stdin/stdout, logs on stderr. It exposes 11 tools with bounded inputs and outputs, and does not fetch live odds, box scores, operator accounts, or private user data.
Smithery
The Buzzr Sports Engine listing on
Smithery packages
the exact published @buzzr/mcp@5.1.0 artifact as a local stdio MCPB. It is a
distribution and installation surface, not a hosted HTTP service. To add it to
Codex through Smithery:
npx -y smithery@1.2.0 mcp add sarveshsea/buzzr-sports-engine --client codex
Smithery writes the corresponding MCP configuration for the selected client. Use the direct npm command above when you need both the server package and its launcher configuration pinned explicitly.
Claude Desktop
Add this to claude_desktop_config.json from Settings → Developer → Edit
Config, then fully quit and reopen Claude Desktop:
{
"mcpServers": {
"buzzr": {
"command": "npx",
"args": ["-y", "@buzzr/mcp@5.1.0"]
}
}
}
Claude Code
claude mcp add --transport stdio buzzr -- npx -y @buzzr/mcp@5.1.0
For a version-controlled project configuration, add this to .mcp.json, trust
the project when prompted, and start a new Claude Code session:
{
"mcpServers": {
"buzzr": {
"command": "npx",
"args": ["-y", "@buzzr/mcp@5.1.0"]
}
}
}
Confirm it with claude mcp get buzzr; inside Claude Code, /mcp shows the
connection and discovered tool count.
Cursor
Add this to the repository's .cursor/mcp.json (or the equivalent user-level
MCP configuration), then fully restart Cursor:
{
"mcpServers": {
"buzzr": {
"command": "npx",
"args": ["-y", "@buzzr/mcp@5.1.0"]
}
}
}
Open Cursor Settings → MCP to confirm buzzr connected and exposed 11
tools. See Cursor's MCP documentation if
your installed Cursor version presents a different settings location.
Codex
The Codex CLI, IDE extension, and app share config.toml. The one-command user
setup is:
codex mcp add buzzr -- npx -y @buzzr/mcp@5.1.0
Or add the equivalent block to ~/.codex/config.toml for all projects, or to a
trusted repository's .codex/config.toml for that project only:
[mcp_servers.buzzr]
command = "npx"
args = ["-y", "@buzzr/mcp@5.1.0"]
Run codex mcp get buzzr, then start a new Codex task after changing the
configuration.
Generic stdio MCP client
Use this process configuration in any client that accepts a command plus args:
{
"name": "buzzr",
"transport": "stdio",
"command": "npx",
"args": ["-y", "@buzzr/mcp@5.1.0"],
"env": {}
}
Treat stdout as JSON-RPC only, read diagnostics from stderr, and close the child
process's stdin during shutdown. The client must perform the MCP lifecycle below;
starting npx in a terminal and seeing it remain open is normal for a stdio
server waiting for a client.
Initialization and capability discovery
The client sends initialize first. Verify the serverInfo.name field is
"buzzr", the serverInfo.version field is the installed package version, and
the response has a capabilities.tools object. Send
notifications/initialized, then call tools/list. The server returns the 11
tools in the catalog below with their input schemas. It does not advertise data
fetching, resources, or prompts.
examples/mcp-calls.json is a machine-readable JSON-RPC
transcript with the initialization expectation, exact tool discovery order, and
a safe list_book_policies → validate_dfs_entry → grade_dfs_entry workflow.
The repository replays that workflow through a real MCP client in CI.
Startup troubleshooting
- Confirm Node.js 22+ and npm are visible to the same desktop process or shell:
node --version,npm --version, andnpx --version. - Confirm the pinned release exists with
npm view @buzzr/mcp@5.1.0 version, then runnpm cache verify. If npm reports cache corruption, repair npm's cache before retrying;npm cache clean --forceis a last resort because it removes the whole local cache. - GUI apps may inherit a smaller
PATHthan an interactive shell. On macOS or Linux, runcommand -v npx; on Windows, runwhere.exe npx. If the client cannot findnpx, use that absolute path ascommand(normallynpx.cmdon Windows) or launch the client from an environment where Node is onPATH. - Keep logs off stdout. A healthy manual start writes a
listening on stdiodiagnostic to stderr and waits for JSON-RPC input. - After any config, Node, PATH, or package-version change, fully quit and restart Claude Desktop, Claude Code, Cursor, or Codex. Opening only another chat tab may leave the old MCP child process and cached tool catalog in place.
Tool catalog
| Tool | Engine | What it does |
|---|---|---|
grade_dfs_entry |
@buzzr/dfs-engine | Settle one transport-bounded 1–12-leg entry; executable built-in policies currently allow at most 6 PrizePicks or 8 Underdog legs. |
grade_dfs_entries |
@buzzr/dfs-engine | Settle 1–50 entries, up to 600 total legs, with bounded concurrency and isolated failures. |
validate_dfs_entry |
@buzzr/dfs-engine | Return structured engine validation issues for a candidate entry without settling it. |
list_book_policies |
@buzzr/dfs-engine | List authoritative executable profile snapshots and metadata-only drafts, including status, verification, sources, and complete play types. |
fair_line |
@buzzr/bets-core | Remove vig from both sides of one two-way market. |
closing_line_value |
@buzzr/bets-core | Compare placed and closing prices for the same selection. |
parlay_value |
@buzzr/bets-core | Price independent parlay legs, compare offered odds, and optionally calculate expected value. |
kelly_stake |
@buzzr/bets-core | Calculate full and fractional Kelly stakes from a supplied win probability. |
summarize_bet_history |
@buzzr/bets-core | Summarize up to 500 bets with overall and UTC-period rollups, drawdown, and streaks. |
predict_game_buzz |
@buzzr/entertainment-engine | Predict one game's 1–10 entertainment score with confidence and factor detail. |
rank_games |
@buzzr/entertainment-engine | Rank 1–100 candidate games for a bounded taste profile. |
Tool strings, identifiers, arrays, stdio frames, concurrent calls, and serialized
results are bounded. American odds must be within [-100000, -100] or
[100, 100000]. grade_dfs_entries, closing_line_value, and
summarize_bet_history return string contractVersion: "1".
DFS policy safety
Operator-named policies are independent compatibility profiles, not official rules engines or evidence of affiliation:
- PrizePicks is experimental and partially verified. Standard payout references were reviewed on 2026-07-16 from PrizePicks Payouts and PrizePicks Potential Outcomes, with DNP behavior checked against DNPs, Reboots, and Ties. The compatibility policy treats a 2-pick Power entry with a DNP as a refund when it falls below the two-pick minimum. Other settlement behavior and variable lineup-specific payouts remain incomplete.
- Underdog is experimental and unverified. The Underdog Sports Legal Center is the recorded rules entrypoint; the current compatibility payout and settlement values have not been verified.
Displayed lineup terms are authoritative. Call list_book_policies before
grading, inspect verification and sources, and obtain explicit operator rulings
for DNPs, reboots, ties, rescues, voids, and corrections. The tool lists future
fixtures with executable: false; grading tools reject draft book IDs because
drafts are metadata, not settlement implementations.
Error contracts
- Invalid tool arguments return the same bounded
invalid_inputresult through an MCP client transport or a direct exportedtool.handler(...)call. At most eight compact validation issues are included; raw Zod errors are never returned. - Malformed JSON-RPC envelopes remain protocol errors owned by the MCP SDK and
are distinct from a valid
tools/callrequest with invalid tool arguments. validate_dfs_entryintentionally accepts a bounded candidate object and returns the engine's structured validation report.- Execution failures return generic
isError: trueresults such astool_execution_failed,entry_settlement_failed,server_busy, orresult_too_large. Internal error details are not public.
Example transcripts
"Did my PrizePicks slip hit?"
User: I had a $10 2-pick power play: LeBron over 25.5 points (he scored 31) and Curry over 27.5 (he scored 33). What's the payout?
Agent calls
grade_dfs_entry:{ "entryId": "slip-1", "bookId": "prizepicks", "playTypeId": "power", "stake": 10, "displayedMultiplier": 3, "legs": [ { "legId": "l1", "playerName": "LeBron James", "league": "NBA", "propType": "points", "line": 25.5, "direction": "over", "actual": 31 }, { "legId": "l2", "playerName": "Stephen Curry", "league": "NBA", "propType": "points", "line": 27.5, "direction": "over", "actual": 33 } ] }Result:
"status": "won","payout": { "total": 30, "withdrawable": 30, "bonus": 0 }— both supplied actuals clear their lines and the submitted 3× displayed multiplier is consistent with the selected compatibility table. Confirm the actual entry details before treating this as an operator outcome.
"Is this parlay +EV?"
User: The book offers +264 on a two-leg parlay where both legs are -110/-110 markets. Worth $100?
Agent calls
parlay_valuewith{ "legs": [{ "selected": -110, "opposite": -110 }, { "selected": -110, "opposite": -110 }], "offeredAmericanOdds": 264, "stake": 100 }.Result: fair probability 0.25 (fair price +300) vs. offered +264 —
"edgePercent": -2.47and an expected loss of about $9 per $100. The agent recommends passing.
"What should I watch tonight?"
User: I'm a Lakers fan. Rank tonight's slate for me.
Agent calls
rank_gameswith the slate and{ "profile": { "favoriteTeams": ["Lakers"], "leagueAffinity": { "NBA": 0.8 } } }.Result: each game comes back with
baseScore, boundedaffinityAdjustmentandsocialAdjustment, atotalScore, and named factors ("favorite team playing", "league affinity") the agent can cite when explaining the ranking.
Embedding
The server is also exported as a library, so you can mount the same tool catalog on your own transport (in-memory for tests, HTTP, etc.):
import { createBuzzrMcpServer, allTools } from '@buzzr/mcp';
const server = createBuzzrMcpServer();
await server.connect(myTransport);
Individual tool definitions (gradeDfsEntryTool, fairLineTool, …) are exported
too — each is { name, title, description, inputSchema, handler }, and handlers
can be called directly without any transport.
Codex skill
The repository includes a Buzzr Sports Engine skill with the 11-tool routing guide, limits, response-reading order, and operator-safety rules:
npx skills@1.5.17 add https://github.com/Buzzr-app/dfs-engine --skill buzzr-sports-engine --agent codex --yes --copy
Repository contributors can prove the same one-command install without using a
published branch: npx skills@1.5.17 add . --skill buzzr-sports-engine --agent codex --yes --copy. npm run check:skill runs the official pinned
quick_validate.py, performs that local install in an isolated temporary
project, and verifies every installed skill file byte-for-byte.
Compatibility
- Node.js >= 22 is supported.
rank_gamesrequires@buzzr/entertainment-engine>= 5.0.0. Against an older engine build the tool degrades gracefully with anengine_capability_missingerror result instead of crashing the server.
Import the supported API from @buzzr/mcp. Deep src/* and dist/* imports are unsupported.
See the all-package API index and the
generated root-export reference.
Report reproducible defects in GitHub Issues. Report vulnerabilities privately through SECURITY.md. The versioning and support policy defines the supported runtime and SemVer contract.
License
Buzzr Sports Engine MCP 질문
Buzzr Sports Engine MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add dfs-engine -- npx -y @buzzr/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Buzzr Sports Engine MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Buzzr Sports Engine MCP는 어떤 도구를 제공하나요?
11개 도구를 제공합니다. 예: grade_dfs_entry, grade_dfs_entries, validate_dfs_entry, list_book_policies, fair_line.
어떤 종류의 배팅 수학 도구가 포함되어 있나요?
두 방향 시장(two-way markets)의 vig 제거, 파레이(parlay) 가격 책정, 기대 가치 계산 및 Kelly stake 결정 도구가 포함되어 있습니다.
이 서버가 실시간 스포츠 데이터를 가져오나요?
아니요, 이 서버는 실시간 배당률, 박스 스코어, 운영자 계정 또는 개인 사용자 데이터를 가져오지 않습니다.
Claude Desktop에서 사용할 수 있나요?
네, claude_desktop_config.json 파일을 편집하여 Claude Desktop 설정에 이 서버를 추가할 수 있습니다.
DFS 엔트리 정산에는 어떤 제한이 있나요?
현재 내장된 정책에 따라 엔트리당 PrizePicks 항목은 최대 6개, Underdog 항목은 최대 8개까지 정산할 수 있습니다.