voiceos-sports
Provides NBA live scores, schedules, standings, team information, player stats, and headlines through ESPN's public data endpoints.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Sports for VoiceOS — live multi-sport companion
A voice-first sports companion that runs inside VoiceOS's notch as a local MCP integration. Ask what games are on, check live scores and box scores, follow your team, read standings, look up any player, and get headlines — across NFL, NBA, MLB, NHL, WNBA, college football & basketball, and soccer (EPL/UCL/MLS) — in native cards you can tap through. It knows when a league is off-season and labels last season's standings accordingly. No API key, no account, no login: it works the moment it's installed.
What it does
Seven voice tools, each returning a rendered native card:
Tool | Say | Card |
| "what games are on", "did the Lakers win" | Tappable scoreboard → tap a game for its box score |
| "how did the Chiefs game go" | Score by quarter, leaders, betting line, live win probability |
| "when do the Warriors play next" | Upcoming + recent slate |
| "how are the 49ers doing" | Team hub — GAMES / STANDINGS / PLAYERS tabs |
| "NBA West standings" | Ranked table with logos, records, win pct |
| "Patrick Mahomes stats" | Headshot + season stat line |
| "what's happening in the NBA" | Tappable headlines |
The scoreboard and team hub are in-card mini-apps: tap a game to open its detail without leaving VoiceOS, then tap back.
Related MCP server: SportScore
How it works
Data: ESPN's public JSON endpoints (
site.api.espn.com) — keyless, read-only public data, the same undocumented endpoints every third-party "ESPN MCP" wraps, called directly here so there's no extra hosted layer. One URL shape covers every sport, so the same normalisers serve all ten leagues. A paid provider (e.g. API-Sports) is a drop-in adapter behind them for higher rate limits and deeper history.Native cards:
cards.tscomposes the notch UI on the sharedwidgetKit.ts(vendored). Every tool result carries the rendered card under_voiceos_glance; the model always gets the underlying facts even if the card is dropped.Logos: NFL/NBA logos are baked into
logos.tsas smalldata:URIs; every other league's logos are fetched from ESPN and inlined on demand (ESPN's CDN isn't in the host CSP allowlist), deduped per card into one registry, with a step-down that trims the item count to stay under the host's HTML/glance caps.Season awareness: an off-season league (detected by month) is labeled — standings say "last season's final" and scores note when the season starts.
Runtime: a single self-contained
server.ts(Node/Bun native TypeScript, built-ins +fetchonly). Runtime-agnostic networking with acurlfallback.
Install
# copy into the VoiceOS custom integrations directory
cp -R . "$HOME/Library/Application Support/VoiceOS/custom-mcps/sports"Then register it in VoiceOS (or add a customMcpServers + installedIntegrations entry pointing cwd at the folder and running run.sh) and relaunch.
Layout
server.ts MCP server + ESPN data layer + tool definitions
cards.ts native notch cards (scoreboard, hub, box score, standings, player, news)
widgetKit.ts shared VoiceOS card kit (vendored)
logos.ts baked NFL + NBA team-logo atlas (data URIs)
mark.ts integration mark
run.sh launcher (prefers node)Built for the VoiceOS integration ecosystem.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
ESPN MCP — keyless multi-sport live scores, teams, and news via ESPN's public site API.
Live sports stats and pre-computed analysis for AI assistants across NBA, MLB, NFL, and NHL.
NBA, NFL, NHL and combined sports scores as agent tools.
Live sports data: scores, play-by-play, box scores, odds and props. No key needed to start.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceProvides comprehensive access to ESPN's sports APIs for live scores, team information, news, and statistics across NFL, NBA, MLB, NHL, college sports, and major soccer leagues with advanced filtering and real-time updates.14 npm-
- AlicenseAqualityBmaintenanceGives your MCP host (Claude Desktop, Cursor, Continue, Zed) access to live scores, match details, standings, top scorers, knockout brackets and player stats across football, basketball, cricket and tennis. Backed by the free public SportScore API — no key, no signup, CORS-open.8136 npm15MIT
- AlicenseAqualityDmaintenanceEnables access to live ESPN sports data for NFL, NHL, and NBA leagues, including standings, scores, schedules, team info, and playoffs through natural language queries.614 npm1MIT
- AlicenseNot gradedqualityBmaintenanceESPN MCP — keyless multi-sport live scores, teams, and news via ESPN's public site API.94 npmMIT