Claude Code
Give Claude Code current public social media, commerce, and review data with a one-line install. Documented endpoint caches apply.
Add one line to your terminal and Claude Code can pull current public data from 69 platforms, subject to each endpoint's documented cache window, with no HTTP plumbing to write.
Two transports, same seven tools. The hosted server needs nothing installed;
the local one runs the socialcrawl-mcp package through npx.
Prerequisites
- Claude Code installed and signed in.
- A SocialCrawl API key from socialcrawl.dev, under Dashboard → API Keys. Every account starts with 100 free credits, no card required.
- For the local transport only: Node.js with
npxavailable.
Server URL
https://mcp.socialcrawl.dev/mcpHow do I give Claude Code access to social media data?
Register the server
Hosted, which is the shorter path:
claude mcp add --transport http socialcrawl https://mcp.socialcrawl.dev/mcp \
--header "Authorization: Bearer YOUR_API_KEY"Or local, if you would rather run the package on your own machine:
claude mcp add --scope user socialcrawl -e SOCIALCRAWL_API_KEY=YOUR_API_KEY -- npx -y socialcrawl-mcpFlags go before the -- separator; everything after it is the command Claude Code runs. --scope user makes the server available in every project.
Restart Claude Code
The server list is read at startup, so quit and reopen before you expect the tools to appear.
Ask for something
Get the TikTok profile for @charlidamelioSearch YouTube for machine learning tutorialsClaude Code picks the platform and endpoint, calls the API, and reads back structured JSON. Start with a discovery question ("which SocialCrawl platforms are available?") to confirm the connection for free.
Using Claude Desktop, Cursor, VS Code, or Windsurf instead? The per-client configuration blocks are on Skills & MCP.
What tools does the agent get?
Seven, in four groups.
| Group | Tools | Cost |
|---|---|---|
| Discovery | socialcrawl_find, socialcrawl_endpoint, socialcrawl_estimate | 0 credits, no API key needed |
| Data | socialcrawl_request, socialcrawl_collect | The endpoint's own price, 0 on a cache hit |
| Account | socialcrawl_account | 0 credits |
| Stateful | socialcrawl_manage (Monitors, cohorts, web, Prism jobs) | Free to manage; runs and scrapes bill |
The three discovery tools need no key, so the agent can find the endpoint for a task, read its parameters and price the call before it spends anything. socialcrawl_collect walks a paged endpoint to the number of rows you ask for in one call. Before every billed call, the server validates locally that the platform, endpoint, and required parameters exist, and tells the agent how to fix a bad call instead of burning a credit.
For the full tool table, see Skills & MCP or the MCP server page.
What does it cost?
Credits are billed exactly as the REST API bills them: most endpoints are 1 credit, heavier ones 5 or 10, and composite or bundle endpoints carry their own price (search/everywhere is a flat 20). Cache hits cost 0 credits, and so do the discovery tools and socialcrawl_account. See Endpoint pricing for the exact figure per endpoint, Credits for how the ledger works, or Pricing for credit packs.