MLB stats · web + terminal + AI
Diamond turns the public MLB Stats API into a fast web app and a beautiful terminal app — both backed by DiamondGPT, an assistant that pulls live data to answer questions in plain English. No API key required for stats.
Free · open source · not affiliated with MLB
What's inside
The same data set, shaped for two places you actually work: a rich web app and a fast terminal UI.
Today's games with auto-refresh, linescores, boxscores, and probable pitchers.
Linescore, play-by-play with win probability, head-to-head series, recent form, and every highlight clip.
Condensed game, written recap, and every highlight clip — right on the game page.
Percentile sliders, expected stats (xBA/xSLG/xwOBA), WAR & wRC+, exit velo, barrel%, and hot/cold zone heat maps.
Career & year-by-year stats, splits, fielding, ZiPS projections, honors, and a percentile-ranked Statcast breakdown.
Record, division rank & streak up top — then game log, leaders, depth chart, roster, farm system, coaching, and news.
Line up to four players or two teams side by side — rate & counting-stat charts plus a full career table.
Browse AAA→Rookie, a club’s full farm system, and a player’s climb from Rookie ball to the majors.
Division and wild-card standings by league — MLB down through the minors — for any season.
League and per-team hitting & pitching leaders for any season and category.
Ask in plain English — the assistant calls 18 live MLB tools to answer with real data.
Call every MLB Stats API endpoint from a dynamic UI with a raw JSON viewer.
The web app
Built with React, Tailwind, and Recharts for a fast, responsive experience — from the live scoreboard to deep player profiles with year-by-year trend charts.
Go deeper
Beyond the scoreboard, Diamond drills all the way in: club hubs, percentile-ranked Statcast, walk-off game pages, and side-by-side comparisons.
DiamondGPT ✨
DiamondGPT answers in plain English by calling 18 live MLB tools — schedules, standings, leaders, player and team stats, splits, game logs, awards, the draft, win probability, and more. Real numbers, not guesses.
The terminal app
diamond.A Go CLI built with Bubble Tea. Run diamond for the interactive TUI, or jump straight to a view with a subcommand. Includes DiamondGPT and an MCP server.
brew install xavidop/tap/diamond
diamonddocker run --rm -it ghcr.io/xavidop/diamond:latest
# or a specific view:
docker run --rm -it ghcr.io/xavidop/diamond scoresgo install github.com/xavidop/diamond/cli@latestcd cli && go build -o diamond .
./diamond
diamond
diamond scores
diamond standings
diamond leaders
Live alerts
Press n on any game in the scoreboard and Diamond watches it for you — native desktop notifications when a run scores or the game goes final, even while you're in another view or another app.
n — fires from any viewModel Context Protocol
diamond mcp runs a Model Context Protocol server over stdio, exposing the same 18 live MLB tools DiamondGPT uses. Point Claude Desktop, your IDE, or any MCP client at it and your assistant can pull real baseball data — scores, standings, stats, and more.
diamond mcp{
"mcpServers": {
"diamond": {
"command": "diamond",
"args": ["mcp"]
}
}
}