# Mood Music Docs

> Documentation for Mood Music - Type a mood or a description of your day, and get back real Spotify playlists that match. Log in with Spotify to keep a history of your past searches.

- Documentation: https://mood-music-docs.thally.app
- GitHub: https://github.com/chikeozulumba/mood-music-docs
- Full docs for LLMs: https://mood-music-docs.thally.app/llms-full.txt
- Agent discovery (ai.txt): https://mood-music-docs.thally.app/ai.txt
- Structured docs index (JSON): https://mood-music-docs.thally.app/api/docs-index
- OpenAPI spec: https://mood-music-docs.thally.app/openapi.yaml

## For AI agents

Every page supports content negotiation on its human URL:
- JSON API: append `?format=json` or send `Accept: application/json`
- JSON-LD: append `?format=ldjson` or send `Accept: application/ld+json`
- Markdown: append `?format=md` or send `Accept: text/markdown`
- Per-page API: https://mood-music-docs.thally.app/api/docs/{page-id}
- Search API: https://mood-music-docs.thally.app/api/search?q={query}
- Capability manifest (skill): https://mood-music-docs.thally.app/skill.md
- Agent guidance (editing these docs): https://mood-music-docs.thally.app/AGENTS.md
- MCP server (attach docs as native tools): https://mood-music-docs.thally.app/api/mcp
- Agent readiness: https://mood-music-docs.thally.app/api/agent-readiness

### Recommended workflow

1. Use this index, the search API, or `search_sections` / `search_docs` before choosing a page.
2. Read the smallest set of relevant pages and follow their prerequisite links.
3. Treat the published docs as the source of truth. Label inferences and say when evidence is missing.
4. Cite the canonical human page URLs, not only API endpoints.
5. Use `/AGENTS.md` before editing a repository. The public MCP server is read-only.

## Get started

### Get started

- [Introduction](https://mood-music-docs.thally.app/): What Mood Music does, how it's built, and who this documentation is for.
- [Quickstart](https://mood-music-docs.thally.app/quickstart): Run Mood Music locally and get back your first real playlist recommendation.
- [Deploying to Cloudflare](https://mood-music-docs.thally.app/deploying): Ship Mood Music to a real Cloudflare Worker, on your own domain or the default workers.dev URL.
- [Troubleshooting](https://mood-music-docs.thally.app/troubleshooting): A quick index to every common failure mode, organized by what you were doing when it broke.
- [Authentication](https://mood-music-docs.thally.app/api/authentication): How to authenticate requests, and how to document your own scheme.
- [Overview](https://mood-music-docs.thally.app/api/introduction): What this API reference covers and how to try every request live.

## Guides

### Guides

- [Spotify login: setup and troubleshooting](https://mood-music-docs.thally.app/guides/spotify-oauth): Add Spotify login for persistent search history, and fix the most common redirect URI errors.