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.28.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, linktree, hackernews, truthsocial, 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; prefer createdAt ISO over legacy Unix takenAt/publishTime/createdUtc): 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 or x-api-key: sfk_… bills credits. Without either, 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 or an API key.
Known tools 207
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_videos_listSearch TikTok videos by free-text keyword (not hashtag — use tiktok.
Inferred read-onlytiktok_search_top_listSearch TikTok Top results by keyword (not videos-only — use tiktok.
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_search_listSearch X posts by free-text keyword (not hashtag — use twitter.
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 effectslinktree_profile_getGet a public Linktree profile by handle, including links and socials.
Inferred read-onlyhackernews_feed_listList a Hacker News feed by type (top, new, best, ask, show, or jobs).
Inferred read-onlyhackernews_comment_context_getGet a Hacker News comment with its ancestor chain to the root story.
Inferred read-onlyhackernews_user_submissions_listList a Hacker News user's stories, polls, and jobs (newest first).
Inferred read-onlyhackernews_jobs_who_is_hiring_listList top-level jobs from the monthly Hacker News Who is Hiring thread (latest thread, or a YYYY-MM month).
Inferred read-onlytruthsocial_profile_posts_listList posts from a Truth Social profile by handle or account id.
Inferred read-onlyfacebook_post_transcript_getGet the transcript for a Facebook post or Reel by URL.
Potential side effectsfacebook_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_marketplace_item_getGet details for a Facebook Marketplace listing by item URL.
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.
Inferred read-onlyinstagram_profile_reels_listList Reels from one specific Instagram profile by handle (not a keyword search — use instagram.
Inferred read-onlyinstagram_profile_highlights_listList story highlight albums for an Instagram profile by handle.
Inferred read-onlyinstagram_profile_taggedPosts_listList Instagram posts a user is tagged in, by user id.
Inferred read-onlyinstagram_highlight_getGet stories inside a saved Instagram highlight by highlight id.
Inferred read-onlyinstagram_search_listSearch Instagram accounts, hashtags, and places by keyword (not posts — use instagram.
Inferred read-onlyinstagram_search_reels_listSearch Reels site-wide by keyword (not scoped to one profile — use instagram.
Inferred read-onlyinstagram_search_popular_listSearch Instagram's curated Popular topics by keyword.
Inferred read-onlyinstagram_post_comments_listList comments on an Instagram post or Reel by URL.
Potential side effectsinstagram_post_comments_replies_listList replies to a comment on an Instagram post or Reel.
Potential side effectsinstagram_post_transcript_getGet the spoken transcript for an Instagram post or Reel by URL.
Potential side effectsinstagram_reels_trending_listList currently trending Instagram Reels (not a keyword search, profile-scoped, or audio-page list — use instagram.
Inferred read-onlyinstagram_audio_reels_listList Instagram Reels that use a specific audio track, with track metadata, tagged users, and coauthors when Instagram exposes them.
Inferred read-onlylinkedin_profiles_posts_listList posts from one specific LinkedIn person profile by URL (not a keyword search — use linkedin.
Inferred read-onlylinkedin_organization_getLook up LinkedIn company, school, or organization pages by URL (broader than linkedin.
Inferred read-onlylinkedin_company_posts_listList posts from one specific LinkedIn company page by URL (not a keyword search — use linkedin.
Inferred read-onlylinkedin_post_transcript_getGet the transcript for a LinkedIn post video by URL.
Potential side effectslinkedin_posts_search_listSearch public LinkedIn posts site-wide by keyword (not scoped to one profile or company — use linkedin.
Inferred read-onlylinkedin_adLibrary_ads_search_listSearch LinkedIn Ad Library ads by company, keyword, or company id.
Inferred read-onlyreddit_subreddit_posts_listList a subreddit's post feed (hot/new/top, no keyword) — use reddit.
Potential side effectsreddit_subreddit_search_listSearch posts within one subreddit (not site-wide — use reddit.
Inferred read-onlyreddit_search_listSearch Reddit posts site-wide by keyword (not scoped to one subreddit — 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-onlyyoutube_search_listSearch YouTube videos, channels, and playlists by free-text keyword (not hashtag — use youtube.
Inferred read-onlyyoutube_search_hashtag_listSearch YouTube content by hashtag (not free-text keyword — use youtube.
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-onlyweb_screenshot_captureCapture a screenshot of a public web page URL as a hosted image artifact.
Inferred read-onlyweb_extract_runExtract structured fields from a web page using a CSS selector schema.
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-onlymonitors_sources_listList every public API operation Monitors can watch (Twitter/X, Instagram, TikTok, Reddit profiles and searches).
Inferred read-onlymonitors_createWatch a social account or search and get a signed webhook when new content appears.
Inferred read-onlymonitors_updateUpdate a monitor's name, schedule, webhook endpoint, spend cap, or status (pause/resume).
Potential side effectsmonitors_triggerQueue an immediate check for an active monitor (async — returns once queued, not once the check finishes).
Inferred read-onlymonitors_events_listPull API for a monitor's events — queryable regardless of webhook delivery configuration.
Inferred read-onlymonitors_checks_listThe self-serve "why didn't I get a webhook" view — the last ~50 checks with outcome/credits/reason.
Inferred read-onlywebhookEndpoints_listList the caller's webhook endpoints (secret material never included).
Inferred read-onlywebhookEndpoints_getGet one webhook endpoint by id (secret material never included).
Inferred read-onlywebhookEndpoints_updateUpdate a webhook endpoint's description or enable/disable it.
Potential side effectswebhookEndpoints_testSend a realistic per-source sample event to a webhook endpoint right now — a live, synchronous delivery test.
Potential side effectswebhookEndpoints_rotateSecretRotate the signing secret with a 24h overlap window — the old secret keeps working until it expires.
Inferred read-onlywebhookDeliveries_redeliverQueue a manual redelivery for one delivery attempt (async).
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
Trust Data Available
BuiltWith Trust API v2 evidence for socialfetch.dev was fetched 2026-08-28T09:29:39.548Z.
socialfetch.dev is assessed as Neutral: No suspicious signals found, but no strong positive signal either
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.