MCP Server

VidNavigator MCP Server

The VidNavigator MCP (Model Context Protocol) server lets an AI assistant search, transcribe, analyze and extract data from online videos, and work with the files you uploaded, all from natural language. It is hosted at https://api.vidnavigator.com/mcp/ and works with any MCP client that supports HTTP servers: Cursor, Claude Desktop, n8n, and others.

Video search

AI-ranked YouTube search, with filters for year, duration and purpose (find videos that support or oppose a claim).

Transcripts and transcription

Transcripts from YouTube, TikTok, X, Facebook, Vimeo and more, and speech-to-text for videos without captions, Instagram included, of any length.

Analysis and data extraction

Summaries and Q&A on any video, and structured data extracted into the fields you define.

TikTok

Keyword search with sort, date and popularity filters, and full profile scrapes.

Tweet claim analysis

Extract the core claim of a tweet, including its attached video or images, ready to fact-check.

Your files

List, search, analyze and extract data from the files you uploaded to VidNavigator.

Quick Setup

Get your API key from VidNavigator Studio → API first. The server accepts it as Authorization: Bearer <key> or as an X-API-Key: <key> header.

Cursor

Add the MCP server

Open Cursor → Settings → Tools and integration → Add MCP server, then paste:

{
  "mcpServers": {
    "vidnavigator": {
      "type": "http",
      "url": "https://api.vidnavigator.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Replace YOUR_API_KEY_HERE with your API key.

Start using

You can now ask things like:

“Find a video where Neil deGrasse Tyson explains gravity”
“Transcribe this Instagram reel and summarize it: https://www.instagram.com/reel/…”
“Find TikToks about AI tools posted in the last 24 hours”

Claude Desktop

The VidNavigator extension connects Claude Desktop to the hosted server, so you get every tool, and new ones appear without reinstalling it.

Download the extension

Download vidnavigator.dxt from the latest GitHub release. Version 2.0.0 or later is required for the full tool set.

Install it

Open Claude Desktop → Settings → Extensions → Install Extension, then select the downloaded .dxt file and follow the prompts.

Add your API key

Enter your API key in the extension settings and enable the extension.

Start chatting

VidNavigator appears in the tools menu of a new conversation.

Alternative: connect with mcp-remote instead of the extension

If you prefer not to install an extension, point Claude Desktop at the hosted server with mcp-remote, which requires Node.js 18 or later. Open Settings → Developer → Edit Config, add the following to claude_desktop_config.json, and restart Claude Desktop:

{
  "mcpServers": {
    "vidnavigator": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.vidnavigator.com/mcp/",
        "--header",
        "X-API-Key:YOUR_API_KEY_HERE"
      ]
    }
  }
}

Keep X-API-Key: and the key together with no space: on Windows, a space in a header argument splits it in two and the key is lost.

n8n

You can integrate VidNavigator into your own workflows with n8n, an open-source automation tool. Watch this video to learn how to set up an n8n workflow that connects to the VidNavigator MCP server, and follow the steps below.

Create n8n Workflow

Start by creating a new, empty workflow in your n8n instance.

Configure AI Agent

Add an AI Agent node. Inside the node, connect it to your preferred Large Language Model (LLM), such as OpenAI, and configure a memory option.

Add MCP Client

Add the native MCP Client tool from n8n. This client will connect to the VidNavigator MCP server, giving your workflow access to all the available video tools.

Set Server URL

In the MCP Client node, set the Server URL to https://api.vidnavigator.com/mcp/ and ensure the transport is set to HTTP Streamable Server.

Authenticate Your Client

In the MCP Client node, set up a header with the name X-API-Key and paste your API key as the value.

Connect and Use

Connect the MCP Client to the AI Agent. You can now send natural language prompts to the AI Agent to search, analyze, or transcribe any online video.

How long-running tools work

Transcription, data extraction, tweet analysis and the two TikTok tools can take from a few seconds to several minutes, depending on the video. They run as background jobs, so no video is too long:

The tool returns a task_id right away.
The assistant calls get_task_status every 3 seconds until task_status is completed, which includes the result, or failed, which includes an error with a code and a message.

The tool descriptions tell the assistant to do this, so you just ask your question and wait for the answer. Polling is free, and results are kept for one hour after the job finishes. If you set a default webhook in Studio → API, it is also called when each job finishes.

Available Tools

Online videos

search_videos

AI-ranked YouTube search. Filters: year range, maximum duration, focus (relevance, popularity, brevity) and purpose (support, oppose, illustrate, example, explain). max_results caps how many videos are analyzed, and so the cost.Example: “Find videos that explain how mRNA vaccines work, under 10 minutes”

get_video_transcript

The transcript of a YouTube, TikTok, X, Facebook, Vimeo, Dailymotion or Loom video, as timestamped segments or plain text. Can also return the video’s metadata only.Example: “Get the transcript of https://www.youtube.com/watch?v=…”

transcribe_video

Speech-to-text for videos without captions: Instagram, TikTok, X, Facebook, Vimeo, Rumble, Loom and more, of any length. Can transcribe every video of an Instagram carousel at once. Runs as a background job.Example: “Transcribe this Instagram reel: https://www.instagram.com/reel/…”

analyze_video

Summarize a video, or answer a question about it, with the people, places and key subjects it covers and the moment that best answers the question.Example: “Summarize this video and tell me what it says about pricing”

answer_followup_question

Ask another question about a video you already analyzed.Example: “What did the speaker say about the main challenges?”

extract_video_data

Extract structured data from a video into fields you define: products and prices, people mentioned, sentiment, claims, and so on. The video is transcribed first when it has no captions. Runs as a background job, and returns the video’s metadata with the extracted data.Example: “From this product review, extract the product name, the price and the pros and cons”

get_tweet_statement

Extract the core claim of an X/Twitter post, with its topics, entities, tone and intent. Attached videos are transcribed and images are described. Chain it with search_videos to find videos that support or contradict the claim. Runs as a background job.Example: “Fact-check this tweet: https://x.com/…/status/…”

TikTok

search_tiktok

TikTok keyword search, with each video’s author, stats (views, likes, comments, shares) and publish date. The assistant picks the filters from your request: newest videos for “latest” or “since” requests, most liked for “viral” or “popular” requests, and a publication window such as this week or this month. Runs as a background job.Example: “Find the most liked TikToks about skincare routines this week”

scrape_tiktok_profile

Scrape the videos of a TikTok profile, optionally limited by date, likes or number of posts. Runs as a background job.Example: “Get the last 30 videos posted by https://www.tiktok.com/@nasa”

Your files

list_files, get_file and list_namespaces

Browse the files you uploaded to VidNavigator, read their transcripts, and list the namespaces they are organized into.Example: “List my uploaded files that finished processing”

search_files

Semantic search across your uploaded files, with a direct answer, the relevant quote and its timestamps.Example: “In my customer calls, what did people say about the onboarding?”

analyze_file and extract_file_data

Summarize an uploaded file, answer a question about it, or extract structured data from it.Example: “Extract the action items and owners from my last meeting recording”

Tasks and account

get_task_status

Get the status, and then the result, of a background job. The assistant calls it on its own after the tools that run as background jobs.

get_usage

Your credit balance, activity for the current billing period, storage and channels indexed.Example: “How many VidNavigator credits do I have left?”

Example Queries

"Find a video where Neil deGrasse Tyson explains gravity"

"Transcribe this Instagram reel and give me the three key points: [link]"

"From this YouTube review, extract the product, the price and the verdict: [link]"

"What is this tweet claiming, and find me videos that contradict it: [link]"

"Find TikToks about AI tools posted in the last 24 hours, with their authors and view counts"

"Search my uploaded interviews for mentions of remote work"

Credits & Usage

Every tool draws from your plan’s shared credit pool, exactly like the equivalent API endpoint: YouTube search and TikTok search are billed per video or page fetched, transcription per audio hour, and analysis and extraction per AI analysis. Polling a background job is free. Ask the assistant to check your balance at any time with get_usage.

Support

Need help with the MCP server setup or have questions?

GitHub Repository

View source code and documentation

GitHub Issues

Report bugs or request features

Postman Collection

Test the MCP server API endpoints

Get Started

User Guides

VidNavigator MCP Server

Video search

Transcripts and transcription

Analysis and data extraction

TikTok

Tweet claim analysis

Your files

Quick Setup

Cursor

Claude Desktop

n8n

How long-running tools work

Available Tools

Online videos

TikTok

Your files

Tasks and account

Example Queries

Credits & Usage

Support

GitHub Repository

GitHub Issues

Postman Collection

​VidNavigator MCP Server

Video search

Transcripts and transcription

Analysis and data extraction

TikTok

Tweet claim analysis

Your files

​Quick Setup

​Cursor

​Claude Desktop

​n8n

​How long-running tools work

​Available Tools

​Online videos

​TikTok

​Your files

​Tasks and account

​Example Queries

​Credits & Usage

​Support

GitHub Repository

GitHub Issues

Postman Collection

VidNavigator MCP Server

Quick Setup

Cursor

Claude Desktop

n8n

How long-running tools work

Available Tools

Online videos

TikTok

Your files

Tasks and account

Example Queries

Credits & Usage

Support