Repository avatar
Multimedia
v1.0.1
active

mira

io.github.Mira-AI-Tools/mira

Transcribe TikTok, Instagram Reels & YouTube videos: transcript, on-screen text, extract, download.

Documentation

Mira

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

Claude watching an Instagram Reel through the Mira MCP server and returning the recipe from it

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 MiraWith Mira
An assistant can't open an Instagram Reel linkWith the Mira MCP server, the assistant returns the recipe from the same Reel

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

PlatformLinks
TikTokvideos, photo carousels, vm.tiktok.com short links
InstagramReels, posts, carousels
YouTubeShorts and regular videos, long videos too
Pinterestvideo pins
X (Twitter)posts with video
Facebookpublic videos and reels
Web pagesarticles, recipes, any public page

Server

TransportStreamable HTTP (remote, nothing to install or run)
URLhttps://mira-ai-skill.pro/mcp
AuthAuthorization: Bearer mira_sk_… header, or your personal connector URL https://mira-ai-skill.pro/mcp/<key> with no header
Registryio.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.

ToolWhat it does
parse_videoWatches 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_resultReturns the extract of a video that was still processing, by its job_id.
get_accountShows 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.

Remote