soclip-mcp
Enables extraction of direct video download URLs and detailed metadata from Facebook video links via the Soclip API.
Enables extraction of direct video download URLs and detailed metadata from Instagram video links via the Soclip API.
Enables extraction of direct video download URLs and detailed metadata from TikTok video links via the Soclip API.
soclip-mcp
Model Context Protocol (MCP) server for soclip.dev - allow AI assistants like Claude Desktop and Cursor to extract social video media direct links and metadata.
Overview
soclip-mcp connects LLMs with the Soclip API to analyze and retrieve direct video download URLs and metadata from TikTok, Instagram, X/Twitter and Facebook.
Get your API key at https://soclip.dev.
Docs for
soclip-mcp@0.1.4— last updated 2026-10-07. Plain-text docs for AI agents: https://soclip.dev/llms.txt
Related MCP server: Social → Context
Setup & Configuration
Claude Desktop
Add soclip to your claude_desktop_config.json (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"soclip": {
"command": "npx",
"args": ["-y", "soclip-mcp"],
"env": {
"SOCLIP_API_KEY": "your-api-key-here"
}
}
}
}Cursor
Add to your Cursor MCP settings (.cursor/mcp.json or Cursor Settings -> Features -> MCP Servers):
{
"mcpServers": {
"soclip": {
"command": "npx",
"args": ["-y", "soclip-mcp"],
"env": {
"SOCLIP_API_KEY": "your-api-key-here"
}
}
}
}Note: If you have already set up your key using the CLI (soclip config set-key <key>), soclip-mcp will automatically read ~/.soclip/config.json if SOCLIP_API_KEY is not present in env.
Available Tools
1. get_video_media
Extract direct video download URLs and detailed metadata from a social media video URL. Costs 2 credits ($0.002) per request.
Parameters:
url(string, required): The video link (TikTok, Instagram, X/Twitter or Facebook).
2. get_balance
Check your current account remaining credit balance.
Parameters: None.
Documentation
Full docs: https://soclip.dev/docs
Plain-text docs for AI agents: https://soclip.dev/llms.txt
Terminal CLI:
soclip-cli
License
MIT License © 2026 soclip
Available Tools
2 toolsget_balanceB
Check user account remaining credits balance.
Inputs: no named parameters.
get_video_mediaA
Extract video media direct links and metadata from social video URLs (supports TikTok, Instagram, X/Twitter and Facebook). Costs 2 credits.
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have entirely separate purposes: one extracts video media from social URLs, the other returns the account credit balance. There is no plausible way for an agent to confuse them.
Both follow the same get_<noun> pattern (get_video_media, get_balance), giving a predictable and readable convention across the whole tiny surface.
Two tools is thin even for a narrow media-extraction service; an agent gets the core fetch plus a balance check and nothing else. It is not an extreme mismatch, but the surface feels minimal.
The core read operation and credit check are covered, but there is no way to add credits or see pricing/history, so an agent that runs out of balance hits a dead end. Read-only scope limits the need for CRUD, but the lifecycle around credits is incomplete.
Maintenance
Related MCP Connectors
Instagram, TikTok, YouTube and other social media links to direct media download URLs.
Turn a TikTok/Instagram/YouTube link into text for your AI: metadata, transcript and image OCR.
Turn any video or audio link into files, transcripts and metadata, right from your AI agent.
Turn YouTube, TikTok, Instagram, Facebook, X and article URLs into transcripts, comments and JSON.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI agents to download, transcribe, and inspect video or audio URLs from YouTube, TikTok, X, and 1000+ other sites using server-side yt-dlp, residential proxies, and speech-to-text.927 npmMIT
- AlicenseNot gradedqualityDmaintenanceTransforms social media links (TikTok, Instagram, YouTube) and videos into text context with transcription, OCR, and metadata for AI agents like Claude and Cursor.MIT
- AlicenseAqualityCmaintenanceEnables coding agents to turn videos from social platforms or local files into a small set of distinct frames plus a manifest, so they can answer visual questions by reading image paths. Also provides metadata lookup for captions and authors without downloading the video.2MIT
- AlicenseAqualityCmaintenanceEnables agents to retrieve the contents of public social media posts — text, author, date, engagement counts, links, photos, and video frames — from X, Instagram, Threads, Facebook, LinkedIn, Bluesky, Mastodon, YouTube, Vimeo, Tumblr, Pinterest, and Reddit by simply passing a post URL. It works entirely without logins, cookies, or API keys, reading only what each site already exposes publicly.1MIT