Importly MCP Server
This MCP server turns video/audio URLs into downloadable media, transcripts, and metadata through asynchronous Importly jobs.
Download media from YouTube, TikTok, X, podcasts, and 1000+ sites to hosted storage and get direct links, with optional audio/video quality and transcript.
Poll import jobs with
check_importto retrieve completed media URLs and transcripts.Extract full metadata such as title, description, duration, uploader, formats, thumbnails, and stats.
Fetch fast basic metadata: title, duration, and thumbnail only.
Transcribe media to text with timestamped segments, optional language hints, and a maximum cost cap.
Check the remaining Importly credit balance for diagnostics or pre-flight checks.
Use an async submit/check pattern: submit tools return a
jobId, and check tools poll for results.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Importly MCP Server Transcribe this talk and summarize the key points: https://www.youtube.com/watch?v=abc123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Importly MCP Server
Turn any video or audio link into files, transcripts and metadata, right from your AI agent: YouTube, TikTok, X, podcasts, and 1000+ other sites.
Importly is one API for your app, and the same key works in your agent over MCP. It works from agent sandboxes and cloud servers where downloads usually get blocked, so you never deal with blocked requests, broken downloaders, or videos without captions.
Tools
Tool | What it does |
| Download media to hosted storage, get a direct link (optionally with a transcript) |
| Speech-to-text with timestamped segments |
| Full metadata: formats, uploader, thumbnails, stats |
| Fast title/duration/thumbnail lookup |
| Remaining credit balance |
| Working code (Node, Next.js, Python, cURL) to add Importly to your own app: key setup, webhooks, polling, errors. No credits used |
Jobs are async: submit tools return a jobId, check tools poll it. Responses tell the agent exactly what to do next.
Transcripts use the video's own captions when it has them ($0.01). For media without captions, the agent can retry with provider: "importly" for AI speech-to-text ($0.02/min).
Related MCP server: TubePull – AI YouTube Downloader
Setup (hosted, recommended)
Importly runs this server for you at https://mcp.importly.io/mcp (Streamable HTTP). Nothing to install.
Claude.ai, ChatGPT, Claude Desktop
Add a custom connector with the URL https://mcp.importly.io/mcp, click Connect, and sign in to Importly (new accounts get $3.00 in free credits, no card required). No API key needed.
Coding agents (API key)
Get an API key at importly.io — $3.00 in free credits, no card required.
Add the server to your MCP client, sending the key as an
Authorization: Bearerheader:
Claude Code
claude mcp add --transport http importly https://mcp.importly.io/mcp --header "Authorization: Bearer your_key"Cursor
{
"mcpServers": {
"importly": {
"url": "https://mcp.importly.io/mcp",
"headers": { "Authorization": "Bearer your_key" }
}
}
}More clients (VS Code, Cline, …): setup guide.
This npm package is no longer maintained. The hosted server above runs the same tools and always has the latest version. The source here is kept for reference.
Example prompts
"Transcribe this talk and summarize the key points: https://www.youtube.com/watch?v=…"
"Download the audio of this podcast episode and give me a link"
"How long is this video and who uploaded it?"
"Add import-from-URL to our upload form using Importly" (the agent calls
get_integration_guideand writes the code, with the same API key read from your environment)
Pricing
Usage-based credits (downloads ~$0.01/MB, transcription per media minute) — see pricing. New accounts get $3.00 free.
Docs & support
MIT licensed. The server is a thin wrapper over the Importly API.
Available Tools
9 toolscheck_balanceAInspect
Check the remaining Importly credit balance for the configured API key. Use this to diagnose failed jobs (insufficient credits) or as a pre-flight check before large imports/transcriptions.
Inputs: no named parameters.
check_basic_metadataAInspect
Check the status of a get_basic_metadata job. Returns title, duration, and thumbnail once completed.
Inputs: jobId (required).
check_importAInspect
Check the status of an import_media job. Returns the media download URL (and transcript, if requested) once the job completes.
Inputs: jobId (required).
check_metadataAInspect
Check the status of a get_metadata job. Returns the full metadata object once completed.
Inputs: jobId (required).
check_transcriptionAInspect
Check the status of a transcribe_media job. Returns the transcript text and timestamped segments once completed.
Inputs: jobId (required).
get_basic_metadataAInspect
Fast-path metadata for a video/audio URL: title, duration, and thumbnail only. Cheaper and quicker than get_metadata — use this to identify or validate a media URL before importing or transcribing it. Async: poll check_basic_metadata with the returned jobId.
Inputs: url (required).
get_metadataAInspect
Extract full metadata for a video/audio URL (title, description, duration, uploader, formats, thumbnails, view counts) without downloading the media. Works on YouTube, TikTok, X, and 1000+ sites — no yt-dlp to run yourself. Async: poll check_metadata with the returned jobId. For just title/duration/thumbnail, prefer the faster get_basic_metadata.
Inputs: url (required).
import_mediaAInspect
Download the video/audio at any URL (YouTube, TikTok, X, and 1000+ sites) to hosted storage and get back a direct download link. Importly runs yt-dlp, rotating residential proxies, and ffmpeg server-side — no local tooling needed. Async: returns a jobId immediately; poll check_import for the result. Optionally also produce a transcript in the same job with includeTranscript.
Inputs: url (required), audioQuality, includeAudio, includeVideo, +3 more.
transcribe_mediaAInspect
Transcribe the audio of any video/audio URL (YouTube, TikTok, podcasts, and 1000+ sites) to text with timestamped segments. Importly handles the download, audio extraction, and speech-to-text server-side — no yt-dlp or ffmpeg needed. Async: returns a jobId immediately; poll check_transcription for the transcript. Costs scale with media length; set maxCostDollars to cap spend on long media.
Inputs: url (required), language, maxCostDollars.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Tools are clearly organized into four async operations (import, full metadata, basic metadata, transcription) each with a paired check tool, plus a balance check. The only ambiguity is between import_media with includeTranscript and transcribe_media, but descriptions clarify the intended use.
All tool names follow a verb_noun pattern with action verbs (import_media, get_metadata, transcribe_media) and check_ prefixed status tools (check_import, check_metadata, check_basic_metadata, check_transcription). The pattern is consistent and predictable.
With 9 tools, the server is well-scoped for its purpose: four async operations, four corresponding status checks, and a balance check. Each tool serves a distinct need without redundancy.
The server covers the core workflows of media import, metadata retrieval (full and basic), transcription, and balance monitoring. Minor gaps exist such as no job cancellation or listing, but these are not essential for the stated purpose.
Maintenance
Related MCP Connectors
15 media & data tools for AI agents: search, transcribe, subtitles, voiceover, translate & more.
YouTube for AI agents: transcripts, comments, video stats, channel monitor, Shorts captions.
YouTube transcripts, search, channel/playlist listings and upload tracking for AI agents.
YouTube transcripts, search, channels, playlists and bulk transcript jobs for AI agents. 14 tools.
Related MCP Servers
- AlicenseAqualityFmaintenanceEnables AI agents to inspect, plan, download, and postprocess media from YouTube and other sites using yt-dlp, with safety and full option support.2838 npm1MIT
- AlicenseNot gradedqualityCmaintenanceHosted MCP server that lets Claude, ChatGPT, Perplexity, Cursor and other AI assistants download videos as MP4 or audio as MP3/M4A from YouTube, TikTok, Instagram, Facebook, Vimeo, Twitch, SoundCloud and 6 more platforms. No install; free for 3 downloads a day.MIT
- AlicenseAqualityCmaintenanceTurns TikTok, Instagram, X/Twitter and Facebook post URLs into video download links plus metadata (title, author, duration, thumbnail), so AI agents can fetch social videos in one tool call.243 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables ChatGPT to download video and audio from YouTube, TikTok, Instagram, and other supported sites, returning temporary direct links plus metadata and quality options.MIT