Yoinku MCP server
Give your AI agent video superpowers: structured metadata, full transcripts and download links for YouTube, TikTok and Instagram — as native MCP tools, no scraping code required.
Endpoint
A remote MCP server over Streamable HTTP. Every request is stateless JSON-RPC — no sessions to manage.
https://yoinku.com/mcpAuthentication
Authenticate with your Yoinku API key, sent as an x-api-key header or as a Bearer token — both work. Keys are free: create one on your account page.
Get an API keySetup
Claude Code (CLI)
claude mcp add --transport http yoinku https://yoinku.com/mcp \
--header "x-api-key: YOUR_API_KEY"Claude / other MCP clients (JSON config)
{
"mcpServers": {
"yoinku": {
"type": "http",
"url": "https://yoinku.com/mcp",
"headers": { "x-api-key": "YOUR_API_KEY" }
}
}
}Tools
Three tools, sharing the same daily quotas as the REST API.
Structured metadata for a video: title, description, channel, duration, view/like counts, tags, chapters and available subtitle languages.
- Parameters:
- url (required)
- Quota cost:
- 1 data request
The video's subtitles as a transcript: plain text plus timestamped chunks, ready for RAG and analysis. Creator subtitles are preferred over auto-generated captions.
- Parameters:
- url (required), lang (optional, e.g. "en" or "ja")
- Quota cost:
- 1 data request
Produces the video/audio file and returns a short-lived download URL. Formats: v-1080 / v-720 / v-480 / v-360 (MP4) and a-m4a / a-mp3 (audio).
- Parameters:
- url (required), format (required)
- Quota cost:
- 1 download — prepaid credits are used automatically after the daily quota
Quotas & pricing
The free tier includes 5 downloads and 10 data requests per day per account, shared across the web app, REST API and MCP. Need more? Prepaid packs start at $2.99 and subscriptions at $9/mo.
See plans & packsFAQ
- Which MCP clients are supported?
- Any client that speaks MCP over Streamable HTTP: Claude (claude.ai connectors and Claude Code), Cursor, Windsurf, custom agents built with the MCP SDKs, and more.
- How is this different from the REST API?
- Same engine, same API key, same quotas. MCP exposes the endpoints as tools your agent discovers and calls natively, so you skip writing HTTP glue code.
- What does it cost?
- The free tier is enough to try everything. Past that: one-time prepaid packs ($2.99 for 50 downloads, $9.99 for 250) or subscriptions (Hobby $9/mo, Pro $29/mo) raise the limits.
Prefer plain HTTP? The same tools are available as a REST API.
REST API docs