# LyricalWriter

> AI songwriting studio: write production-ready lyrics with Gemini, ChatGPT or Claude, design cover art, build word-synced lyric videos and AI music videos, reimagine your own footage with Higgsfield Genjutsu, write social captions, manage playlists, and track releases from idea to live.

## For AI agents (MCP)

- Remote MCP server (Streamable HTTP): https://lyricalwriter.com/api/mcp
- Auth: OAuth 2.1 (discovered from the 401's resource metadata) or `Authorization: Bearer lw_...` (personal API key from Settings → API Keys)
- Smaller tool sets: `?profile=writer | studio | dj | release` (default `full`, 126 tools)
- OpenAI strict-mode schemas: `?schema=strict` (every property required, optional ones nullable)
- Retry safety: create tools accept `idempotencyKey`
- Resources: `lyricalwriter://help`, `lyricalwriter://song/{lyricId}`, `lyricalwriter://journey/{lyricId}`
- Start with `whoami`; "what's next for this song?" → `get_song_journey`; long jobs → `wait_for_render`
- Anything that spends credits, publishes, or deletes is two-step (confirmation token)
- Registry manifest: https://lyricalwriter.com/.well-known/mcp/server.json

## Docs

- Agent guide (setup, permissions, limits, every tool): https://lyricalwriter.com/help/mcp
- Help center: https://lyricalwriter.com/help
- Pricing: https://lyricalwriter.com/#pricing
- About: https://lyricalwriter.com/about