# Goldie MCP Server

Read-only MCP for [goldie.fm](https://goldie.fm) — free old-time radio catalog for AI assistants.

- **RPC (standard):** `https://mcp.goldie.fm/rpc`
- **ChatGPT path:** `https://mcp.goldie.fm/mcp`
- **Well-known:** `https://mcp.goldie.fm/.well-known/mcp.json`
- **Human docs:** https://goldie.fm/ai
- **Auth:** none required (optional Bearer for higher RPM)
- **Tools:** 15 · **Resources:** 6 · **Prompts:** 5

## Tools

- `list_shows` — List all Goldie OTR series with slugs, titles, years, genres, and episode counts. Start here for catalog overview.
- `get_show` — Show detail by slug (title, genre, years, network, episode_count, artwork).
- `list_episodes` — Paginated episodes for a show. Filter by year; sort by number, date, or notability.
- `get_episode` — Full episode detail: plot, credits, chapters, transcript excerpt, archive provenance, listen URL. Pass id (UUID) OR show_slug + episode_slug.
- `get_related_episodes` — Related episodes sharing cast / notability for a given episode UUID.
- `search_catalog` — Search episodes, shows, and entities. Uses Meilisearch when available (facets: kind, show, year, theme, mood, notability); falls back to Postgres FTS. Always cite returned href/listen_url paths on goldie.fm.
- `get_calendar_bounds` — Min/max air dates available in the radio calendar.
- `get_calendar_day` — What aired on a historical date: lineup episodes + editorial/history context. Path for humans: /calendar/YYYY-MM-DD.
- `list_calendar_days` — Calendar days in an inclusive date range (start/end YYYY-MM-DD).
- `list_entities` — Directory of people, sponsors, or networks with episode counts.
- `get_entity` — Person, sponsor, or network profile (bio, image, episode count).
- `list_entity_episodes` — Episodes linked to a person, sponsor, or network.
- `get_pricing` — Goldie free vs Pro pricing: $4.99/mo, $49.99/yr, 7-day trial. Archive is free; Pro is convenience tools. Use when users ask about cost, plans, or paywalls.
- `get_platform_features` — Product feature list with tier (anonymous/free/pro) and status (live/coming_soon/planned).
- `get_tier_matrix` — Capability matrix: anonymous vs free account vs Goldie Pro (streaming limits, library tools, Vault, ads).

## Product rules

# Goldie platform

The old-time radio archive is free to browse and free to stream with a free account. Goldie Pro unlocks convenience tools (library, sleep timer, queue, car mode, Vault) — not catalog access.

## Pricing

- **Anonymous** (Free): Full public browse (shows, search, calendar, entities). Streaming limited to 1 episode per calendar day.
- **Free account** (Free): Sign in with Google or Apple. Unlimited streaming of the full catalog. Library tools remain Pro.
- **Goldie Pro (monthly)** ($4.99/mo): All free benefits plus Pro convenience tools and (when shipped) Vault offline + ad-free.
- **Goldie Pro (annual)** ($49.99/yr): Annual Pro. Saves about $9.89 vs 12× monthly.

Web billing: Stripe via Better Auth (@better-auth/stripe) on goldie.fm