SociaVault MCP Server

Query social media data directly in Claude Desktop, Cline, or any MCP-compatible AI client.

Powered by SociaVault - The most reliable social media data API for developers.

Features

✅ Instagram - Profiles, posts
✅ TikTok - Profiles, videos
✅ Twitter/X - Profiles, tweets
✅ Threads - Profiles, posts
✅ YouTube - Channels
✅ Facebook - Profiles, pages
✅ Reddit - Subreddits, posts

All accessible directly in your AI assistant with simple natural language commands.

Installation

Prerequisites

1. Get your SociaVault API key
   Sign up at sociavault.com/signup (free tier available)

2. Install the package

   npm install -g sociavault-mcp

Claude Desktop Setup

1. Open your Claude Desktop config:

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

2. Add the SociaVault MCP server:

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

3. Restart Claude Desktop

Other MCP Clients

For Cline, Zed, or other MCP clients, refer to their documentation for adding MCP servers.

Usage Examples

Once configured, you can ask Claude natural language questions like:

Instagram

• "Get the Instagram profile for @nike"
• "Show me the last 20 posts from @cristiano"
• "What's Nike's follower count on Instagram?"

TikTok

• "Get TikTok profile data for @charlidamelio"
• "Show me the latest videos from @mrbeast"
• "What's the engagement on Charli D'Amelio's TikTok?"

Twitter/X

• "Get Twitter profile for @elonmusk"
• "Show me recent tweets from @OpenAI"
• "What's the follower count for @OpenAI?"

Threads

• "Get Threads profile for @zuck"
• "Show me posts from @Meta on Threads"

YouTube

• "Get YouTube channel data for @MrBeast"
• "What's the subscriber count for MrBeast?"

Facebook

• "Get Facebook profile for https://facebook.com/nike"
• "Show me data from the Nike Facebook page"

Reddit

• "Get posts from r/programming"
• "Show me trending posts from r/technology"

Available Tools

The MCP server exposes these tools to AI clients:

| Tool | Description | |------|-------------| | get_instagram_profile | Get Instagram profile data (followers, bio, posts count, verification) | | get_instagram_posts | Get recent Instagram posts with likes, comments, media | | get_tiktok_profile | Get TikTok profile data (followers, likes, bio, videos count) | | get_tiktok_videos | Get recent TikTok videos with views, likes, shares | | get_twitter_profile | Get Twitter/X profile data (followers, bio, tweets count) | | get_twitter_tweets | Get recent tweets with engagement metrics | | get_threads_profile | Get Threads profile data (followers, bio, posts count) | | get_threads_posts | Get recent Threads posts with likes, replies | | get_youtube_channel | Get YouTube channel data (subscribers, videos, description) | | get_facebook_profile | Get Facebook profile/page data (followers, likes, about) | | get_reddit_subreddit | Get Reddit subreddit posts with upvotes, comments |

API Limits

Depends on your SociaVault plan:

• Free tier: 1,000 requests/month
• Pro: Unlimited requests
• Enterprise: Custom limits + priority support

Check your usage at sociavault.com/dashboard

Pricing

This MCP server is free and open source.

You only pay for SociaVault API usage:

• Free: $0/month (1,000 requests)
• Pro: $29/month (unlimited)
• Enterprise: Custom pricing

See full pricing at sociavault.com/pricing

Troubleshooting

"SOCIAVAULT_API_KEY environment variable is required"

Make sure you've added your API key to the MCP config file. Get your key at sociavault.com/signup

"Authentication error: Invalid API key"

Your API key is invalid or expired. Generate a new one at sociavault.com/dashboard

"Profile not found"

The username doesn't exist or the account is private. Try a different username.

Server not appearing in Claude Desktop

1. Check the config file syntax is valid JSON
2. Restart Claude Desktop completely
3. Check the logs in ~/Library/Logs/Claude/mcp*.log (macOS)

Development

Want to contribute or run locally?

# Clone the repo
git clone https://github.com/olamide-olaniyan/sociavault-mcp.git
cd sociavault-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally (requires SOCIAVAULT_API_KEY in environment)
export SOCIAVAULT_API_KEY=your-key-here
node dist/index.js

Use Cases

For Marketers:

• Research competitor social media strategies
• Find influencer profiles and engagement rates
• Track content performance across platforms

For Developers:

• Build social media analytics tools
• Integrate social data into your apps
• Prototype social listening tools

For Researchers:

• Analyze social media trends
• Study creator content patterns
• Track brand presence across platforms

For Sales Teams:

• Research prospects on social media
• Verify company social presence
• Find decision makers and influencers

Why SociaVault?

• 99.9% uptime - More reliable than scraping yourself
• No rate limits - Unlimited requests on Pro plan
• All platforms - Instagram, TikTok, Twitter, LinkedIn in one API
• Always working - We handle platform changes, you don't
• Great docs - Clear examples, fast support

Learn more at sociavault.com

Support

• Documentation: sociavault.com/docs
• Email: [email protected]

License

MIT License - see LICENSE file

Built with ❤️ by the SociaVault team

Get your API key → sociavault.com/signup