Skip to main content
Glama

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

import_media / check_import

Download media to hosted storage, get a direct link (optionally with a transcript)

transcribe_media / check_transcription

Speech-to-text with timestamped segments

get_metadata / check_metadata

Full metadata: formats, uploader, thumbnails, stats

get_basic_metadata / check_basic_metadata

Fast title/duration/thumbnail lookup

check_balance

Remaining credit balance

get_integration_guide

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

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)

  1. Get an API key at importly.io — $3.00 in free credits, no card required.

  2. Add the server to your MCP client, sending the key as an Authorization: Bearer header:

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_guide and 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 tools
check_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

    A4.2/5.0

    Scored across 9 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Turns 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.
      2
      43 npm
      MIT