Sociavault MCP server

SociaVault MCP Server

Give your AI assistant live access to social media data. This Model Context Protocol server lets Claude, Cursor, Cline, VS Code, and any MCP-compatible client pull real-time data from 11 platforms — profiles, posts, comments, transcripts, search, trends, and ad libraries — through natural language.

Powered by SociaVault — a reliable social media data API for developers.

Highlights

• 107 tools across TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Facebook, Reddit, Threads, Pinterest, Twitch, and Google.
• Ad library coverage — TikTok, Meta (Facebook/Instagram), Google, and LinkedIn ad libraries for competitor research.
• Zero install — runs via npx, no global install needed.
• Token-efficient — responses are trimmed by default to keep your context window lean.
• Built on the modern MCP SDK (1.x) with typed inputs, structured output, and clear error messages.

Quick start

1. Get an API key

Sign up at sociavault.com — new accounts get free credits to start. Copy your key (format sklive…) from the dashboard.

2. Add the server to your client

The server runs with npx, so there's nothing to install. Just add the config below and set your API key.

Claude Desktop

Edit your config file:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

{
  "mcpServers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": {
        "SOCIAVAULT_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Restart Claude Desktop.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):

{
  "mcpServers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": { "SOCIAVAULT_API_KEY": "sk_live_your_key_here" }
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": { "SOCIAVAULT_API_KEY": "sk_live_your_key_here" }
    }
  }
}

Cline / other clients

Any client that supports stdio MCP servers works — point it at the command npx -y sociavault-mcp with SOCIAVAULTAPIKEY in the environment.

Configuration

Usage examples

Once configured, ask your assistant things like:

• "Get the TikTok profile and last 20 videos for @charlidamelio."
• "Search the Meta Ad Library for active ads from Nike in the US."
• "Pull the transcript of this YouTube video: ."
• "What's trending on TikTok in the US right now?"
• "Find Instagram reels using this audio id and summarize the top performers."
• "Search Reddit for mentions of my product in the last week."
• "Get the comments on this tweet and summarize the sentiment."

Tools

All tools are read-only. Most accept a trim flag (default true) that returns a smaller, AI-friendly payload; set trim: false for the full raw response. List endpoints accept a pagination cursor returned in the previous response.

Shortened. The full README is on GitHub.