Skip to main content
Youka has an MCP server. MCP (Model Context Protocol) is the standard way AI assistants connect to outside tools. Once you connect it, you can ask your assistant things like “make a karaoke video of ~/Music/song.mp3” and it creates the project in your Youka account, waits for it to finish, and gives you the editor link or a download link. The server works with any MCP client that supports remote (Streamable HTTP) servers with a custom header, such as Claude Code, Cursor, and Codex.
Official Youka apps for ChatGPT and Claude are coming soon. Until then, use a client from this page with a Youka API key.

What you need

Server details:
Your API key gives full access to your Youka account and its credits. Keep it out of shared files and repositories. If a key leaks, delete it on your account page and create a new one.

Connect your assistant

Run this in your terminal, replacing YOUR_API_KEY with your key:
Check that it connected:
You should see youka: https://mcp.youka.io/mcp (HTTP) - ✔ Connected.By default the server is added for the current folder only. Add --scope user to use Youka in every folder.

Try it

Ask your assistant in plain language. For example:
A typical karaoke request goes like this:
1

Upload

The assistant asks Youka for an upload link and uploads your file. Uploading is free.
2

Check the cost

It checks how many credits the project will use and compares that with your balance.
3

Create the project

Youka removes the vocals and syncs the lyrics. This takes a few minutes. The assistant checks the status until the project is ready.
4

Edit or export

You get a link to open the project in the Youka editor. If you ask for the video file, the assistant exports it and gives you a download link.
Creating a project never renders a video by itself. You decide when to export, so you can fix the lyrics or style first, either in chat or in the Youka editor.

What the assistant can do

Credits and safety

  • Same credits as the web app. Creating a project, syncing lyrics again, and exporting cost the same as they do on online.youka.io.
  • Cost is checked first. If you don’t have enough credits, Youka refuses the request and says so. Nothing is charged.
  • No double charges. If the assistant retries a request after a timeout, Youka recognizes the retry and returns the original result instead of charging again.
  • Credits are bought on Youka. The assistant can’t buy credits. To add more, see Buy more credits.
  • Paid tools run only when you ask. The assistant is told to create projects, sync lyrics, or export only when you ask for it.

Troubleshooting

The API key is missing or invalid. Check that the header is exactly Authorization: Bearer yk_..., with one space after Bearer and no extra spaces or quotes inside the key. If you deleted the key on your account page, create a new one and update your client. For Codex and Cursor setups that read YOUKA_API_KEY, make sure the variable is set in the environment the app starts from.
Ask the assistant for your balance, or check it on online.youka.io. Then buy more credits and ask again.
Ask the assistant to show the project. It includes the error. Make sure the file is a supported audio or video file within the upload limits shown by your account.
Tell the assistant the correct lyrics and ask it to sync them again, or open the editor link and edit the lyrics yourself. Then export again.