Changelog

​

Reading domain: full Instapaper archive

• GET /v1/reading/articles and GET /v1/reading/recent accept include_no_body=1 to include rows that exist but couldn’t be body-extracted (paywalled sources). Default hides them.
• Single-article responses include a body_unavailable flag for those placeholder rows so cards can render “read on source” instead of empty content.

​

Single-entity cards

• Article card — get_article — hero image, title, byline, read time, top highlights, link out to source.
• Artist card — get_artist_details — portrait, bio, total plays, all-time rank, yearly sparkline, top 5 tracks, top 3 albums, and similar artists scoped to your own scrobble history.
• Athlete card — get_attended_player — headshot, team logo, position, current-season stats, your-attended summary across every game you’ve seen them play, recent appearances. MLB-only for live stats; other leagues surface appearance history.

​

Listening

• Per-artist top tracks — GET /v1/listening/top/tracks accepts artist_id or artist_name to scope to a single artist. Combine with period for “what Olivia Rodrigo songs have I been listening to lately”.
• Extended artist detail — GET /v1/listening/artists/{id} now carries bio, last-played timestamp, all-time rank, distinct tracks/albums counts, similar artists, and a yearly sparkline.

​

Team logos and colors on attending responses

• New teams reference table seeded from MLB Stats API (roster, division, home venue) and ESPN (brand colors). 30 MLB teams to start; NFL, NBA, MLS, and NCAA can be added on the same shape.
• event_data.home_team and event_data.away_team on GET /v1/attending/events and GET /v1/attending/events/{id} now return a full team object with logo_url, logo_dark_url, logo_light_url, primary_color, secondary_color, ui_tint_color, conference, and division.
• primary_team on GET /v1/attending/players and GET /v1/attending/players/{id} replaces the old primary_team_id field with the full team shape.
• Per-game player appearances expose a team object instead of team_id, reflecting the in-game team — handles mid-season trades correctly without conflating with the player’s current primary team.
• Logos hot-link from mlbstatic.com SVG with on-light and on-dark cap variants; <picture> + prefers-color-scheme picks the right one in both Claude Desktop and iOS hosts.

​

Attending domain

• GET /v1/attending/events — list attended events with filters for category (sports / music / arts), event_type, season, year, venue_id, and attended (separates “I went” from “I bought tickets but didn’t go”).
• GET /v1/attending/events/{id} — single event with venue, multiple ticket rows, and league-specific event_data (scores, winning pitcher, my_team_won).
• GET /v1/attending/seasons/{league}/{season} — attended games in a sports season with W/L record. Counts only games you actually attended, not the team’s full record.
• GET /v1/attending/venues — venue catalog with city, capacity, and lat/long.
• GET /v1/attending/stats — counts by category, event_type, and year.
• Seven Gmail parsers — Ticketmaster, SeatGeek, Ticket Club, AXS, StubHub, VividSeats, and Eventbrite. Universal schema.org/EventReservation JSON-LD parser as a fallback.
• Sports enrichment via MLB Stats API (baseball) and ESPN (NFL, NBA, WNBA, MLS, NCAAF, NCAAB) attaches scores and outcomes to past games.
• Cross-domain link — concert performers can carry a lastfm_artist_id so a single artist row drives both your scrobble history and your concert attendance.
• Daily incremental sync at 4:00 AM Pacific. See Attending domain.

​

MCP server

• Article list UI for get_recent_reads via MCP Apps — titles, authors, domains, read time, excerpts, and thumbnails.
• Cover grid for get_top_albums and portrait grid for get_top_artists — both click through to Apple Music (or Last.fm when no match).
• Inline markdown links in search, semantic_search, find_similar_articles, get_recent_reads, get_top_artists, get_top_albums, and get_top_tracks — clickable in every client.
• Author names render correctly when a source article’s article:author tag is URL-shaped.
• get_top_artists accepts include_sparklines and forwards the new per-artist play-count series.

​

Listening

• Sparklines on top artists — pass include_sparklines=true to GET /v1/listening/top/artists to attach a zero-filled play-count series per artist. Supported for 1month, 3month, 6month, and 12month. See Listening domain.
• Album and artist artwork now resolves for ampersand-named artists like Matt & Kim, Simon & Garfunkel, and Hall & Oates.
• Listening image placeholders auto-expire after 7 days, matching reading-domain behavior.

​

Search

• GET /v1/search results now include image URLs and thumbhashes for listening, watching, collecting, and reading hits. The field was previously always null in keyword mode.

​

API discovery

​

Reading

• Reading articles now have thumbnails for most paywalled sources (NYT, Reuters, WSJ) via multi-tier OG extraction.
• description now falls back to og_description when the editorial field is null.
• POST /v1/admin/reenrich-reading gains a mode param: failed (default) or missing-images.
• Reading image placeholders auto-expire after 7 days (previously permanent).

​

MCP server

• Interactive poster grid for get_recent_watches via MCP Apps — renders inline in Claude Desktop, Claude web, VS Code GitHub Copilot, and Goose.
• Semantic and hybrid search for reading via new semantic_search and find_similar_articles tools; search gains a mode param (keyword | semantic | hybrid).
• Full article text via new get_article(id) tool — returns the Instapaper body, including paywalled NYT / WSJ / Atlantic.
• Instapaper deep-links on every reading article: instapaper_url (paywall-free web archive) and instapaper_app_url (iOS app).
• New prompts: letterboxd-review-draft, training-report, film-diet, and find-article.

​

API

• GET /v1/search?mode=keyword|semantic|hybrid — three ranking modes; semantic/hybrid are reading-only.
• GET /v1/reading/articles/{id} — gains content, instapaper_url, instapaper_app_url.
• GET /v1/reading/articles/{id}/related?limit=5 — related articles via semantic similarity.
• GET /v1/reading/highlights/{id} — highlight detail with parent-article context.
• All /recent endpoints: limit cap raised from 20 to 50, new page param for offset pagination.

​

MCP server

• 30 tools across all five domains: listening, running, watching, collecting, reading.
• Cross-domain search, unified feed, and on-this-day.
• Built-in prompt templates for weekly summaries, year-in-review, and period comparisons.
• Works with Claude Desktop, Claude Code, Claude iOS/web, and any MCP-compatible client.
• Local mode via npx or remote mode via mcp.rewind.rest.

​

Reading domain: delta sync

​

Reading domain

• GET /reading/articles — browse and filter articles by status, domain, or tag.
• GET /reading/currently-reading — articles in progress.
• GET /reading/highlights — highlighted passages across all articles.
• GET /reading/highlights/random — random highlight for a daily quote.
• GET /reading/stats — reading statistics and streaks.
• GET /reading/year/{year} — year in review.

​

Public API documentation

​

Apple Music enrichment

​

Watching: reviews, ratings, and last watched

• Movies endpoint now includes last_watched_at for sorting by when you last watched.
• Reviews and ratings from Letterboxd are now exposed via review, review_url, and user_rating fields on watch history entries.

​

Genres, on-this-day, and date filtering

• New GET /listening/genres endpoint with genre breakdown over time.
• Artists now tagged with genres from Last.fm (genre field on artist responses).
• New GET /feed/on-this-day endpoint for what happened on this date in previous years.
• Artist and album detail endpoints now include first_scrobbled_at.
• All recent, stats, and feed endpoints now accept date, from, and to query parameters.
• Album and artist artwork falls back to Deezer when Apple Music and iTunes don’t have a match.

​

Trakt physical media collection

• GET /collecting/media — list physical media collection.
• GET /collecting/media/:id — media item detail.
• GET /collecting/media/stats — collection statistics by format.
• GET /collecting/media/cross-reference — owned vs. watched comparison.

​

Cross-domain features

• GET /feed — unified activity feed with cursor-based pagination.
• GET /feed/domain/:domain — filter feed to a single domain.
• GET /search — full-text search across listening, running, watching, and collecting.
• GET /health — API health check.
• GET /health/sync — sync status for all domains.