
mira
io.github.Mira-AI-Tools/mira
Transcribe TikTok, Instagram Reels & YouTube videos: transcript, on-screen text, extract, download.
Documentation
Video Transcript MCP Server for TikTok, Instagram Reels & YouTube — Mira
A remote MCP server that lets Claude, ChatGPT, Cursor, VS Code and any MCP client watch video links from
TikTok, Instagram, YouTube, Pinterest, X (Twitter) and Facebook: voiceover transcript, on-screen text, caption,
a structured extract, and the original video download.
Website · Connect · Tools · FAQ · Claude skill & plugin
Why
AI assistants can't open TikTok, Instagram or YouTube links: they hit a login wall or see only the page title. Mira watches the video for them. It transcribes the voiceover, reads on-screen text from key frames, takes the caption and returns one full extract, so the assistant answers from the whole video instead of guessing from the title.
| Without Mira | With Mira |
![]() | ![]() |
What you get
- Voiceover transcript: what was said in the video, in any language
- On-screen text: captions, subtitles and text overlays read from the frames
- Caption: the description under the post
- Structured extract: places with addresses and ratings, recipes with ingredients and steps, products, books, movies, workouts, study notes
- Original video file: the MP4, or every photo and video of a carousel (Extract + Video plan)
Supported platforms
| Platform | Links |
|---|---|
| TikTok | videos, photo carousels, vm.tiktok.com short links |
| Reels, posts, carousels | |
| YouTube | Shorts and regular videos, long videos too |
| video pins | |
| X (Twitter) | posts with video |
| public videos and reels | |
| Web pages | articles, recipes, any public page |
Server
| Transport | Streamable HTTP (remote, nothing to install or run) |
| URL | https://mira-ai-skill.pro/mcp |
| Auth | Authorization: Bearer mira_sk_… header, or your personal connector URL https://mira-ai-skill.pro/mcp/<key> with no header |
| Registry | io.github.Mira-AI-Tools/mira in the MCP Registry |
Your key and personal connector URL arrive on the setup page and by email after you subscribe. Keep them private: anyone with the URL can use your daily videos.
Connect
Claude (claude.ai, Desktop, mobile)
Settings → Connectors → Add custom connector → name it Mira and paste your personal connector URL. Start a new chat and paste a video link.
For better answers, also add the Mira skill: it tells Claude when to call the tools and how to use the extract.
ChatGPT
Settings → Apps & Connectors → Advanced settings → enable Developer mode → Create → paste your personal connector URL, authentication: none. Custom connectors are available on ChatGPT plans that support developer mode.
Claude Code
claude mcp add --transport http mira https://mira-ai-skill.pro/mcp \
--header "Authorization: Bearer mira_sk_your_key"
Or install the plugin, which bundles the server and the skill and asks for the key in its settings:
/plugin marketplace add Mira-AI-Tools/mira-skill
/plugin install mira@mira-ai-tools
Cursor
~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"mira": {
"url": "https://mira-ai-skill.pro/mcp",
"headers": { "Authorization": "Bearer mira_sk_your_key" }
}
}
}
VS Code (GitHub Copilot agent mode)
.vscode/mcp.json; VS Code asks for the key once and stores it securely:
{
"inputs": [
{ "type": "promptString", "id": "mira-key", "description": "Mira API key (mira_sk_…)", "password": true }
],
"servers": {
"mira": {
"type": "http",
"url": "https://mira-ai-skill.pro/mcp",
"headers": { "Authorization": "Bearer ${input:mira-key}" }
}
}
}
Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"mira": {
"serverUrl": "https://mira-ai-skill.pro/mcp",
"headers": { "Authorization": "Bearer mira_sk_your_key" }
}
}
}
Gemini CLI
~/.gemini/settings.json:
{
"mcpServers": {
"mira": {
"httpUrl": "https://mira-ai-skill.pro/mcp",
"headers": { "Authorization": "Bearer mira_sk_your_key" }
}
}
}
Other MCP clients (Cline, Codex, Zed, LibreChat, n8n, …)
Add a remote MCP server of type Streamable HTTP and use your personal connector URL as the server URL. It needs no headers, so it works in any client that accepts a URL.
Tools
All tools are read-only: they never change anything on your machine or in your accounts.
| Tool | What it does |
|---|---|
parse_video | Watches a TikTok, Instagram, YouTube, Pinterest, Facebook or X link (or a web page) and returns the transcript, on-screen text, caption and structured extract. On the Extract + Video plan, also a download link for the original video or every file of a carousel. Long videos return a job_id instead. |
get_result | Returns the extract of a video that was still processing, by its job_id. |
get_account | Shows your plan, today's usage and a link to manage or cancel the subscription. |
Short videos are ready in seconds; long ones take a few minutes and the assistant picks the result up with get_result.
What you can ask
"What's the recipe in this Reel? Turn it into a shopping list."
"List every place from this TikTok with addresses, I'm going to Tokyo next week."
"Transcribe this YouTube Short, translate it to English and summarize it in 3 bullets."
"Which products does this creator recommend, and what do they cost?"
"Break down this competitor's ad: hook, structure, call to action."
"Make study notes from this lesson."
FAQ
Is the server open source?
No. Mira is a hosted service: this repository holds the documentation and the registry entry (server.json), not the server code. There is nothing to install or run.
Do I need an API key? Yes, from a Mira subscription. Without a key the tools still connect and only explain how to subscribe; no video is processed.
How many videos can I watch? 20 videos a day on each plan. The same link asked again on the same day doesn't count twice.
Which videos work? Most public videos. Private, deleted or region-locked videos may not be available, because access depends on each platform.
What happens to the videos I send? Video files, transcripts and extracts are deleted from Mira's systems within 21 days. See the Privacy Policy.
I lost my key or connector URL. Get a new one at mira-ai-skill.pro/recover with the email you subscribed with.
Mira works with a Mira subscription — see mira-ai-skill.pro. Terms · Privacy · Refunds & cancellation · Support: support@mira-ai-skill.pro
Documentation in this repository is released under the MIT License.
No installation packages available.

