Live on npm and the MCP Registry — npx socialcrawl-mcp
An MCP server that hands your agent social media data
Run npx socialcrawl-mcp and your agent gets 42 platforms and 264 endpoints as native tools — one key, one schema, every social platform. Works in Claude, Cursor, Windsurf, Codex, and any MCP client.
Searching 42 platforms in parallel
TikTok·
Instagram·
YouTube·
Facebook·
X·
LinkedIn·
Reddit·
Threads·
Pinterest·
Twitch·
Truth Social·
Snapchat·
Kick·
Bluesky·
Kwai·
Rumble·
Spotify·TikTok Shop·
Amazon Shop·
Google Shopping·
Trustpilot·
TripAdvisor·
Linktree·
Komi·
Pillar·
lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·
Polymarket·
Tavily·
Hacker News·
GitHub·
Perplexity·
Naver·UUtility·
Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·UUtility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·UUtility·Universal SearchTikTok·Instagram·YouTube·Facebook·X·LinkedIn·Reddit·Threads·Pinterest·Twitch·Truth Social·Snapchat·Kick·Bluesky·Kwai·Rumble·Spotify·TikTok Shop·Amazon Shop·Google Shopping·Trustpilot·TripAdvisor·Linktree·Komi·Pillar·lnk.bio·Facebook Ads·Google Ads·LinkedIn Ads·Google Search·Google News·Google Finance·Polymarket·Tavily·Hacker News·GitHub·Perplexity·Naver·UUtility·Universal SearchHow do I add SocialCrawl to Claude, Cursor, or Windsurf?
MCP — the Model Context Protocol — is how AI clients load external tools. The SocialCrawl MCP server speaks it over stdio, so once it's registered your agent can pull social data without you wiring a single HTTP call. Claude Code takes two commands; every other client takes one JSON block.
Claude Code
Add the server, then attach your sc-prefixed key:
claude mcp add --scope user socialcrawl -- npx -y socialcrawl-mcp
claude mcp add-env socialcrawl SOCIALCRAWL_API_KEY sc_your_key_hereClaude Desktop · Cursor · VS Code · Windsurf
Drop this into your client's MCP config file and restart:
{
"mcpServers": {
"socialcrawl": {
"command": "npx",
"args": ["-y", "socialcrawl-mcp"],
"env": {
"SOCIALCRAWL_API_KEY": "sc_your_key_here"
}
}
}
}What can your agent actually do with the SocialCrawl MCP server?
Four tools, and three of them run on bundled local data — so your agent can explore every platform, every endpoint, and the docs before it ever spends a credit. Only the call that fetches live data needs your key.
socialcrawl_list_platformsWorks without a keyLists all 42 platforms the API covers, with their endpoints and capabilities. Your agent reads it straight from bundled data — no call, no credit.
socialcrawl_list_endpointsWorks without a keyReturns every endpoint for a platform with its required parameters and credit cost, so the agent plans a call before making it.
socialcrawl_requestAPI key requiredMakes any SocialCrawl API call across all 264 endpoints. It validates the platform, endpoint, and parameters locally first, so a malformed call never burns a credit.
socialcrawl_get_docsWorks without a keyPulls API documentation by topic or platform from bundled reference data — the agent answers its own questions without leaving the session.
What makes the SocialCrawl MCP server different from a single-platform tool?
Most social MCP servers wrap one platform. This one is the whole API: 42 platforms behind a single tool call, every response in the same shape, and the plumbing your agent would otherwise generate per platform already handled on our side.
One server, every platform
42 platforms in one tool, not one tool per platform
Your agent calls socialcrawl_request with a platform and endpoint and reaches TikTok, Instagram, YouTube, Reddit, LinkedIn, Amazon, and the rest. Adding a platform to an agent workflow is a parameter, not a new integration.
Map the tool once, reach every platform
Predictable agent output
The same response shape on every platform
Author IDs, engagement counts, timestamps, and media URLs land in the same keys whatever the source. Predictable fields mean predictable agent reasoning — no per-platform prompt branching.
One schema your prompts can rely on
Discovery before spend
Three of four tools run with no key
Platform discovery, endpoint inspection, and docs all read bundled local data. An agent can scope an entire task — and validate the exact call — before a single credit moves.
Explore the whole API for free
Plumbing handled
Typed responses, retries, and rate limits, server-side
Rate limits, retries, and token rotation live on our side of the wire. The agent sends one sc-prefixed key and gets back clean, typed JSON — no proxy pool, no OAuth dance per platform.
One key, no per-platform tokens
What does the MCP server give an agent that raw HTTP doesn't?
Local validation that saves credits, zero-key discovery, and one consistent schema across 42 platforms — the parts an agent would otherwise have to learn, retry, and re-derive on every call.
Local validation
Bad calls are caught before they cost a credit
Before socialcrawl_request hits the network it checks the platform exists, the endpoint exists, and every required parameter is present. If something's off it tells the agent how to fix it — no credit spent.
Zero-key discovery
Explore the whole API before you sign up
List platforms, inspect endpoints, and read docs entirely from bundled data. An agent can map a task end to end before a key is ever attached.
Broad client support
Works in every MCP client you already use
Claude Code, Claude Desktop, Cursor, Windsurf, Codex, OpenClaw, and any other MCP-compatible client connect over the same stdio transport.
Frequently asked questions about the SocialCrawl MCP server
Want the setup details? Read the Skills and MCP server install guide for every client.
What is the SocialCrawl MCP server?
It's an MCP server — an npm package called socialcrawl-mcp — that connects any MCP-compatible AI client to the SocialCrawl API. Once it's registered, your agent gets 42 platforms and 264 endpoints of social media data as native tools, all behind one key and one response schema. You install it with npx socialcrawl-mcp; it speaks the Model Context Protocol over stdio.
How do I add SocialCrawl to Claude, Cursor, or Windsurf?
In Claude Code, run claude mcp add --scope user socialcrawl -- npx -y socialcrawl-mcp, then attach your key with claude mcp add-env. For Claude Desktop, Cursor, VS Code, or Windsurf, add a socialcrawl entry to your client's MCP config that runs npx -y socialcrawl-mcp with SOCIALCRAWL_API_KEY in its env, then restart the client. Full per-client steps are on the install docs page.
Do I need an API key to use the MCP server?
Only for live data. Three of the four tools — listing platforms, listing endpoints, and fetching docs — read bundled local data and need no key, so an agent can explore the whole API for free. The fourth tool, socialcrawl_request, makes the actual API call and needs an sc-prefixed key. You can see exactly what each call costs on the API pricing page.
Which platforms can my agent reach through the MCP server?
All 42 platforms the SocialCrawl API covers — TikTok, Instagram, YouTube, Reddit, LinkedIn, Amazon, and the long-tail platforms most providers skip — across 264 endpoints. Every one returns the same response shape, so your agent's reasoning doesn't change when you point it at a new source.
Is the SocialCrawl MCP server on the MCP Registry?
Yes. socialcrawl-mcp is published on both npm and the MCP Registry, so clients that browse the registry can discover and install it directly. It's the same package either way — npx -y socialcrawl-mcp.
How much does the MCP server cost?
The server itself is free and open to install. You only spend credits when socialcrawl_request fetches live data, billed at a flat credit per endpoint — and every account starts with 100 free credits and no credit card. Discovery and docs tools never cost anything.
Which MCP clients does it work with?
Claude Code, Claude Desktop, Cursor, Windsurf, Codex, OpenClaw, and any other MCP-compatible client. They all connect over the same stdio transport, so the install is the same npx command plus your key wherever you run it.
Can I build a full AI agent on the SocialCrawl MCP server?
Yes — that's what it's for. Because the server handles discovery, local validation, retries, and rate limits, your agent focuses on the task instead of the plumbing. It pairs naturally with social media data for AI agents, where the same unified schema keeps agent output predictable across every platform.
Ask an AI which MCP server to use for social data