check_credits
Check the remaining SociaVault credit balance for the configured API key. Use this to confirm you have credits before running paid scrape calls.
Pull profiles, posts, comments, transcripts and ad-library records off the major social networks through one credit-metered key.
LABSCO SUMMARY
Coverage is deliberately uneven and follows what each network exposes rather than a common denominator. TikTok gets audience demographics, live-room status, Creative Center charts, sound lineage and Shop; Instagram gets highlight trays and reels-by-song; Twitch stops at profile, videos, schedule and clips. Handles are not always the key either — instagram_reels, tiktok_followers and twitter_followers take a numeric user_id, and twitter_comments, twitter_quotes and twitter_retweets take a post id, so a workflow usually resolves an identifier first. check_credits is the exception to all of that, and its own description tells the agent to call it before running paid calls.
A social-data retrieval server exposing 107 tools across TikTok, Instagram, YouTube, Twitch, LinkedIn, Facebook, Twitter/X, Reddit, Threads and Pinterest, plus Google web results and the TikTok, Meta, Google and LinkedIn ad libraries.
A SociaVault API key, supplied as SOCIAVAULT_API_KEY, with credit on it — the scraping calls are paid and check_credits is what reports the balance.
One command plus a key — npx -y sociavault-mcp, then supply credentials
USE CASES
Read the follower and engagement numbers off the profile, check who the audience actually is, then look at how recent videos performed and what the comments say.
Pull the advertiser's live and past creative out of each ad library that carries it, then open the individual ads worth studying.
List what an account has published, then fetch the spoken content of each item as captions instead of watching it.
Read the Creative Center charts for what is trending, open the clip that looks like it has room left, and see who is already posting to it.
Run the same query against networks that index text differently, and take the discussion threads back rather than just the post that started them.
Search the shop for the category, open the listings that rank, and read the reviews to see what buyers complain about.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
check_creditsCheck the remaining SociaVault credit balance for the configured API key. Use this to confirm you have credits before running paid scrape calls.
facebook_ad_library_ad_detailsGet details for a single Facebook/Instagram ad. Provide the ad id or url; optionally fetch the video transcript.
facebook_ad_library_company_adsGet all ads run by a specific advertiser/page in the Meta Ad Library. Provide pageId or companyName.
facebook_ad_library_searchSearch the Facebook/Meta Ad Library by keyword with country, media-type, status, and date filters.
facebook_ad_library_search_companiesFind advertisers/pages in the Meta Ad Library by name.
facebook_comment_repliesGet replies to a Facebook comment using its feedback_id and expansion_token (from a comments response).
facebook_group_postsList posts from a public Facebook group. Provide url or group_id.
facebook_marketplace_itemGet details for a single Facebook Marketplace listing. Provide id or url.
facebook_marketplace_location_searchResolve a place name into Facebook Marketplace location ids/coordinates (use before a marketplace search).
facebook_marketplace_searchSearch Facebook Marketplace listings near coordinates, with price/condition/delivery filters.
facebook_postGet a single Facebook post by URL with engagement metrics.
facebook_post_commentsGet comments on a Facebook post by URL. Paginate with cursor.
facebook_post_transcriptGet the transcript of a Facebook video/reel by URL.
facebook_profileGet a Facebook profile or page by URL: name, about, follower/like counts, category, and contact info.
facebook_profile_postsList posts from a Facebook page/profile. Provide url or pageId. Paginate with cursor.
facebook_profile_reelsList reels from a Facebook page/profile. Paginate with next_page_id/cursor.
google_ad_library_ad_detailsGet details for a single Google ad by its Ad Transparency URL.
google_ad_library_company_adsGet ads from Google's Ad Transparency Center for an advertiser. Provide domain or advertiser_id.
google_ad_library_search_advertisersFind advertisers in Google's Ad Transparency Center by name.
google_searchGet Google web search results (SERP) for a query in a region.
instagram_commentsGet comments on an Instagram post by URL. Paginate with cursor.
instagram_highlight_detailGet the items inside a specific Instagram highlight tray by its id.
instagram_highlightsGet an Instagram account's story highlight trays. Provide handle or user_id.
instagram_post_infoGet full details of a single Instagram post/reel by URL.
instagram_postsList an Instagram user's recent posts with captions, like/comment counts, and media. Paginate with next_max_id.
instagram_profileGet an Instagram profile: full name, bio, follower/following counts, post count, verification, business status, and profile picture.
instagram_reelsList an Instagram user's reels with play/like counts. Provide handle or user_id.
instagram_reels_by_songFind Instagram reels that use a specific audio/song id.
instagram_transcriptGet the transcript of an Instagram video/reel by URL.
linkedin_ad_library_ad_detailsGet details for a single LinkedIn ad by URL.
linkedin_ad_library_searchSearch the LinkedIn Ad Library by company or keyword, with country and date filters.
linkedin_companyGet a LinkedIn company page by URL: industry, size, about, and stats.
linkedin_postGet a LinkedIn post by URL with engagement metrics.
linkedin_profileGet a LinkedIn personal profile by URL: name, headline, experience, education, and more.
pinterest_boardGet the pins inside a Pinterest board by URL. Paginate with cursor.
pinterest_pinGet details for a single Pinterest pin by URL.
pinterest_searchSearch Pinterest pins by keyword. Paginate with cursor.
pinterest_user_boardsList a Pinterest user's boards.
reddit_post_commentsGet comments on a Reddit post by URL. Paginate with cursor.
reddit_post_transcriptGet the transcript of a Reddit-hosted video by post URL.
reddit_searchSearch Reddit across all subreddits by keyword.
reddit_subredditGet posts from a subreddit with timeframe and sort. Paginate with after.
reddit_subreddit_detailsGet a subreddit's metadata: subscribers, active users, description, rules, and category. Provide subreddit or url.
reddit_subreddit_searchSearch posts within a specific subreddit.
threads_postGet a single Threads post by URL.
threads_profileGet a Threads profile: name, bio, follower count, and verification.
threads_searchSearch Threads posts by keyword.
threads_search_usersSearch Threads for users matching a query.
threads_user_postsGet a Threads user's recent posts with engagement metrics.
tiktok_ad_library_adGet details for a single TikTok ad by its ad id.
tiktok_ad_library_searchSearch TikTok's Commercial Content / Ad Library with rich filters (industry, objective, format, language, region, engagement).
tiktok_comment_repliesGet replies to a specific TikTok comment.
tiktok_commentsGet comments on a TikTok video by URL, with like counts and authors. Paginate with cursor.
tiktok_creators_popularGet popular TikTok creators from the Creative Center, filterable by follower count and country.
tiktok_demographicsGet audience demographic insights (where available) for a TikTok creator: country, gender, and age distribution.
tiktok_followersList a TikTok user's followers. Provide handle or user_id.
tiktok_followingList the accounts a TikTok user follows.
tiktok_hashtags_popularGet trending TikTok hashtags from the Creative Center by period and country.
tiktok_liveCheck whether a TikTok user is currently live and get live room details.
tiktok_music_detailsGet details for a specific TikTok sound by its clip id.
tiktok_music_popularGet trending/popular TikTok sounds from the Creative Center charts.
tiktok_music_videosList videos that use a specific TikTok sound.
tiktok_profileGet a TikTok user's profile: nickname, bio/signature, follower/following counts, total likes, video count, verification status, and avatar.
tiktok_search_hashtagGet videos for a TikTok hashtag/challenge.
tiktok_search_keywordSearch TikTok videos by keyword with date/sort/region filters.
tiktok_search_musicSearch TikTok sounds/music by keyword.
tiktok_search_topRun TikTok's general 'top' search across content types for a query.
tiktok_search_usersSearch TikTok for users/creators matching a query.
tiktok_shop_product_detailsGet full details for a single TikTok Shop product, optionally with related videos.
tiktok_shop_product_reviewsGet reviews for a TikTok Shop product. Provide the product url or product_id.
tiktok_shop_productsList products from a TikTok Shop seller/store URL.
tiktok_shop_searchSearch products on TikTok Shop by keyword.
tiktok_transcriptGet the spoken transcript/captions of a TikTok video by URL.
tiktok_trendingGet currently trending TikTok videos for a region.
tiktok_video_infoGet full metadata for a single TikTok video by URL: stats, author, music, and optionally the transcript.
tiktok_videosList a TikTok user's videos with view/like/comment/share counts and metadata. Supports pagination via max_cursor.
tiktok_videos_popularGet top-performing TikTok videos from the Creative Center by period and country.
twitch_clipGet details for a single Twitch clip by URL.
twitch_profileGet a Twitch user's profile/channel info.
twitch_user_scheduleGet a Twitch channel's upcoming stream schedule.
twitch_user_videosList a Twitch user's videos (VODs/highlights/clips). Paginate with cursor.
twitter_commentsGet replies/comments on a tweet by its post id (pid). Paginate with cursor.
twitter_communityGet details for a Twitter/X Community by URL.
twitter_community_tweetsGet tweets posted in a Twitter/X Community by URL.
twitter_followersList a user's followers by numeric user_id. Paginate with cursor.
twitter_followingsList the accounts a user follows by numeric user_id. Paginate with cursor.
twitter_profileGet a Twitter/X profile: name, bio, follower/following counts, tweet count, and verification.
twitter_quotesGet quote tweets of a tweet by its post id (pid). Paginate with cursor.
twitter_retweetsGet accounts that retweeted a tweet by its post id (pid). Paginate with cursor.
twitter_searchSearch tweets/users on Twitter/X. Paginate with cursor.
twitter_tweetGet a single tweet by URL with engagement metrics.
twitter_tweet_transcriptGet the transcript of a video attached to a tweet, by URL.
twitter_user_tweetsGet a user's recent tweets by handle with engagement metrics.
twitter_user_tweets_allGet a user's tweets by numeric user_id with full cursor pagination for deep history.
youtube_channelGet a YouTube channel's stats: subscribers, video count, total views, description, and thumbnails. Provide channelId, handle, or url.
youtube_channel_community_postsList a channel's community tab posts. Paginate with continuationToken.
youtube_channel_livesList a channel's live/streamed videos. Paginate with continuationToken.
youtube_channel_playlistsList a channel's playlists. Paginate with continuationToken.
youtube_channel_shortsList a channel's Shorts. Paginate with continuationToken.
youtube_channel_videosList a channel's uploaded videos. Paginate with continuationToken.
youtube_searchSearch YouTube for videos with upload-date, sort, and type filters.
youtube_search_hashtagGet videos/shorts for a YouTube hashtag.
youtube_shorts_trendingGet currently trending YouTube Shorts.
youtube_videoGet metadata for a single YouTube video by URL: title, views, likes, channel, and description.
youtube_video_comment_repliesGet replies to a YouTube comment using the continuation token from a comments response.
youtube_video_commentsGet comments on a YouTube video by URL. Paginate with continuationToken.
youtube_video_transcriptGet the transcript/captions of a YouTube video by URL.
BEFORE YOU INSTALL
107 tools when we connected. All 107 are read-only. 106 are billed per call against your credit balance; check_credits shows what is left.
All 3 documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 107 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y sociavault-mcp{
"mcpServers": {
"sociavault": {
"command": "npx",
"args": [
"-y",
"sociavault-mcp"
],
"env": {
"SOCIAVAULT_API_KEY": "<YOUR_SOCIAVAULT_API_KEY>"
}
}
}
}{
"servers": {
"sociavault": {
"command": "npx",
"args": [
"-y",
"sociavault-mcp"
],
"env": {
"SOCIAVAULT_API_KEY": "<YOUR_SOCIAVAULT_API_KEY>"
}
}
}
}