socialscrape — Claude Code MCP server: features and setup
The socialscrape MCP server for Claude Code gives agents access to social profiles, posts, comments, ad data, search, and transcripts. API calls use team credits.
MIT updated 2026-11-12
claude mcp add --transport http socialscrape https://api.socialscrape.dev/mcpWhat socialscrape does
socialscrape gives agents tools to search social platforms and retrieve profiles, posts, comments, ads, and transcripts. It includes cross-platform tools alongside platform-specific ones; available platform tools depend on which API endpoints have been built. The describe tool returns parameters and pricing without making an API request.
The server can connect through SocialScrape’s hosted service or run locally as a subprocess over stdio. Local tool calls need SOCIALSCRAPE_API_KEY and uvx socialscrape-mcp; tool discovery works without a key, but calling a tool requires one. Running an HTTP copy requires installing socialscrape-mcp[http] and starting socialscrape-mcp http --host 127.0.0.1 --port 8080.
Calls are charged to the team. Set SOCIALSCRAPE_PLATFORMS or SOCIALSCRAPE_TOOLSETS to limit the available tools. SOCIALSCRAPE_MCP_MAX_CHARS caps long responses, while transcripts are returned in windows.
What it helps with
- search social platforms for posts about a topic
- retrieve a user profile and its posts
- fetch comments on a post
- get a video transcript
- check an endpoint’s parameters and price
Example prompts for the agent
- Find posts about this topic on Twitter and show their authors.
- Retrieve this user’s profile and recent posts.
- Get the video transcript and return it in sections.
How to install socialscrape
1Platform CLI: remote server
claude mcp add --transport http socialscrape https://api.socialscrape.dev/mcp2Platform CLI
claude mcp add --env SOCIALSCRAPE_API_KEY=<SOCIALSCRAPE_API_KEY> --transport stdio socialscrape -- uvx socialscrape-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from socialscrape-mcp <command>
1Platform CLI: remote server
codex mcp add socialscrape --url https://api.socialscrape.dev/mcp2Platform CLI
codex mcp add socialscrape --env SOCIALSCRAPE_API_KEY=<SOCIALSCRAPE_API_KEY> -- uvx socialscrape-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from socialscrape-mcp <command>
Config file
{
"mcpServers": {
"socialscrape": {
"url": "https://api.socialscrape.dev/mcp"
}
}
}{
"mcpServers": {
"socialscrape": {
"command": "uvx",
"args": [
"socialscrape-mcp"
],
"env": {
"SOCIALSCRAPE_API_KEY": "<SOCIALSCRAPE_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from socialscrape-mcp <command>
Config file
{
"servers": {
"socialscrape": {
"type": "http",
"url": "https://api.socialscrape.dev/mcp"
}
}
}{
"servers": {
"socialscrape": {
"type": "stdio",
"command": "uvx",
"args": [
"socialscrape-mcp"
],
"env": {
"SOCIALSCRAPE_API_KEY": "<SOCIALSCRAPE_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from socialscrape-mcp <command>
1Platform CLI: remote server
gemini mcp add -t http socialscrape https://api.socialscrape.dev/mcp2Platform CLI
gemini mcp add -e SOCIALSCRAPE_API_KEY=<SOCIALSCRAPE_API_KEY> socialscrape uvx socialscrape-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from socialscrape-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about socialscrape
How do I install socialscrape in Claude Code?
For the hosted server, run claude mcp add --transport http socialscrape https://api.socialscrape.dev/mcp, then open /mcp and sign in to your SocialScrape account.
What does socialscrape do?
It gives an agent tools for social search and for retrieving profiles, posts, comments, ads, and transcripts. API calls consume team credits.
What does socialscrape need to run?
Local use requires the SOCIALSCRAPE_API_KEY key and the uvx socialscrape-mcp command. The hosted server can use a SocialScrape account sign-in or an API key.