# LyricWinter > LyricWinter turns stories into fully cast, multi-voice audio with distinct character voices, directed performances, and sound effects. Developers and AI agents can drive LyricWinter Studio through a beta REST API and a remote MCP server. Notes for agents and developers: - The LyricWinter REST API is in beta. Base URL: https://lyricwinter.com/api/v1. Authenticate with `Authorization: Bearer lw_...`; users create scoped keys at https://lyricwinter.com/dashboard under Developers. - Read the OpenAPI 3.1 contract at https://lyricwinter.com/api/v1/openapi.json instead of guessing endpoints, fields, or enum values. - The remote MCP server is https://lyricwinter.com/mcp (Streamable HTTP, OAuth 2.1 with PKCE, or a Studio-scoped API key as a bearer token). - Studio work is asynchronous: start a workflow, then poll it until its status is completed, partially_completed, failed, or cancelled. Creating audio consumes the account's balance, so never repeat a start request with a new client_mutation_id unless the user wants another run. - Every docs page has a Markdown version at the same URL plus `.md`. Requests that send `Accept: text/markdown` to a docs URL also receive Markdown. ## Get started - [LyricWinter API and MCP server](https://lyricwinter.com/docs.md): Build with LyricWinter Studio from code or from an AI agent. The REST API (beta) and the remote MCP server turn stories into fully cast, multi-voice audio. - [Quickstart](https://lyricwinter.com/docs/quickstart.md): Create an API key, add a story, generate multi-voice audio, and fetch playback with the LyricWinter REST API in about ten minutes. - [Authentication](https://lyricwinter.com/docs/authentication.md): Authenticate LyricWinter API requests with scoped lw_ API keys, choose the right scopes, and understand how MCP clients connect through OAuth 2.1. ## Guides - [Studio concepts](https://lyricwinter.com/docs/studio-concepts.md): How LyricWinter Studio models stories as projects, sections, versioned documents, speakers, and asynchronous workflows, and how to edit them safely over the API. - [Errors and retries](https://lyricwinter.com/docs/errors-and-retries.md): The LyricWinter API response envelope, error codes, request IDs, retry rules, idempotency keys, and client mutation IDs for safe retries of paid operations. ## API reference - [API overview](https://lyricwinter.com/docs/api.md): Base URL, authentication, response envelope, and every endpoint group in the LyricWinter REST API beta, generated from the public OpenAPI 3.1 contract. - [Account and API keys](https://lyricwinter.com/docs/api/account.md): Check API health, read the account behind an API key, and create, list, or revoke scoped API keys. - [Projects](https://lyricwinter.com/docs/api/projects.md): A Studio project groups ordered sections (chapters) that share one cast of speakers. Standalone stories appear as unassigned stories until you turn them into a named project. - [Sections](https://lyricwinter.com/docs/api/sections.md): A section is one chapter or scene of story text inside a project. Create a standalone story with one section, add sections to a project, reorder them, or delete them. - [Documents and speakers](https://lyricwinter.com/docs/api/documents.md): Every section has a versioned document of narration and dialogue blocks attributed to speakers. Read the document before editing it or generating audio, and list the project's speakers and casting. - [Workflows](https://lyricwinter.com/docs/api/workflows.md): Workflows are durable, asynchronous jobs. A prepare workflow structures text into narration and dialogue; a Create Audio workflow casts voices and generates multi-voice audio. Poll a workflow until it reaches a terminal status. - [Media and playback](https://lyricwinter.com/docs/api/media.md): Read the generated audio state for a section, compile a playback manifest for the current document version, and mint short-lived URLs for individual media assets. - [Exports](https://lyricwinter.com/docs/api/exports.md): Render a section into a downloadable MP3, WAV, M4B, synchronized EPUB, or SRT file. Exports are pinned to the current document, cast, and mastering versions and run asynchronously; poll an export until its file is ready. - [Sharing](https://lyricwinter.com/docs/api/sharing.md): Publish a section or a whole project at a stable public link, read its sharing state, or revoke the link. - [Sound library](https://lyricwinter.com/docs/api/sounds.md): Upload your own sound effects and ambience into the Studio sound library, manage their metadata, and link them to projects so Create Audio can place them automatically. ## MCP server - [Connect an MCP client](https://lyricwinter.com/docs/mcp.md): Connect any MCP client to the remote LyricWinter Studio MCP server at https://lyricwinter.com/mcp using Streamable HTTP with OAuth 2.1 or a scoped API key. - [MCP tools reference](https://lyricwinter.com/docs/mcp-tools.md): Every tool exposed by the LyricWinter Studio MCP server, with inputs, required scopes, side effects, and the recommended agent workflow. ## Optional - [Full documentation in one file](https://lyricwinter.com/llms-full.txt): Every docs page above, concatenated as Markdown. - [OpenAPI 3.1 contract](https://lyricwinter.com/api/v1/openapi.json): Machine-readable schema for every public beta endpoint. - [LyricWinter Studio](https://lyricwinter.com/studio): The web app for editing, casting, and generating story audio. - [Pricing](https://lyricwinter.com/pricing): Plans and word balances that audio generation draws from. - [Use cases](https://lyricwinter.com/use-cases): Audiobooks, audio dramas, training role-plays, and other ways people use LyricWinter.