{"skill":{"slug":"karadeo","displayName":"Transcribe audio/video to LRC, SRT, WebVTT, ASS, TTML and create karaoke videos","summary":"Transcribe audio or video files to time-synced lyrics or subtitle formats like LRC, SRT, WebVTT, ASS, and TTML, and create karaoke videos.","description":"# Karadeo — Agent & AI Integration Guide\n\nKaradeo is a karaoke and lyrics tooling platform. This document describes all available\nAPIs, tools, and agent integration surfaces.\n\n## Authentication\n\nAll API endpoints require a Bearer API key from https://karadeo.com/dashboard.\n\n```\nAuthorization: Bearer kd_<your-api-key>\n```\n\n---\n\n## MCP Server\n\nKaradeo exposes a full MCP (Model Context Protocol) server for AI agent tool use.\n\n**Endpoint:** `POST https://karadeo.com/api/mcp`  \n**Transport:** Streamable HTTP (JSON-RPC 2.0)  \n**Discovery:** `https://karadeo.com/.well-known/mcp/server-card.json`\n\n### Initialize\n\n```json\n{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{}}\n```\n\n### List Tools\n\n```json\n{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/list\",\"params\":{}}\n```\n\n### Call Tool\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"transcribe\",\n    \"arguments\": {\n      \"audio_url\": \"https://example.com/song.mp3\",\n      \"format\": \"lrc\"\n    }\n  }\n}\n```\n\n---\n\n## REST API\n\n### Transcribe\n\nConvert audio or video to time-synced lyrics or subtitle files.\n\n**Endpoint:** `POST https://karadeo.com/api/transcribe`  \n**Docs:** https://karadeo.com/resources/karadeo-lyrics-api  \n**OpenAPI:** https://karadeo.com/api/doc\n\n**Request body (JSON):**\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `fileUrl` | string | yes | Publicly accessible audio/video URL |\n| `format` | string | no | `lrc`, `srt`, `ass`, `webvtt`, `ttml`, `txt` (default: `lrc`) |\n| `transcriptText` | string | no | Known lyrics to align instead of auto-transcribing |\n| `isWordLevel` | boolean | no | Word-level timing (default: false) |\n\n**Example:**\n\n```bash\ncurl -X POST https://karadeo.com/api/transcribe \\\n  -H \"Authorization: Bearer kd_your_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"fileUrl\":\"https://example.com/song.mp3\",\"format\":\"lrc\"}'\n```\n\n**Response:** Plain text subtitle file with appropriate Content-Type header.\n\n---\n\n## WebMCP (Browser)\n\nKaradeo registers browser tools via `navigator.modelContext.registerTool()` on every page load.\n\nAvailable tools:\n- `list-karaoke-tools` — list all Karadeo tools with URLs\n- `navigate-to-tool` — navigate to a specific tool page\n- `list-karaoke-templates` — list available karaoke video templates\n\n---\n\n## Discovery Endpoints\n\n| Endpoint | Description |\n|----------|-------------|\n| `/.well-known/agent-skills/index.json` | Agent Skills Discovery index (RFC v0.2.0) |\n| `/.well-known/mcp/server-card.json` | MCP Server Card (SEP-1649) |\n| `/.well-known/api-catalog` | API Catalog (RFC 9727) |\n| `/.well-known/oauth-authorization-server` | OAuth discovery metadata (RFC 8414) |\n\n---\n\n## Content Policy\n\n```\nContent-Signal: ai-train=no, search=yes, ai-input=no\n```\n\nAI agents may read this site for tool use. Training on site content is not permitted.\n","tags":{"latest":"1.0.1"},"stats":{"comments":0,"downloads":346,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":2},"createdAt":1777822352807,"updatedAt":1778492838254},"latestVersion":{"version":"1.0.1","createdAt":1777873021279,"changelog":"- No user-visible changes; documentation and skill functionality remain unchanged in this version.","license":"MIT-0"},"metadata":null,"owner":{"handle":"weiqingtangx","userId":"s17b82g2vpjn2p61nfrk2ehaf9860796","displayName":"weiqingtangx","image":"https://avatars.githubusercontent.com/u/5905640?v=4"},"moderation":null}