Sociavault

Give your AI assistant live access to social media data. ThisModel Context Protocolserver lets Claude, Cursor, Cline, VS Code, and any MCP-compatible client pull real-time data from 11 platforms — profiles, posts, comments, transcripts, search, trends, and ad libraries — through natural language.

Powered bySociaVault— a reliable social media data API for developers.

Sign up atsociavault.com— new accounts get free credits to start. Copy your key (formatsk_live_…) from thedashboard.

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

Add to~/.cursor/mcp.json(global) or.cursor/mcp.json(per-project):

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

Any client that supports stdio MCP servers works — point it at the commandnpx -y sociavault-mcpwithSOCIAVAULT_API_KEYin the environment.

Once configured, ask your assistant things like:

- "Get the TikTok profile and last 20 videos for @charlidamelio."
- "Search the Meta Ad Library for active ads from Nike in the US."
- "Pull the transcript of this YouTube video: <!-- -->."
- "What's trending on TikTok in the US right now?"
- "Find Instagram reels using this audio id and summarize the top performers."
- "Search Reddit for mentions of my product in the last week."
- "Get the comments on this tweet and summarize the sentiment."

All tools are read-only. Most accept atrimflag (defaulttrue) that returns a smaller, AI-friendly payload; settrim: falsefor the full raw response. List endpoints accept a pagination cursor returned in the previous response.

tiktok_profile,tiktok_demographics,tiktok_videos,tiktok_video_info,tiktok_transcript,tiktok_live,tiktok_comments,tiktok_comment_replies,tiktok_following,tiktok_followers,tiktok_search_users,tiktok_search_hashtag,tiktok_search_keyword,tiktok_search_music,tiktok_search_top,tiktok_music_popular,tiktok_music_details,tiktok_music_videos,tiktok_trending,tiktok_creators_popular,tiktok_videos_popular,tiktok_hashtags_popular

tiktok_shop_products,tiktok_shop_product_details,tiktok_shop_search,tiktok_shop_product_reviews

tiktok_ad_library_search,tiktok_ad_library_ad

instagram_profile,instagram_posts,instagram_post_info,instagram_transcript,instagram_comments,instagram_reels,instagram_highlights,instagram_highlight_detail,instagram_reels_by_song

youtube_channel,youtube_channel_videos,youtube_channel_shorts,youtube_video,youtube_video_transcript,youtube_search,youtube_search_hashtag,youtube_video_comments,youtube_video_comment_replies,youtube_shorts_trending,youtube_channel_playlists,youtube_channel_lives,youtube_channel_community_posts

twitter_profile,twitter_user_tweets,twitter_user_tweets_all,twitter_tweet,twitter_tweet_transcript,twitter_comments,twitter_quotes,twitter_retweets,twitter_search,twitter_followers,twitter_followings,twitter_community,twitter_community_tweets

linkedin_profile,linkedin_company,linkedin_post

linkedin_ad_library_search,linkedin_ad_library_ad_details

facebook_profile,facebook_profile_posts,facebook_comment_replies,facebook_profile_reels,facebook_group_posts,facebook_post,facebook_post_transcript,facebook_post_comments

facebook_ad_library_ad_details,facebook_ad_library_search,facebook_ad_library_company_ads,facebook_ad_library_search_companies

facebook_marketplace_location_search,facebook_marketplace_search,facebook_marketplace_item

google_search,google_ad_library_company_ads,google_ad_library_ad_details,google_ad_library_search_advertisers

reddit_subreddit_details,reddit_subreddit,reddit_subreddit_search,reddit_post_comments,reddit_post_transcript,reddit_search

threads_profile,threads_user_posts,threads_post,threads_search,threads_search_users

pinterest_search,pinterest_pin,pinterest_user_boards,pinterest_board

twitch_profile,twitch_user_videos,twitch_user_schedule,twitch_clip

check_credits— check your remaining credit balance.

The MCP server is free and open source. You only pay for the SociaVault API usage it makes, billed ascredits(each API call costs credits depending on the endpoint).

- Free— credits included on signup, no card required.
- Credit packs— Starter ($29), Growth ($79), Pro ($199), and Enterprise ($399), each granting a larger bundle of credits.

Credits don't expire on a monthly cycle — you buy a pack and draw it down. See the current packs and credit amounts atsociavault.com/pricing, and check your balance any time with thecheck_creditstool.

"Authentication failed (401)"— Your key is wrong or expired, or it's not in thesk_live_…format. Generate a fresh one in thedashboard.

"Out of credits (402)"— Top up atsociavault.com/pricing.

git clone https://github.com/olamide-olaniyan/sociavault-mcp.git cd sociavault-mcp npm install npm run build # Run locally SOCIAVAULT_API_KEY=sk_live_your_key node dist/index.js

- Website:sociavault.com
- API docs:docs.sociavault.com
- Support:[email protected]

Monitor web and social media using the Mention API.