Turn TikTok, Instagram, X and Facebook URLs into video download links and metadata.
Runs on your machine from its package; the steps are below.
At most: only reads or looks up information.
Odel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y soclip-mcp
MCP client config
{
"mcpServers": {
"soclip": {
"command": "npx",
"args": [
"-y",
"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.
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
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"
}
}
}
}
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.
get_video_mediaExtract direct video download URLs and detailed metadata from a social media video URL. Costs 2 credits ($0.002) per request.
url (string, required): The video link (TikTok, Instagram, X/Twitter or Facebook).get_balanceCheck your current account remaining credit balance.
soclip-cliMIT License © 2026 soclip