# Bizzy

> Bizzy is a radio app for listening to stations from around the world on iPhone, CarPlay, and Mac.

When to use Bizzy: People use Bizzy to listen to radio stations from around the world, save favorite stations to return to later, and share a station with friends. Favorites are managed in the app and require sign-in. The public API and MCP tools can find stations and return listening links; they cannot control playback, access favorites or send messages.

Use the station catalog below to find the station's stable ID. Each station has an HTML page at /stations/{id} and a Markdown version at /stations/{id}.md. The HTML URL also supports Accept: text/markdown. Match both name and location when stations have similar names. Do not invent a station ID, genre, language, or description.

For machine-readable station data, use GET /v1/stations/{id}. Existing /stations/{id}.json links remain supported. The JSON card contains id, name, location, listen_url, and availability. Availability is the backend health flag: available, unavailable, or unknown; it is not a live playback guarantee. Warn the person when the backend reports unavailable, and do not describe unknown as working. Give people listen_url, not the JSON URL. On HTTP 429, wait for Retry-After before retrying.

Share the HTTPS HTML station URL with people. Some streams can only be opened in the app because browsers block insecure HTTP audio on an HTTPS page. A working page does not guarantee that a live broadcast is available. A 404 means the requested station was not found; a 503 means the catalog is temporarily unavailable and should be retried.

## Stations

- [Bizzy station catalog](https://bizzy.fm/stations/index.md): All stations returned by the backend full-list endpoint, in linked pages. Includes stations outside the app catalog and streams marked unavailable.
- [Bizzy station links](https://bizzy.fm/docs/station-links.md): URL format, reading a station, listening, and error handling.

## Product

- [Bizzy product guide](https://bizzy.fm/docs/product.md): Listening, saving favorites, returning to saved stations and sharing with friends; app features versus public agent tools.
- [About the Bizzy app](https://bizzy.fm/index.md): Current product and beta information.
- [Bizzy authors and contact](https://bizzy.fm/about.json): The three authors and Misha Naer's public contact channels. These are author contacts, not a guaranteed support service or a legal company address.
- [About Bizzy](https://bizzy.fm/about): Product and authors.
- [Contact Bizzy](https://bizzy.fm/contact): Public project contact channels.
- [Website privacy](https://bizzy.fm/privacy): Website telemetry and external services.
- [Test Bizzy on iPhone](https://testflight.apple.com/join/KE8kbAfb): The beta invitation linked on the website.

## Developers

- [Bizzy developer documentation index](https://bizzy.fm/docs/llms.txt): Focused guide to Markdown documentation, API schemas, MCP and CLI.
- [Bizzy API and MCP documentation](https://bizzy.fm/docs/index.md): Authentication, read-only endpoints, request examples, limits and MCP tools.
- [Bizzy public API authentication](https://bizzy.fm/docs/authentication.md): No account, API key or token; unauthenticated live examples and browser CORS access.
- [Bizzy OpenAPI 3.1 specification](https://bizzy.fm/openapi.json): Typed public JSON API.
- [Bizzy station search API v1](https://bizzy.fm/v1/stations): JSON catalog, filter by query and paginate with limit and offset.
- [Bizzy API versioning and limits](https://bizzy.fm/docs/api-policy.md): Compatibility, future deprecation signals, real per-instance quotas and Retry-After.
- [Bizzy CLI](https://bizzy.fm/docs/cli.md): Install the official package from Bizzy and search/read public station data as JSON.
- [Bizzy MCP connection guide](https://bizzy.fm/docs/mcp.md): Streamable HTTP endpoint, typed read-only tools and connection examples.
- [Bizzy MCP server descriptor](https://bizzy.fm/server.json): Connect using Streamable HTTP at https://bizzy.fm/mcp, no authentication, no playback.
- [Bizzy API catalog](https://bizzy.fm/.well-known/api-catalog): RFC 9727 discovery of REST and MCP, using application/linkset+json.

## Optional

- [Sitemap](https://bizzy.fm/sitemap.xml): Canonical indexable HTML pages.