{
  "markdown": "# SociaVault MCP Server\n\nGive your AI assistant live access to social media data. This [Model Context Protocol](https://modelcontextprotocol.io) server 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.\n\n**Powered by [SociaVault](https://sociavault.com)** — a reliable social media data API for developers.\n\n[![npm version](https://img.shields.io/npm/v/sociavault-mcp.svg)](https://www.npmjs.com/package/sociavault-mcp)\n\n<a href=\"https://glama.ai/mcp/servers/@olamide-olaniyan/sociavault-mcp\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@olamide-olaniyan/sociavault-mcp/badge\" alt=\"SociaVault Server MCP server\" />\n</a>\n\n## Highlights\n\n- **107 tools** across TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Facebook, Reddit, Threads, Pinterest, Twitch, and Google.\n- **Ad library coverage** — TikTok, Meta (Facebook/Instagram), Google, and LinkedIn ad libraries for competitor research.\n- **Zero install** — runs via `npx`, no global install needed.\n- **Token-efficient** — responses are trimmed by default to keep your context window lean.\n- **Built on the modern MCP SDK** (1.x) with typed inputs, structured output, and clear error messages.\n\n## Quick start\n\n### 1. Get an API key\n\nSign up at [sociavault.com](https://sociavault.com/signup) — new accounts get free credits to start. Copy your key (format `sk_live_…`) from the [dashboard](https://sociavault.com/dashboard).\n\n### 2. Add the server to your client\n\nThe server runs with `npx`, so there's nothing to install. Just add the config below and set your API key.\n\n#### Claude Desktop\n\nEdit your config file:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"sociavault\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"sociavault-mcp\"],\n      \"env\": {\n        \"SOCIAVAULT_API_KEY\": \"sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop.\n\n#### Cursor\n\nAdd to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):\n\n```json\n{\n  \"mcpServers\": {\n    \"sociavault\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"sociavault-mcp\"],\n      \"env\": { \"SOCIAVAULT_API_KEY\": \"sk_live_your_key_here\" }\n    }\n  }\n}\n```\n\n#### VS Code (Copilot)\n\nAdd to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"sociavault\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"sociavault-mcp\"],\n      \"env\": { \"SOCIAVAULT_API_KEY\": \"sk_live_your_key_here\" }\n    }\n  }\n}\n```\n\n#### Cline / other clients\n\nAny client that supports stdio MCP servers works — point it at the command `npx -y sociavault-mcp` with `SOCIAVAULT_API_KEY` in the environment.\n\n## Configuration\n\n| Environment variable | Required | Description |\n|----------------------|----------|-------------|\n| `SOCIAVAULT_API_KEY` | Yes | Your SociaVault API key (`sk_live_…`). |\n| `SOCIAVAULT_BASE_URL` | No | Override the API base URL. Defaults to `https://api.sociavault.com`. |\n\n## Usage examples\n\nOnce configured, ask your assistant things like:\n\n- \"Get the TikTok profile and last 20 videos for @charlidamelio.\"\n- \"Search the Meta Ad Library for active ads from Nike in the US.\"\n- \"Pull the transcript of this YouTube video: <url>.\"\n- \"What's trending on TikTok in the US right now?\"\n- \"Find Instagram reels using this audio id and summarize the top performers.\"\n- \"Search Reddit for mentions of my product in the last week.\"\n- \"Get the comments on this tweet and summarize the sentiment.\"\n\n## Tools\n\nAll tools are read-only. Most accept a `trim` flag (default `true`) that returns a smaller, AI-friendly payload; set `trim: false` for the full raw response. List endpoints accept a pagination cursor returned in the previous response.\n\n### TikTok\n`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`\n\n### TikTok Shop\n`tiktok_shop_products`, `tiktok_shop_product_details`, `tiktok_shop_search`, `tiktok_shop_product_reviews`\n\n### TikTok Ad Library\n`tiktok_ad_library_search`, `tiktok_ad_library_ad`\n\n### Instagram\n`instagram_profile`, `instagram_posts`, `instagram_post_info`, `instagram_transcript`, `instagram_comments`, `instagram_reels`, `instagram_highlights`, `instagram_highlight_detail`, `instagram_reels_by_song`\n\n### YouTube\n`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`\n\n### Twitter / X\n`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`\n\n### LinkedIn\n`linkedin_profile`, `linkedin_company`, `linkedin_post`\n\n### LinkedIn Ad Library\n`linkedin_ad_library_search`, `linkedin_ad_library_ad_details`\n\n### Facebook\n`facebook_profile`, `facebook_profile_posts`, `facebook_comment_replies`, `facebook_profile_reels`, `facebook_group_posts`, `facebook_post`, `facebook_post_transcript`, `facebook_post_comments`\n\n### Facebook Ad Library\n`facebook_ad_library_ad_details`, `facebook_ad_library_search`, `facebook_ad_library_company_ads`, `facebook_ad_library_search_companies`\n\n### Facebook Marketplace\n`facebook_marketplace_location_search`, `facebook_marketplace_search`, `facebook_marketplace_item`\n\n### Google\n`google_search`, `google_ad_library_company_ads`, `google_ad_library_ad_details`, `google_ad_library_search_advertisers`\n\n### Reddit\n`reddit_subreddit_details`, `reddit_subreddit`, `reddit_subreddit_search`, `reddit_post_comments`, `reddit_post_transcript`, `reddit_search`\n\n### Threads\n`threads_profile`, `threads_user_posts`, `threads_post`, `threads_search`, `threads_search_users`\n\n### Pinterest\n`pinterest_search`, `pinterest_pin`, `pinterest_user_boards`, `pinterest_board`\n\n### Twitch\n`twitch_profile`, `twitch_user_videos`, `twitch_user_schedule`, `twitch_clip`\n\n### Account\n`check_credits` — check your remaining credit balance.\n\n## Pricing\n\nThe MCP server is free and open source. You only pay for the SociaVault API usage it makes, billed as **credits** (each API call costs credits depending on the endpoint).\n\n- **Free** — credits included on signup, no card required.\n- **Credit packs** — Starter ($29), Growth ($79), Pro ($199), and Enterprise ($399), each granting a larger bundle of credits.\n\nCredits don't expire on a monthly cycle — you buy a pack and draw it down. See the current packs and credit amounts at [sociavault.com/pricing](https://sociavault.com/pricing), and check your balance any time with the `check_credits` tool.\n\n## Troubleshooting\n\n**\"Missing SOCIAVAULT_API_KEY\"** — Add your key to the `env` block of the MCP config and restart the client.\n\n**\"Authentication failed (401)\"** — Your key is wrong or expired, or it's not in the `sk_live_…` format. Generate a fresh one in the [dashboard](https://sociavault.com/dashboard).\n\n**\"Out of credits (402)\"** — Top up at [sociavault.com/pricing](https://sociavault.com/pricing).\n\n**\"Not found (404)\"** — The handle/URL is wrong, or the account/content is private or deleted.\n\n**Server not showing up** — Make sure Node.js 18+ is installed and on your PATH, confirm the JSON config is valid, and fully restart the client. Most clients have an MCP log panel that shows startup errors.\n\n## Development\n\n```bash\ngit clone https://github.com/olamide-olaniyan/sociavault-mcp.git\ncd sociavault-mcp\nnpm install\nnpm run build\n\n# Run locally\nSOCIAVAULT_API_KEY=sk_live_your_key node dist/index.js\n```\n\nAdding a new endpoint is a single entry in `src/endpoints.ts` — the server registers every entry automatically.\n\n## Links\n\n- **Website**: [sociavault.com](https://sociavault.com)\n- **API docs**: [docs.sociavault.com](https://docs.sociavault.com)\n- **Support**: support@sociavault.com\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n",
  "bytes": 8596,
  "sha": "0c5db1910973f9618c6fa4acce7c5c3ba24f3f56c22f60830deed5e0a73b19cc",
  "repo_slug": "olamide-olaniyan/sociavault-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_olamide_olaniyan_sociavault_mc_424f3ffc/readme"
}