Skip to content
LyricWinterdocumentation home

Get started

LyricWinter API and MCP server

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.

BetaUpdated

MarkdownAsk ChatGPTAsk Claude
QuickstartCreate an API key and turn a story into multi-voice audio with five requests.REST API referenceEvery beta endpoint with parameters, schemas, and copy-ready curl, JavaScript, and Python.MCP serverLet Claude, ChatGPT, Cursor, or any MCP client drive LyricWinter Studio for you.

Remote MCP server

Streamable HTTP · OAuth 2.1 or API key · Studio tools for agents

https://lyricwinter.com/mcp

LyricWinter turns written stories into fully cast audio: every character gets a distinct voice, narration and dialogue are directed, and sound effects are placed automatically. Developers can build on LyricWinter Studio in two ways:

  • The LyricWinter REST API (beta) at https://lyricwinter.com/api/v1, for scripts, backends, and apps.
  • The LyricWinter MCP server at https://lyricwinter.com/mcp, for AI agents such as Claude, ChatGPT, Cursor, VS Code, and Codex.

Both use the same Studio account, projects, and balance. Anything you create through one is visible in the other and in the Studio web app.

What can you build with the LyricWinter API?#

The LyricWinter API exposes the same Studio engine that powers the web and iOS apps:

  • Import stories. Create a standalone story or a multi-chapter project from plain text.
  • Generate multi-voice audio. One asynchronous workflow detects speakers, casts voices, directs emotion and delivery, places sound effects, and renders audio for up to 16 sections at a time.
  • Read and edit the script. Every section is a versioned document of narration and dialogue blocks that you can read and update without overwriting newer work.
  • Play and export. Stream per-block audio, compile a playback manifest, or export MP3, WAV, M4B, synchronized EPUB, or SRT files.
  • Share. Publish a section or a whole project at a stable public link.
  • Bring your own sounds. Upload sound effects and ambience, then let Create Audio place them.

Should I use the REST API or the MCP server?#

If you want to…Use
Automate audio production from your own code or backendREST API
Let an AI assistant create and manage Studio stories in conversationMCP server
Build a custom app or integration on top of StudioREST API
Connect Claude, ChatGPT, Cursor, VS Code, or Codex to your accountMCP server

The MCP server is a thin, authenticated layer over the REST API. It exposes 13 tools for the most common Studio tasks. The REST API covers more, including exports, sharing, and the sound library.

How does LyricWinter Studio work?#

  1. You create a project and add sections (chapters or scenes) of story text.
  2. A workflow prepares each section: it splits the text into narration and dialogue blocks, attributes every line to a speaker, and casts a voice for each character.
  3. The same workflow directs each performance and generates audio. You poll the workflow until it finishes.
  4. You play the result block by block, compile a playback manifest, or export a file.

Read Studio concepts for the full model, including versions and safe retries.

How much does it cost?#

API and MCP usage draws from the same word balance as the Studio app. Reading data is free. Creating audio consumes words from the account that owns the project. See pricing for plans and word packs, and check your balance in the dashboard.

Machine-readable resources#

Get help#

Email [email protected] and include the request_id from any failing response.