English Français العربية

io.github.huangyunbin/soclip

Official registry Marketing and sales

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package soclip-mcp
Claude Code 
claude mcp add soclip -e 'SOCLIP_API_KEY=<your soclip_api_key>' -- npx -y soclip-mcp@0.1.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "soclip": {
            "command": "npx",
            "args": [
                "-y",
                "soclip-mcp@0.1.4"
            ],
            "env": {
                "SOCLIP_API_KEY": "<your soclip_api_key>"
            }
        }
    }
}

Environment variables

  • SOCLIP_API_KEY required secret soclip API key from https://soclip.dev/dashboard (500 free credits on signup)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. soclip-mcp
  2. Overview
  3. Setup & Configuration
  4. Available Tools
  5. Documentation
  6. License

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

Frequently asked questions

What is io.github.huangyunbin/soclip?

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

How do I install io.github.huangyunbin/soclip?

It runs on your machine. In Claude Code: claude mcp add soclip -e 'SOCLIP_API_KEY=<your soclip_api_key>' -- npx -y soclip-mcp@0.1.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.huangyunbin/soclip need an API key?

Yes. It expects SOCLIP_API_KEY, which you set in its configuration.

Is io.github.huangyunbin/soclip open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.huangyunbin/soclip?

It is published by huangyunbin. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.