MCP Server - SociaVault API

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. Claude, Cursor, VS Code, Cline, ChatGPT, 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. There are two ways to connect, and they expose the exact same tools:

Local — runs on your machine via npx. Best for Claude Desktop, Cursor, VS Code, and Cline.
Remote (hosted) — our hosted server at https://mcp.sociavault.net/mcp. Nothing to install. Required for ChatGPT and handy for any client that connects to a remote MCP URL.

npm package

sociavault-mcp on npm

MCP Registry

Listed on the official registry

Smithery

Install via Smithery

Full guide

Read the complete walkthrough

Local install (Claude, Cursor, VS Code, Cline)

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

Get your API key

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"
      }
    }
  }
}

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

{
  "servers": {
    "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.

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.

Remote server (ChatGPT & other hosted clients)

Prefer not to install anything, or connecting from ChatGPT? Use our hosted server. It runs the same 107 tools and requires no local setup — you just point your client at a URL and supply your API key.

https://mcp.sociavault.net/mcp

Authentication

The hosted server bills usage to your account, so every request must carry your SociaVault API key. Provide it either way:

URL query — append ?apiKey=sk_live_your_key_here to the endpoint. Works with every client, including ones that can’t set custom headers.
Header — send x-api-key: sk_live_your_key_here (or Authorization: Bearer sk_live_...).

A key placed in the URL can show up in server logs and browser history. If your client supports custom headers, prefer the x-api-key header. Treat the URL as a secret either way, and rotate the key from your Dashboard if it leaks.

Connect from ChatGPT

ChatGPT’s custom MCP connectors require Developer Mode, available on paid ChatGPT plans (Pro, Business, Enterprise, Edu). This is an OpenAI setting, not a SociaVault one.

Enable Developer Mode

In ChatGPT, open Settings → Connectors → Advanced and turn on Developer mode.

Add a custom connector

Go to Settings → Connectors → Create, and enter:

Name: SociaVault
MCP Server URL: https://mcp.sociavault.net/mcp?apiKey=sk_live_your_key_here
Authentication: No authentication (your key is already in the URL)

Use it in a chat

Enable the SociaVault connector for your conversation, then ask something like “Get the TikTok profile for @nike.”

ChatGPT now pulls live social data through the hosted SociaVault server.

Connect from other clients

Any client that supports remote MCP servers (Claude, Cursor, and others) can use the hosted URL instead of the local npx setup — point it at https://mcp.sociavault.net/mcp?apiKey=sk_live_your_key_here.

Configuration

string

required

Your SociaVault API key (sk_live_...). Get one at the Dashboard.

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:

Creator research

“Compare the follower counts and engagement of @cristiano on Instagram vs. his YouTube channel.”

Competitor ad intelligence

“Search the Meta Ad Library for active Nike ads in the US and summarize their angles.”

Content repurposing

“Get the transcript of this YouTube video and turn it into a LinkedIn post: <url>”

Trend monitoring

“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

Profiles, companies, posts

Facebook

Profiles, posts, reels, groups, comments, transcripts

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

Which clients are supported?

Any MCP-compatible client. For local install (Claude Desktop, Cursor, VS Code Copilot, Cline), run npx -y sociavault-mcp with your API key in the environment. For ChatGPT — and any client that connects to a remote MCP URL — use the hosted server at https://mcp.sociavault.net/mcp instead.

Is my API key safe?

With the local install, your key stays in your own client’s config and is sent only to the SociaVault API. With the hosted server, your key is passed through our server to the API to authenticate the request — it isn’t stored. Either way the server is read-only: it never posts or changes anything. If you use the URL query method, prefer the x-api-key header where your client supports it, and rotate the key from your Dashboard if it leaks.

Do I need Node.js?

Only for the local install — Node.js 18 or newer, since it runs via npx. Most developer machines already have it. The hosted server (https://mcp.sociavault.net/mcp) needs nothing installed.

How do I update it?

Because it runs with npx -y sociavault-mcp, your client always fetches the latest published version. There’s nothing to update manually.

​Give your AI assistant live social data

npm package

MCP Registry

Smithery

Full guide

​Local install (Claude, Cursor, VS Code, Cline)

​Remote server (ChatGPT & other hosted clients)

​Authentication

​Connect from ChatGPT

​Connect from other clients

​Configuration

​Example prompts

​What’s included

TikTok

Instagram

YouTube

Twitter / X

LinkedIn

Facebook

Reddit

Threads, Pinterest, Twitch

Ad libraries

​Pricing

​FAQ

​Need help?

Email Support

Quickstart

Give your AI assistant live social data

Local install (Claude, Cursor, VS Code, Cline)

Remote server (ChatGPT & other hosted clients)

Authentication

Connect from ChatGPT

Connect from other clients

Configuration

Example prompts

What’s included

Pricing

FAQ

Need help?