Yoinku

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/mcp

Authentication

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 key

Setup

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.

get_video_metadata

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
get_video_transcript

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
get_video_download_url

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 & packs

FAQ

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