Skip to main content

​
Give your AI assistant live social data

The SociaVault MCP server connects your AI assistant directly to the SociaVault API using the Model Context Protocol — an open standard for plugging tools into AI clients. Once installed, Claude, Cursor, VS Code, Cline, and any other MCP-compatible client can pull real-time data from 11 platforms and reason over it, in plain English. It exposes 107 tools covering profiles, posts, comments, transcripts, search, trends, and ad libraries — every one mapped to a documented SociaVault endpoint.

npm package

sociavault-mcp on npm

MCP Registry

Listed on the official registry

Smithery

Install via Smithery

Full guide

Read the complete walkthrough

​
Installation

The server runs through npx, so there’s nothing to install globally — your client fetches the latest version automatically.
1

Get your API key

Sign up at sociavault.com and copy your API key (format sk_live_...) from the Dashboard.
2

Add the server to your client

Pick your client below and add the configuration with your API key.
{
  "mcpServers": {
    "sociavault": {
      "command": "npx",
      "args": ["-y", "sociavault-mcp"],
      "env": {
        "SOCIAVAULT_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}
Claude Desktop config location — macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json. Cursor: ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project). VS Code: .vscode/mcp.json.
3

Restart and ask a question

Restart your client and try: “Get the TikTok profile for @nike.” If you get back follower counts and bio details, you’re live.
Your AI assistant now has live access to social media data across 11 platforms.

​
Configuration

​
SOCIAVAULT_API_KEY
string
required
Your SociaVault API key (sk_live_...). Get one at the Dashboard.
​
SOCIAVAULT_BASE_URL
string
Optional override for the API base URL. Defaults to https://api.sociavault.com.

​
Example prompts

The model picks the right tool automatically — you just describe what you want:
“Compare the follower counts and engagement of @cristiano on Instagram vs. his YouTube channel.”
“Search the Meta Ad Library for active Nike ads in the US and summarize their angles.”
“Get the transcript of this YouTube video and turn it into a LinkedIn post: <url>”
“Pull the last 30 posts from r/webscraping and tell me the recurring pain points.”
“What’s trending on TikTok in the US right now, and which sounds are surging?”

​
What’s included

All tools are read-only. Most accept a trim option (on by default) that returns a smaller, AI-friendly payload to conserve context-window tokens. List endpoints support cursor pagination.

TikTok

Profiles, videos, comments, transcripts, search, music, trending

Instagram

Profiles, posts, reels, comments, transcripts, highlights

YouTube

Channels, videos, shorts, transcripts, search, comments

Twitter / X

Profiles, tweets, replies, quotes, retweets, search

LinkedIn

Profiles, companies, posts

Facebook

Profiles, posts, reels, groups, comments, transcripts

Reddit

Subreddits, posts, comments, transcripts, search

Threads, Pinterest, Twitch

Profiles, posts, pins, boards, clips, schedules

Ad libraries

TikTok, Meta, Google, and LinkedIn ad libraries

​
Pricing

The MCP server is free and open source. You only pay for the SociaVault API usage it makes, billed in credits — the same credit-based pricing as the REST API. New accounts start with free credits, and you can check your balance any time by asking your assistant to run the check_credits tool.

​
FAQ

Any MCP-compatible client, including Claude Desktop, Cursor, VS Code (Copilot), and Cline. The setup is the same everywhere: run npx -y sociavault-mcp with your API key in the environment.
Your key is stored in your own client’s config and sent only to the SociaVault API. The server is open source and read-only — it never posts or changes anything.
Yes — Node.js 18 or newer, since the server runs via npx. Most developer machines already have it.
Because it runs with npx -y sociavault-mcp, your client always fetches the latest published version. There’s nothing to update manually.

​
Need help?

Email Support

Get help from our team

Quickstart

Prefer raw REST? Start here