GetVidFB Downloader

Get direct download links (HD/SD MP4, audio, images, GIFs) for public Facebook videos and reels, TikTok videos without watermark, and Pinterest pins. Hosted remote server, free API key.

Hosted MCP Server

npx add-mcp 'https://api.getvidfb.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

GetVidFB MCP Server

Remote Model Context Protocol server that gives AI assistants (Claude, ChatGPT, Cursor, VS Code, Windsurf...) direct download links for public Facebook, TikTok and Pinterest posts.

This repository holds the server's public metadata and docs. The server itself is hosted, so there is nothing to install.

Tools

ToolInputReturns
facebook_download_linksurl of a public Facebook video, reel, watch/share link or photo postSD/HD MP4 with audio, separate video/audio tracks, thumbnail, title, duration
tiktok_download_linksurl of a public TikTok videoNo-watermark HD/SD MP4, music track, cover, title, author
pinterest_download_linksurl of a pin or Idea Pin (pinterest.com, pin.it)Videos, images and GIFs of every page

All tools are read-only. Private posts and Facebook Stories are not supported. Links point at the platforms' CDNs and expire after a few hours. Only download content you own or have permission to use.

Get an API key

  1. Create a free account at https://getvidfb.com/auth/register
  2. Copy your key (gvfb_...) from the dashboard

Free plan: 50 tool calls per day, reset at 00:00 UTC. initialize and tools/list work without a key.

The key can be sent as any of:

  • X-API-Key: gvfb_...
  • Authorization: Bearer gvfb_...
  • https://api.getvidfb.com/mcp?api_key=gvfb_... (for clients that only accept a URL)

Setup

Claude Code

claude mcp add --transport http getvidfb https://api.getvidfb.com/mcp --header "X-API-Key: gvfb_YOUR_KEY"

Cursor, VS Code, Windsurf, Claude Desktop

{
  "mcpServers": {
    "getvidfb": {
      "url": "https://api.getvidfb.com/mcp",
      "headers": { "X-API-Key": "gvfb_YOUR_KEY" }
    }
  }
}

Claude.ai / ChatGPT custom connector

Add a custom connector with the URL https://api.getvidfb.com/mcp?api_key=gvfb_YOUR_KEY.

Example

Get me the HD download link for https://www.facebook.com/reel/29099013063058043

The assistant calls facebook_download_links and gets JSON like:

{
  "success": true,
  "source": "FB-Reel",
  "title": "...",
  "thumbnail": "https://scontent...jpg",
  "duration": 15,
  "links": { "sd": "https://video...mp4", "hd": "https://video...mp4", "audio": "https://video...mp4" }
}

License

MIT