Skip to main content
Glama

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

License

MIT License &copy; 2026 soclip

Available Tools

2 tools
get_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

    A3.6/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both follow the same get_<noun> pattern (get_video_media, get_balance), giving a predictable and readable convention across the whole tiny surface.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Transforms social media links (TikTok, Instagram, YouTube) and videos into text context with transcription, OCR, and metadata for AI agents like Claude and Cursor.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      1
      MIT