Social Media
socialfetch.dev
Retrieves and lists data from TikTok profiles, including videos, followers, and following.
ENDPOINT 1
https://api.socialfetch.dev/mcp
MCP server metadata
- Name
- socialfetch
- Version
- 0.19.0
SocialFetch MCP — agent workflow Tool selection - Prefer the most specific typed tool for the job (e.g. tiktok_profile_get, not nl_ask_post) once you know the platform and resource. - Tool names are {platform}_{resource}_{action} (tiktok_profile_get, twitter_search_list, youtube_channel_shorts_list). Platforms: tiktok, instagram, youtube, twitter, facebook, linkedin, reddit, threads, telegram, github, spotify, rumble, web. - When two tools look similar, read both descriptions — they usually differ by input (handle vs id vs URL) or scope (site-wide search vs within one account). - Schema / response-field questions: docs_search → docs_read (defaults to mode=outline). Prefer MCP docs tools over truncated tool-catalog guesses or public llms URLs. - Cross-platform field naming (author vs owner vs channel, createdAt vs takenAt vs publishedAt): read /product/ask-ai/field-crosswalk. - If unsure which typed tool fits: docs_search, then docs_read. Prefer live docs over training data. Calling tools - Use input schema field names exactly (e.g. handle, not username); a leading @ is accepted where the API allows it. - After profile lookups, read lookupStatus before assuming the account was found. - After each metered call, read top-level meta.creditsCharged and meta.requestId (meta sits beside data, not under structuredContent). - Errors always look like { error: { code, message, requestId } }. - Do not invent handles — use platform search tools (e.g. tiktok_users_search) before get calls. - Author richness on post/video endpoints varies by platform — check outline or /product/ask-ai/field-crosswalk before assuming parity. - Never use trim=true on the first fetch if you need author or baseline snapshot fields; trim only for later polling after those fields are stored. Credits - docs_search, docs_read, auth_whoami, and billing_balance_get are free (no lookup credits). - nl_ask_post charges 0 routing credits; meta.creditsCharged is only the nested lookup. Use nl_ask_post for one-shot exploration when the typed tool is unknown; switch to typed tools afterward. - Call billing_balance_get before large batches of metered tools. - Dual-rail: OAuth Bearer bills credits. Without OAuth, paid tools may require x402 USDC payment when the server has X402_EVM_PAY_TO configured. Settle failures return payment_settlement_failed without tool data. auth_whoami, billing_balance_get, and nl_ask_post always need OAuth.
Known tools 142
tiktok_profile_following_listList accounts followed by a TikTok profile by handle.
Inferred read-onlytiktok_profile_region_getGet the region code reported for a TikTok profile by handle.
Inferred read-onlytiktok_profile_audience_getGet audience location demographics for a TikTok profile by handle.
Inferred read-onlytiktok_profile_live_checkCheck whether a TikTok creator is currently live by handle.
Inferred read-onlytiktok_search_hashtag_listSearch TikTok videos by hashtag (not free-text keyword — use tiktok.
Inferred read-onlytiktok_product_reviews_listList buyer reviews for a TikTok Shop product by product id.
Inferred read-onlytiktok_profile_showcaseProducts_listList products featured on a creator's TikTok showcase by handle.
Inferred read-onlytiktok_adLibrary_ad_getGet a single TikTok Ad Library or Top Ads creative by ad id or public ad URL.
Inferred read-onlytiktok_adLibrary_ads_search_getSearch TikTok Top Ads by keyword and filters, or search the public Ads Library by advertiser name.
Inferred read-onlytwitter_hashtag_listSearch X posts by hashtag (not free-text keyword — use twitter.
Inferred read-onlytwitter_community_tweets_listList tweets from an X community by community id or URL.
Inferred read-onlytelegram_channel_getGet metadata for a public Telegram channel or group by username.
Inferred read-onlytelegram_channel_post_getGet a single public post from a Telegram channel by handle and post ID.
Potential side effectsfacebook_post_transcript_getGet the transcript for a Facebook post or Reel by URL.
Potential side effectsfacebook_marketplace_item_getGet details for a Facebook Marketplace listing by item URL.
Inferred read-onlyfacebook_marketplace_locations_searchSearch Facebook Marketplace locations to obtain coordinates for listing search.
Inferred read-onlyfacebook_marketplace_search_listSearch Facebook Marketplace listings by keyword near a latitude and longitude.
Inferred read-onlyfacebook_adLibrary_ad_getGet a single Facebook Ad Library ad by archive id or public Ad Library URL.
Inferred read-onlyfacebook_adLibrary_ads_search_getSearch Facebook Ad Library ads by keyword and filters.
Inferred read-onlyfacebook_company_ads_listList ads a company or Page is running in the Facebook Ad Library.
Inferred read-onlyfacebook_adLibrary_companies_searchSearch Facebook Ad Library companies / advertisers by name.
Inferred read-onlygoogle_company_ads_listList ads a company or advertiser is running in Google Ad Transparency.
Inferred read-onlygoogle_adLibrary_ad_getGet a single Google Ad Transparency creative by public Ad Transparency URL.
Inferred read-onlygoogle_adLibrary_advertisers_searchSearch Google Ad Transparency advertisers by name.
Inferred read-onlyinstagram_profile_getGet a full Instagram profile by handle (bio, counts, and related fields).
Inferred read-onlyinstagram_profile_basic_getGet a lightweight Instagram profile by numeric user ID when you already have the id — prefer instagram.
Inferred read-onlyinstagram_profile_highlights_listList story highlight albums for an Instagram profile by handle.
Inferred read-onlyinstagram_highlight_getGet stories inside a saved Instagram highlight by highlight id.
Inferred read-onlyinstagram_post_comments_listList comments on an Instagram post or Reel by URL.
Potential side effectsinstagram_post_transcript_getGet the spoken transcript for an Instagram post or Reel by URL.
Potential side effectsinstagram_search_reels_listSearch Instagram Reels by keyword (optional date filters and page-based pagination).
Inferred read-onlylinkedin_organization_getLook up LinkedIn company, school, or organization pages by URL (broader than linkedin.
Inferred read-onlylinkedin_post_transcript_getGet the transcript for a LinkedIn post video by URL.
Potential side effectslinkedin_adLibrary_ads_search_listSearch LinkedIn Ad Library ads by company, keyword, or company id.
Inferred read-onlyreddit_subreddit_search_listSearch posts within one subreddit (not site-wide — use reddit.
Inferred read-onlytwitch_profile_schedule_getGet the stream schedule for a Twitch channel by handle.
Inferred read-onlygithub_profile_repositories_listList repositories for a GitHub user or organization.
Inferred read-onlygithub_profile_activity_listList recent public activity for a GitHub profile, one month per request.
Inferred read-onlygithub_profile_contributions_getGet the contribution graph for a GitHub profile for a given year.
Inferred read-onlygithub_trending_repositories_listList trending GitHub repositories for a language and time window.
Inferred read-onlygithub_trending_developers_listList trending GitHub developers for a language and time window.
Inferred read-onlyyoutube_channel_videos_listList long-form videos from a YouTube channel (not Shorts — use youtube.
Inferred read-onlyyoutube_channel_shorts_listList Shorts from a YouTube channel (not long-form videos).
Inferred read-onlyweb_search_runSearch the public web and return ranked organic results with snippets.
Inferred read-onlyweb_ask_runAsk a natural-language question about a specific web page and get an LLM-generated answer.
Inferred read-onlynl_ask_postRoute a natural-language social-data question to the right lookup when you do not yet know the typed tool — prefer typed tools once the operation is known.
Inferred read-onlybilling_balance_getGet remaining credit balance before running large batches of metered tools.
Inferred read-onlyCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.socialfetch]
url = "https://api.socialfetch.dev/mcp"
enabled = trueClaude Code
.mcp.json
{
"mcpServers": {
"socialfetch": {
"type": "http",
"url": "https://api.socialfetch.dev/mcp"
}
}
}Claude Desktop
Settings → Connectors → Add custom connector
Name: socialfetch
Remote MCP URL: https://api.socialfetch.dev/mcpAdd this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"socialfetch": {
"url": "https://api.socialfetch.dev/mcp"
}
}
}Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"socialfetch": {
"type": "http",
"url": "https://api.socialfetch.dev/mcp"
}
}
}Generic MCP
Client-specific MCP configuration
{
"name": "socialfetch",
"transport": "streamable-http",
"url": "https://api.socialfetch.dev/mcp"
}MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.