> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Use SociaVault from Claude, Cursor, VS Code, and any AI agent with the official MCP server

## 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](https://modelcontextprotocol.io) — 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.

<CardGroup cols={2}>
  <Card title="npm package" icon="npm" href="https://www.npmjs.com/package/sociavault-mcp">
    sociavault-mcp on npm
  </Card>

  <Card title="MCP Registry" icon="server" href="https://registry.modelcontextprotocol.io">
    Listed on the official registry
  </Card>

  <Card title="Smithery" icon="package" href="https://smithery.ai/server/olaniyanolamide42/sociavault-mcp">
    Install via Smithery
  </Card>

  <Card title="Full guide" icon="book" href="https://sociavault.com/blog/social-media-mcp-server">
    Read the complete walkthrough
  </Card>
</CardGroup>

## Installation

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

<Steps>
  <Step title="Get your API key">
    Sign up at [sociavault.com](https://sociavault.com/signup) and copy your API key (format `sk_live_...`) from the [Dashboard](https://sociavault.com/dashboard).
  </Step>

  <Step title="Add the server to your client">
    Pick your client below and add the configuration with your API key.

    <CodeGroup>
      ```json Claude Desktop theme={null}
      {
        "mcpServers": {
          "sociavault": {
            "command": "npx",
            "args": ["-y", "sociavault-mcp"],
            "env": {
              "SOCIAVAULT_API_KEY": "sk_live_your_key_here"
            }
          }
        }
      }
      ```

      ```json Cursor theme={null}
      {
        "mcpServers": {
          "sociavault": {
            "command": "npx",
            "args": ["-y", "sociavault-mcp"],
            "env": { "SOCIAVAULT_API_KEY": "sk_live_your_key_here" }
          }
        }
      }
      ```

      ```json VS Code theme={null}
      {
        "servers": {
          "sociavault": {
            "command": "npx",
            "args": ["-y", "sociavault-mcp"],
            "env": { "SOCIAVAULT_API_KEY": "sk_live_your_key_here" }
          }
        }
      }
      ```
    </CodeGroup>

    <Info>
      **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`.
    </Info>
  </Step>

  <Step title="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.

    <Check>
      Your AI assistant now has live access to social media data across 11 platforms.
    </Check>
  </Step>
</Steps>

## Configuration

<ParamField path="SOCIAVAULT_API_KEY" type="string" required>
  Your SociaVault API key (`sk_live_...`). Get one at the [Dashboard](https://sociavault.com/dashboard).
</ParamField>

<ParamField path="SOCIAVAULT_BASE_URL" type="string">
  Optional override for the API base URL. Defaults to `https://api.sociavault.com`.
</ParamField>

## Example prompts

The model picks the right tool automatically — you just describe what you want:

<AccordionGroup>
  <Accordion title="Creator research" icon="user">
    "Compare the follower counts and engagement of @cristiano on Instagram vs. his YouTube channel."
  </Accordion>

  <Accordion title="Competitor ad intelligence" icon="rectangle-ad">
    "Search the Meta Ad Library for active Nike ads in the US and summarize their angles."
  </Accordion>

  <Accordion title="Content repurposing" icon="closed-captioning">
    "Get the transcript of this YouTube video and turn it into a LinkedIn post: \<url>"
  </Accordion>

  <Accordion title="Social listening" icon="magnifying-glass">
    "Pull the last 30 posts from r/webscraping and tell me the recurring pain points."
  </Accordion>

  <Accordion title="Trend monitoring" icon="arrow-trend-up">
    "What's trending on TikTok in the US right now, and which sounds are surging?"
  </Accordion>
</AccordionGroup>

## 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.

<CardGroup cols={3}>
  <Card title="TikTok" icon="tiktok">
    Profiles, videos, comments, transcripts, search, music, trending
  </Card>

  <Card title="Instagram" icon="instagram">
    Profiles, posts, reels, comments, transcripts, highlights
  </Card>

  <Card title="YouTube" icon="youtube">
    Channels, videos, shorts, transcripts, search, comments
  </Card>

  <Card title="Twitter / X" icon="x-twitter">
    Profiles, tweets, replies, quotes, retweets, search
  </Card>

  <Card title="LinkedIn" icon="linkedin">
    Profiles, companies, posts
  </Card>

  <Card title="Facebook" icon="facebook">
    Profiles, posts, reels, groups, comments, transcripts
  </Card>

  <Card title="Reddit" icon="reddit">
    Subreddits, posts, comments, transcripts, search
  </Card>

  <Card title="Threads, Pinterest, Twitch" icon="layer-group">
    Profiles, posts, pins, boards, clips, schedules
  </Card>

  <Card title="Ad libraries" icon="rectangle-ad">
    TikTok, Meta, Google, and LinkedIn ad libraries
  </Card>
</CardGroup>

## 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](https://sociavault.com/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

<AccordionGroup>
  <Accordion title="Which clients are supported?">
    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.
  </Accordion>

  <Accordion title="Is my API key safe?">
    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.
  </Accordion>

  <Accordion title="Do I need Node.js?">
    Yes — Node.js 18 or newer, since the server runs via `npx`. Most developer machines already have it.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Need help?

<CardGroup cols={2}>
  <Card title="Email Support" icon="envelope" href="mailto:support@sociavault.com">
    Get help from our team
  </Card>

  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Prefer raw REST? Start here
  </Card>
</CardGroup>