Back to Browse

Soclip MCP Server

Developer ToolsModerate5.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

Turn TikTok, Instagram, X and Facebook URLs into video download links and metadata.

About

Turn TikTok, Instagram, X and Facebook URLs into video download links and metadata.

Security Report

5.8
Moderate5.8Moderate Risk

This is a well-structured MCP server for the Soclip video download API with appropriate authentication and minimal security concerns. The server properly requires API key authentication for all operations, uses secure credential handling with fallback to config files, and has appropriately scoped permissions for its purpose. Minor code quality improvements could be made around error handling and input validation. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

3 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

What You'll Need

Set these up before or after installing:

soclip API key from https://soclip.dev/dashboard (500 free credits on signup)Required

Environment variable: SOCLIP_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-huangyunbin-soclip": {
      "env": {
        "SOCLIP_API_KEY": "your-soclip-api-key-here"
      },
      "args": [
        "-y",
        "soclip-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

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

License

MIT License © 2026 soclip

Reviews

No reviews yet

Be the first to review this server!