{"_id":"@cyanheads/sports-mcp-server","_rev":"8-a44b82b64b5ee24fc71a1be5cb8eb74b","name":"@cyanheads/sports-mcp-server","dist-tags":{"latest":"0.2.3"},"versions":{"0.1.1":{"name":"@cyanheads/sports-mcp-server","version":"0.1.1","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/sports-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/sports-mcp-server@0.1.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/sports-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"bin":{"sports-mcp-server":"dist/index.js"},"dist":{"shasum":"372a161ea756e6dd6e47cab05a784d5987a4deb0","tarball":"https://registry.npmjs.org/@cyanheads/sports-mcp-server/-/sports-mcp-server-0.1.1.tgz","fileCount":73,"integrity":"sha512-IDzqtymIGN31Y+OylE6+4+NhA5OCYvtAmksmNcPTh6UEDdfYIW4v9KPa1iqS0ZsE5Osnx0Uxn5kDPwBnra37CA==","signatures":[{"sig":"MEQCIF2B7Y+Y/VVJFArQ3+NQXn2DNM9uowyns2ZqG6oBa8pNAiBlrCWc6+JAuPoMF7DIR1szwA3MGM0zvWYxwZmU34V5+A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":286503},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"372a161ea756e6dd6e47cab05a784d5987a4deb0","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/sports-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"npm run build && npx -y @anthropic-ai/mcpb pack . dist/sports-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-IDzqtymIGN31Y+OylE6+4+NhA5OCYvtAmksmNcPTh6UEDdfYIW4v9KPa1iqS0ZsE5Osnx0Uxn5kDPwBnra37CA==","repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.9.21"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.11","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"^25.9.1","@biomejs/biome":"^2.4.16"},"_npmOperationalInternal":{"tmp":"tmp/sports-mcp-server_0.1.1_1780662968038_0.5308264483410088","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cyanheads/sports-mcp-server","version":"0.1.2","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/sports-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/sports-mcp-server@0.1.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/sports-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"bin":{"sports-mcp-server":"dist/index.js"},"dist":{"shasum":"4e912c1a49062cac8144424adf6e6cdba9f817ba","tarball":"https://registry.npmjs.org/@cyanheads/sports-mcp-server/-/sports-mcp-server-0.1.2.tgz","fileCount":74,"integrity":"sha512-VbSgPrft+KpfAmjxBt6tdqzE3DeH8/feKxj54ihDP6Wvli3aeZdlhShTig1CufqSmS7WxYUTkmE/q9Nim7woaA==","signatures":[{"sig":"MEUCIQCvy/KEmEKXAaqA6NuFWAw+7k7GxdxexoPEoXWnny+ZQAIgcWqCR7KhmoofbZhjTw72QXmPZ6yqsLEnFU0L0DwMy+s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":293396},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"4e912c1a49062cac8144424adf6e6cdba9f817ba","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/sports-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"npm run build && npx -y @anthropic-ai/mcpb pack . dist/sports-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-VbSgPrft+KpfAmjxBt6tdqzE3DeH8/feKxj54ihDP6Wvli3aeZdlhShTig1CufqSmS7WxYUTkmE/q9Nim7woaA==","repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.9.21"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.11","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"^25.9.2","@biomejs/biome":"^2.4.16"},"_npmOperationalInternal":{"tmp":"tmp/sports-mcp-server_0.1.2_1780814493373_0.3165570000649136","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@cyanheads/sports-mcp-server","version":"0.1.3","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/sports-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/sports-mcp-server@0.1.3","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/sports-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"bin":{"sports-mcp-server":"dist/index.js"},"dist":{"shasum":"bd9724ef073a8479b52ef7b350481e5a1a8d901a","tarball":"https://registry.npmjs.org/@cyanheads/sports-mcp-server/-/sports-mcp-server-0.1.3.tgz","fileCount":75,"integrity":"sha512-A8tT6Ce5mszXJClYttMqB3fdKt/QrzeL8GfH8UQz9fVYGlOAU+7x26yt/uJ7WUjDFvHmB5nmDtcnSjkv0Qp+sA==","signatures":[{"sig":"MEYCIQD6h9RQRwrH+MBDTw3E7a/inK3JN0oj/lJGF/p6+F4qOwIhAMG9o67NsOc5Rqj7gaqd4nJTXZ175u8Gfd1fBbOZRCRB","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":296703},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"bd9724ef073a8479b52ef7b350481e5a1a8d901a","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/sports-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/sports-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/sports-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-A8tT6Ce5mszXJClYttMqB3fdKt/QrzeL8GfH8UQz9fVYGlOAU+7x26yt/uJ7WUjDFvHmB5nmDtcnSjkv0Qp+sA==","repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.11","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"^25.9.3","@biomejs/biome":"^2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/sports-mcp-server_0.1.3_1781325825688_0.8385239847590957","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@cyanheads/sports-mcp-server","version":"0.1.4","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/sports-mcp-server@0.1.4","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/sports-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"bin":{"sports-mcp-server":"dist/index.js"},"dist":{"shasum":"eaaac3cf73848da3502e00eabbbb97f4aa78a75d","tarball":"https://registry.npmjs.org/@cyanheads/sports-mcp-server/-/sports-mcp-server-0.1.4.tgz","fileCount":76,"integrity":"sha512-nD7u8V3e7K06+dYzr1hQBuAocx48+flLw4mhFvoRlL1wXM7o6lfhbj5j6PUnYMtXcsWN85iPMEzck/rvX+lNrQ==","signatures":[{"sig":"MEUCIQDtq4/ZTAo1EWSYAqJwGd45eChkHFArbUpYLrd2g/mekwIgH18Pu2kpSm3V/ORh/vHZIJtoJidsxmmMPrYV/WvmC4A=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":307327},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"eaaac3cf73848da3502e00eabbbb97f4aa78a75d","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/sports-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/sports-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/sports-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-nD7u8V3e7K06+dYzr1hQBuAocx48+flLw4mhFvoRlL1wXM7o6lfhbj5j6PUnYMtXcsWN85iPMEzck/rvX+lNrQ==","repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"^26.2.0","@biomejs/biome":"^2.5.9","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/sports-mcp-server_0.1.4_1787328650142_0.313310764540105","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@cyanheads/sports-mcp-server","version":"0.2.0","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/sports-mcp-server@0.2.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/sports-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"bin":{"sports-mcp-server":"dist/index.js"},"dist":{"shasum":"d12d4f447b261cf160bcb6119956cfc98ef7b8e4","tarball":"https://registry.npmjs.org/@cyanheads/sports-mcp-server/-/sports-mcp-server-0.2.0.tgz","fileCount":77,"integrity":"sha512-6Fb/RHFnzObKU4ft0T1XAdsTGftGK1/5D2bkEYn0hjWf5PjFFNkAzRNraF5mv6XYX7J8qILTKzj+kc5kopxToQ==","signatures":[{"sig":"MEUCIQDKBcFsjMw9iRpaEM7XsoR5giwQxhZzVUbLwkRhlaAlEgIgH6f6Zy/nD1JqZqoVUQyv22z9XqnPjKsJij2WEaL5Ahs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":307581},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"d12d4f447b261cf160bcb6119956cfc98ef7b8e4","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/sports-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/sports-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/sports-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-6Fb/RHFnzObKU4ft0T1XAdsTGftGK1/5D2bkEYn0hjWf5PjFFNkAzRNraF5mv6XYX7J8qILTKzj+kc5kopxToQ==","repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"^26.4.0","@biomejs/biome":"^2.5.11","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/sports-mcp-server_0.2.0_1788126708267_0.9867436475530489","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@cyanheads/sports-mcp-server","version":"0.2.1","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/sports-mcp-server@0.2.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/sports-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"bin":{"sports-mcp-server":"dist/index.js"},"dist":{"shasum":"d9b794a5a747a2467314c843722d1a68b2954c4d","tarball":"https://registry.npmjs.org/@cyanheads/sports-mcp-server/-/sports-mcp-server-0.2.1.tgz","fileCount":78,"integrity":"sha512-vUEwVcpyLu6Ikm5v/EQ3+Yobvx0nSaeUqtWDWuZbcz3Lq7LjHin9YyFb0uZbXTqVqoBkav9ro1lQgHeKivMiUA==","signatures":[{"sig":"MEUCIGlNLptReTjR/KpEJBYdYwmn5oL6FQU2Ues9LLeqAS7HAiEAimqMZKnqPbhEjskj1S5Gdl/Q+lHNZxQ/Kp2qBdAgDoc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":313273},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"d9b794a5a747a2467314c843722d1a68b2954c4d","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/sports-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/sports-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/sports-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-vUEwVcpyLu6Ikm5v/EQ3+Yobvx0nSaeUqtWDWuZbcz3Lq7LjHin9YyFb0uZbXTqVqoBkav9ro1lQgHeKivMiUA==","repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"^26.4.0","@biomejs/biome":"^2.5.11","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/sports-mcp-server_0.2.1_1788144478611_0.8182108021494796","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@cyanheads/sports-mcp-server","version":"0.2.2","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/sports-mcp-server@0.2.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/sports-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"bin":{"sports-mcp-server":"dist/index.js"},"dist":{"shasum":"530433c96c30e564f2dfd630c2e1e8cfb1aa6a41","tarball":"https://registry.npmjs.org/@cyanheads/sports-mcp-server/-/sports-mcp-server-0.2.2.tgz","fileCount":79,"integrity":"sha512-Pd31GM8r1nIjunggzlzOszjF3z8Q6y2wKULmvzb6/AjFXFKoZv3aQliVxJNeEXhNckcSueYnyT+ZxCx/DAJYmw==","signatures":[{"sig":"MEQCIASQPSZOqekWCK/dWB/RWZKK6b8GSlinR3Mm/IyE0INUAiA0UWU5qXM8GHlX50+LUA/MOd1mOLCd365U9EB57vuLrA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIEtRq/53NB32IWWuHfpd1SWgJpqJmYRPFymAFBOLOfIvAiAumdgVOzd4Tn6ail2ku22fomQpqkNLCautYGuccWzHcQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":325225},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"530433c96c30e564f2dfd630c2e1e8cfb1aa6a41","engines":{"bun":">=1.4.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/sports-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/sports-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/sports-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","audit:fix":"bun audit fix","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-Pd31GM8r1nIjunggzlzOszjF3z8Q6y2wKULmvzb6/AjFXFKoZv3aQliVxJNeEXhNckcSueYnyT+ZxCx/DAJYmw==","repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.13.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.9","vitest":"^5.0.1","depcheck":"^1.4.7","tsc-alias":"^1.9.5","typescript":"^7.0.2","@types/node":"^26.6.2","@biomejs/biome":"^2.5.14","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/sports-mcp-server_0.2.2_1790050281106_0.24247354082425243","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"_id":"@cyanheads/sports-mcp-server@0.2.3","bin":{"sports-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"dist":{"shasum":"56b61d28eac42bde474ebd300b0cc92f0e10aa9d","tarball":"https://registry.npmjs.org/@cyanheads/sports-mcp-server/-/sports-mcp-server-0.2.3.tgz","fileCount":92,"integrity":"sha512-mW5CdXQodAMoWJ2j7+1GGwrh2qG78Lq8jg/PVN66ZdulZwLJF96selDkvG6DzsPVqcsBzLCE2vV3kZNbLo56Cg==","signatures":[{"sig":"MEUCIQD8z9FSi2CgxVhVS+9gSzLG45suwXNUBQhZwtyy/SyFKgIgU/FO6Q9YZyX7dxbgvSfe4awJJ9VTXOxmi95Wu4ZPOLM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAfz71xrtBPtEBqpM/HByRRaCQw+yhj6jOrOPEUj47MNAiA5pz9/7u9GSpF/KEJFJpnFDiMEV52sUb3Yl3K1j4D4cA=="}],"unpackedSize":343311},"main":"dist/index.js","name":"@cyanheads/sports-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand (https://caseyjhand.com)","shasum":"56b61d28eac42bde474ebd300b0cc92f0e10aa9d","engines":{"bun":">=1.4.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"license":"Apache-2.0","mcpName":"io.github.cyanheads/sports-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/sports-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/sports-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","audit:fix":"bun audit fix","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"version":"0.2.3","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/sports-mcp-server#readme","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"_integrity":"sha512-mW5CdXQodAMoWJ2j7+1GGwrh2qG78Lq8jg/PVN66ZdulZwLJF96selDkvG6DzsPVqcsBzLCE2vV3kZNbLo56Cg==","repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","directories":{},"maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.13.10"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.2","devDependencies":{"ignore":"^7.0.10","vitest":"^5.0.2","depcheck":"^1.4.7","tsc-alias":"^1.9.5","typescript":"^7.0.2","@types/node":"^26.6.3","@biomejs/biome":"^2.5.14","@socketsecurity/bun-security-scanner":"^1.1.3"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sports-mcp-server_0.2.3_1790764656693_0.018763294728059376"}}},"time":{"created":"2026-06-05T12:36:07.739Z","modified":"2026-09-30T10:37:36.959Z","0.1.1":"2026-06-05T12:36:08.192Z","0.1.2":"2026-06-07T06:41:33.548Z","0.1.3":"2026-06-13T04:43:45.818Z","0.1.4":"2026-08-21T16:10:50.311Z","0.2.0":"2026-08-30T21:51:48.425Z","0.2.1":"2026-08-31T02:47:58.740Z","0.2.2":"2026-09-22T04:11:21.199Z","0.2.3":"2026-09-30T10:37:36.788Z"},"bugs":{"url":"https://github.com/cyanheads/sports-mcp-server/issues"},"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/sports-mcp-server#readme","keywords":["sports","nfl","nba","mlb","nhl","soccer","scores","schedules","standings","espn","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"repository":{"url":"git+https://github.com/cyanheads/sports-mcp-server.git","type":"git"},"description":"Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"
\n

@cyanheads/sports-mcp-server

\n

Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.\n

7 Tools
\n

\n
\n\n
\n\n[![Version](https://img.shields.io/badge/Version-0.2.3-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/sports-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.1.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/sports-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/sports-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.2%2B-blueviolet.svg?style=flat-square)](https://bun.sh/)\n\n
\n\n
\n\n[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/sports-mcp-server/releases/latest/download/sports-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=sports-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvc3BvcnRzLW1jcC1zZXJ2ZXIiXX0=) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22sports-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Fsports-mcp-server%22%5D%7D)\n\n[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)\n\n
\n\n---\n\n## Overview\n\nLive and historical sports data from ESPN, MLB StatsAPI, and TheSportsDB. Look up teams and players, check scores, schedules, and standings across NFL, NBA, MLB, NHL, and major soccer leagues from any MCP client. Runs as a stdio process or a local Streamable HTTP server.\n\n### Tools\n\n| Tool | Description |\n|:-----|:------------|\n| `sports_find_team` | Resolve a team name or partial name to canonical records and source IDs across providers. |\n| `sports_find_player` | Resolve a player name to canonical TheSportsDB records with ID, team, position, and bio fields. |\n| `sports_get_scores` | Live and final scores for a league on a given date, optionally filtered by team. |\n| `sports_get_schedule` | Upcoming and past fixtures for a team or league over a date range. |\n| `sports_get_standings` | Current standings or league table for a league and season. |\n| `sports_get_team` | Team detail combining metadata, roster, recent results, and upcoming fixtures. |\n| `sports_get_player` | Player details from TheSportsDB — biography, team, position, and physical stats. |\n\n## Capability reference\n\n### `sports_find_team` tool\n\n- Free-text `query` (max 200 characters) with an optional `league` filter\n- Returns team metadata and merged `espnId`/`mlbId`/`tsdbId` cross-references; `no_match` when no provider finds a team\n\n---\n\n### `sports_find_player` tool\n\n- Free-text `query` (max 200 characters); optional `sport` is advisory and does not filter matches\n- Returns player IDs, name, team, position, nationality, birth date, and thumbnail; `no_match` when TheSportsDB finds no player\n\n---\n\n### `sports_get_scores` tool\n\n- `league` required; `date` (YYYY-MM-DD) defaults to today; optional `team_name` filters to one team's game\n- Returns home/away teams, score, status, period or clock, and UTC start time; no games returns `games: []` with a `reason`\n\n---\n\n### `sports_get_schedule` tool\n\n- `league` required; optional `team_name`, and `date_from`/`date_to` (YYYY-MM-DD, inclusive)\n- Returns home/away teams and scores, status, UTC start time, venue, and source; `team_not_found` when the team doesn't resolve in the league\n- Paired league-wide bounds are sent upstream; no bounds or one bound keep the provider-default fetch and local filtering. MLB range results preserve provider calendar dates, including games starting the next UTC day\n\n---\n\n### `sports_get_standings` tool\n\n- `league` required; optional `season` (4-digit year) — omit for the current season\n- Returns rank, wins, losses, ties, points, winning percentage, division rank, streak, and games behind; an explicit season with no data returns `season_not_found`\n\n---\n\n### `sports_get_team` tool\n\n- `league` and `team_name` required (fuzzy match on name, abbreviation, or location)\n- Returns metadata, active roster, up to 5 completed results, and up to 3 upcoming fixtures; `team_not_found` when the team doesn't resolve in the league\n\n---\n\n### `sports_get_player` tool\n\n- `player_id` accepts a `tsdb:`-prefixed ID (from `sports_find_player`) or a raw numeric TheSportsDB ID\n- Returns biography, team, position, nationality, birth date, height, weight, and thumbnail; `player_not_found` when the ID doesn't resolve\n\n## Features\n\nBuilt on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): stdio and Streamable HTTP transports, pluggable auth (`none` / `jwt` / `oauth`), swappable storage (`in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`), structured logging with optional OpenTelemetry tracing.\n\nSports-specific:\n\n- Three keyless sources — ESPN site API, MLB StatsAPI, and TheSportsDB (free tier key `3`) — no required API credentials\n- Internal league routing table sends each query to the best source per sport; callers never reference an upstream API directly\n- Normalized output types across all sources — `NormalizedGame`, `NormalizedTeam`, `NormalizedPlayer`, `NormalizedStanding` — with source provenance on every record\n- Cross-source team IDs merged onto one canonical record by `sports_find_team`, deduplicated by display name\n- Graceful off-season handling — empty standings return an enrichment notice rather than an error; empty scoreboards return `games: []` with a `reason` string\n- Upstream operations use 10-second attempts and a 30-second total retry budget, including body reads and backoff, with up to four attempts for fast transient failures. Composite tools can make several such operations\n\nAgent-friendly output:\n\n- Source provenance on every record — `source: 'espn' | 'mlbstats' | 'thesportsdb'` — so agents can reason about data authority\n- Structured `reason` field on empty score responses, and an enrichment notice on off-season standings, so agents can explain results without treating them as errors\n- Cross-source IDs surfaced by `sports_find_team` — `espnId`, `mlbId`, `tsdbId` — identify the same team across providers; team-scoped tools resolve `team_name` independently\n- Typed error reasons (`no_match`, `team_not_found`, `player_not_found`, `season_not_found`) each carrying an actionable recovery hint\n- Upstream HTTP errors retain their status and bounded diagnostics; ESPN scoreboard input rejections include date/bounds guidance. Optional-source outages degrade gracefully, while input rejections and cancellation propagate\n- Formatted provider fields stay on their authored lines, and full player biographies appear in text fences; structured values remain verbatim. Provider content is data, never instructions\n\n## Getting started\n\nAdd the following to your MCP client configuration file.\n\n```json\n{\n \"mcpServers\": {\n \"sports\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/sports-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\"\n }\n }\n }\n}\n```\n\nOr with npx (no Bun required):\n\n```json\n{\n \"mcpServers\": {\n \"sports\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cyanheads/sports-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\"\n }\n }\n }\n}\n```\n\nOr with Docker:\n\n```json\n{\n \"mcpServers\": {\n \"sports\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\",\n \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n \"ghcr.io/cyanheads/sports-mcp-server:latest\"\n ]\n }\n }\n}\n```\n\nFor Streamable HTTP, set the transport and start the server:\n\n```sh\nMCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http\n# Server listens at http://localhost:3010/mcp\n```\n\n### Prerequisites\n\n- [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+).\n- No API keys required — ESPN and MLB StatsAPI are fully keyless; TheSportsDB ships with a free public test key (`3`).\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/sports-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd sports-mcp-server\n```\n\n3. **Install dependencies:**\n\n```sh\nbun install\n```\n\n4. **Configure environment:**\n\n```sh\ncp .env.example .env\n# edit .env to override defaults (all optional)\n```\n\n## Configuration\n\n| Variable | Description | Default |\n|:---------|:------------|:--------|\n| `THESPORTSDB_API_KEY` | TheSportsDB API key. Replace with a paid key for higher rate limits. | `3` |\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |\n| `MCP_HTTP_PORT` | Port for HTTP server. | `3010` |\n| `MCP_SESSION_MODE` | HTTP session mode: `stateful`, `stateless`, or `auto` (resolves to stateful). The server declares `stateless` in source; an explicit value here overrides it. | `stateless` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |\n| `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |\n| `LOGS_DIR` | Directory for log files (Node.js only). | `/logs` |\n| `LOG_TOOL_FAILURE_PAYLOADS` | Log failed tool arguments and results, redacted by key name and capped by `LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES` (default `16384`). Free-form values are not redacted. | `false` |\n| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry). | `false` |\n| `OTEL_EXPORTER_OTLP_ENDPOINT` | Base OTLP/HTTP URL for traces and metrics. Signal-specific endpoints override it. | Unset |\n| `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` | Explicit OTLP log endpoint; the base endpoint does not enable log export. | Unset |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides.\n\n## Running the server\n\n### Local development\n\n- **Build and run:**\n\n ```sh\n # One-time build\n bun run rebuild\n\n # Run the built server\n bun run start:stdio\n # or\n bun run start:http\n ```\n\n- **Run checks and tests:**\n\n ```sh\n bun run devcheck # Lint, format, typecheck, security\n bun run test # Vitest test suite\n bun run lint:mcp # Validate MCP definitions against spec\n ```\n\n### Docker\n\n```sh\ndocker build -t sports-mcp-server .\ndocker run --rm -p 3010:3010 sports-mcp-server\n```\n\nThe Dockerfile builds with Bun, runs the production server under Node, defaults to HTTP transport and stateless session mode, and logs to `/var/log/sports-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.\n\n## Project structure\n\n| Directory | Purpose |\n|:----------|:--------|\n| `src/index.ts` | `createApp()` entry point — registers tools and inits services. |\n| `src/config` | Server-specific environment variable parsing (`THESPORTSDB_API_KEY`). |\n| `src/services/types.ts` | Normalized cross-source types and league routing table. |\n| `src/services/espn` | ESPN site API service — scores, schedules, standings, teams. |\n| `src/services/mlb` | MLB StatsAPI service — scores, schedules, standings, rosters. |\n| `src/services/thesportsdb` | TheSportsDB service — player and team search/metadata. |\n| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). |\n| `tests/` | Unit and integration tests mirroring `src/`. |\n| `docs/` | Design doc and directory tree. |\n\n## Development guide\n\nSee [`CLAUDE.md`/`AGENTS.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:\n\n- Handlers throw, framework catches — no `try/catch` in tool logic\n- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage\n- Register new tools via the barrel in `src/mcp-server/tools/definitions/index.ts`\n- Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields\n\n## Contributing\n\nIssues are welcome. Run checks and tests before submitting:\n\n```sh\nbun run devcheck\nbun run test\n```\n\n## License\n\nApache-2.0 — see [LICENSE](LICENSE) for details.\n","readmeFilename":"README.md"}