Social Fetch
About
Hosted MCP for public social data (TikTok, Instagram, Reddit, X, YouTube, and more) as structured JSON.
Details
- Author
- social-freak-ltd
- Categories
- Web Scraping, Other
Jump to
Setup
Install Social Fetch in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/social-freak-ltd/socialfetch-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Let your coding agent fetch real social media and web data while it builds.
Documentation|API reference|Credits & billing
Server URL:https://api.socialfetch.dev/mcp
Social Fetch MCP connects Cursor, VS Code, Claude, Windsurf, and other MCP clients to the Social Fetch API. Once installed, your agent can look up creators, fetch posts, search platforms, read web pages, check your balance, and read the Social Fetch docs from inside your editor.
Use it when you want your agent to answer questions like:
- "Find this TikTok creator and add their latest videos to my app."
- "Pull the transcript for this YouTube video and summarize the sponsorships."
- "Fetch this Instagram post, inspect the response shape, and wire it into my backend."
- "Read the Social Fetch docs and choose the right endpoint for Reddit search."
The MCP server itself is hosted by Social Fetch:
There is no local server to clone, build, or run from this repository. Clients connect to the hosted Streamable HTTP endpoint and authenticate with OAuth in the browser.
Agents are better when they can work with the same API your app uses. This gives them a direct, authenticated route to Social Fetch instead of making you bounce between docs, dashboards, scripts, and pasted JSON.
Social Fetch MCP exposes endpoint tools for:
- TikTok, Instagram, YouTube, X/Twitter, Telegram, Facebook, Threads, LinkedIn, Reddit, and Spotify data.
- Profiles, posts, videos, comments, transcripts, search results, and platform-specific metadata.
- Web markdown generation and AI-assisted web page questions.
- Account identity and credit balance.
- Social Fetch docs throughdocs_searchanddocs_read.
Endpoint tools are metered like the REST API. Docs tools,auth_whoami, andbilling_balance_getdo not consume lookup credits.
- Install in Cursor
- Install in VS Code
- Install in Windsurf
- Open the hosted install page
Complete theOAuthbrowser flow after installing. If a one-click link does nothing - your editor is not installed, blocks custom URL schemes, or has no handler - use the manual setup below.
Add this to~/.cursor/mcp.jsonor a project.cursor/mcp.json:
{ "mcpServers": { "socialfetch": { "url": "https://api.socialfetch.dev/mcp" } } }
Restart Cursor, open MCP settings, and complete the OAuth browser flow when prompted.
{ "mcp": { "servers": { "socialfetch": { "url": "https://api.socialfetch.dev/mcp" } } } }
claude mcp add --transport http socialfetch https://api.socialfetch.dev/mcp
Then run/mcpand authenticate Social Fetch to finish the OAuth flow.
Add a custom remote MCP connector with this URL:
Authorize Social Fetch when Claude prompts you.
If your client only supports stdio MCP servers, bridge to the hosted server withmcp-remote:
npx mcp-remote https://api.socialfetch.dev/mcp
Point your client at the stdio process that command starts.
Social Fetch MCP uses OAuth 2.1. Your MCP client handles the flow:
Do not paste a Social Fetch API key into MCP config. Credits are charged to the signed-in account, just like REST API requests.
tools/listexposes endpoint tools plus docs tools.
Endpoint tool names match API operation IDs with dots replaced by underscores:
Each endpoint tool's arguments mirror the matching API route parameters. See theAPI referencefor the full endpoint catalog, argument schemas, response shapes, and pricing.
Use the Social Fetch MCP docs to add TikTok profile lookup to this app with the TypeScript SDK.
In Cursor, MCP Inspector, or another MCP client, calltiktok_profile_getwith:
{ "handle": "nike" }
The result contains the samedataandmetaenvelope returned by the REST API. Checkmeta.creditsChargedandmeta.requestIdafter metered calls.
- server.json- MCP Registry metadata for the hosted remote server.
- examples/- Copy-paste MCP client configuration snippets.
- assets/socialfetch-mark.svg- Local copy of the Social Fetch mark (also served athttps://api.socialfetch.dev/mcp/icon.svg).
The implementation lives in Social Fetch's private API service, not in this public listing repository.
- Social Fetch MCP docs
- Social Fetch API reference
- TypeScript SDK
- n8n community node
One social-video URL in → metadata, transcript (captions or Whisper), engagement insights, and parametric frames out. 6 platforms (YouTube, Shorts, TikTok, Instagram, Pinterest, Reddit). REST + MCP. Pay per call with x402 (USDC), no account.
Schedule, generate and publish social posts to X, LinkedIn, Instagram, Threads and YouTube from any MCP client.
Publish short-form videos to TikTok, Instagram Reels, YouTube Shorts, X, and Facebook from AI agents through the official Taisly MCP server.
Schedule, publish, and analyze social posts on TikTok, Instagram Reels, YouTube Shorts, X, Threads, and LinkedIn — 15 MCP tools for posts, media import, webhooks, and analytics.
HuiMei — Social Media Automation MCP Server
AI-native social media automation platform — publish content to 12+ platforms (Douyin, XHS/Xiaohongshu, Bilibili, Kuaishou, Weibo, Zhihu, TikTok, Toutiao, WeChat Channels & more) with a single MCP tool call. Supports video, image, and article publishing with full account management.
50+ AI tools for end-to-end social media management — brand extraction, video generation, multi-platform scheduling, analytics, and closed-loop optimization.
Check availability of domain names, social media handles and subreddits
Monitor web and social media using the Mention API.
YouTube transcript extraction for AI agents. Clean text, timestamps, or structured JSON from any video. No API keys required.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




