SociaVault

Queries the SociaVault API to fetch social data across platforms via MCP clients.

javascript

1

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "olamide-olaniyan-sociavault-mcp": {
      "command": "sociavault-mcp",
      "args": [],
      "env": {
        "SOCIAVAULT_API_KEY": "your-api-key-here"
      }
    }
  }
}

SociaVault MCP Server lets you query social media data directly from any MCP-compatible AI client, returning profiles, posts, and engagement metrics across Instagram, TikTok, Twitter/X, Threads, YouTube, Facebook, and Reddit through natural language requests.

How to use

Configure your MCP client to connect to the SociaVault MCP Server, then ask natural language questions to retrieve data from multiple social platforms. Use simple prompts like asking for a profile, recent posts, or follower counts, and your AI assistant will fetch the corresponding data from SociaVault.

How to install

Prerequisites: ensure you have Node.js installed on your system.

Install the SociaVault MCP package globally.

npm install -g sociavault-mcp

Create the MCP server configuration for your MCP client. The SociaVault MCP server runs locally and accepts your API key via an environment variable.

{
  "mcpServers": {
    "sociavault": {
      "command": "sociavault-mcp",
      "env": {
        "SOCIAVAULT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Start the local MCP server using the environment variable for your API key.

export SOCIAVAULT_API_KEY=your-api-key-here
sociavault-mcp

Alternatively, if you are configuring Claude Desktop, add the SociaVault MCP server to your config as shown.

{
  "mcpServers": {
    "sociavault": {
      "command": "sociavault-mcp",
      "env": {
        "SOCIAVAULT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Additional sections

The server exposes a set of tools that fetch data from each supported platform, and usage is designed for straightforward prompts in your MCP client.

Troubleshooting

If you encounter issues starting the MCP server, verify your API key is set and the server process is running in the foreground. Check logs for errors and ensure the API key has not expired.

Available tools

get_instagram_profile

Fetch Instagram profile data including followers, bio, posts count, and verification status.

get_instagram_posts

Retrieve recent Instagram posts with metrics like likes, comments, and media details.

get_tiktok_profile

Obtain TikTok profile data such as followers, likes, bio, and video count.

get_tiktok_videos

Fetch recent TikTok videos with views, likes, and shares.

get_twitter_profile

Get Twitter/X profile data including followers and bio.

get_twitter_tweets

Retrieve recent tweets with engagement data.

get_threads_profile

Get Threads profile data including followers and bio.

get_threads_posts

Fetch recent Threads posts with likes and replies.

get_youtube_channel

Obtain YouTube channel data like subscribers and video count.

get_facebook_profile

Get Facebook profile or page data including followers and about.

get_reddit_subreddit

Fetch subreddit posts with upvotes and comments.