SocialScrape
Get an API key
MCP for AI agents
  1. Docs
  2. MCP for AI agents

MCP for AI agents

Run the SocialScrape MCP server on your own machine and use every endpoint as a tool in Claude, Cursor, VS Code and other MCP clients.

The SocialScrape MCP server gives an AI agent the whole API as tools, so it can look up a profile, read comments or fetch a transcript without you writing glue code. It runs on your own machine: your MCP client starts it as a subprocess. SocialScrape does not run a hosted MCP server, so there is no MCP URL to connect to. Credits are the same as the REST API: failures and cached repeats are free.

Tools#

The server groups the endpoints so an agent sees a usable number of tools instead of one per endpoint. The tools are generated from the same registry as the API reference, and only built endpoints appear.

ToolsWhat they do
get_transcript, search, get_profile, get_post, get_commentsThe jobs agents do most, across platforms. The platform is an argument.
One per platform, such as github or facebookresource picks the data (user, profile.posts, and so on); the parameters follow.
describeExact parameters, allowed values, price and example arguments for any endpoint. Free, makes no API call.
call_endpoint, batch, get_job, monitors, get_creditsAny endpoint by id, up to 100 requests in one call, long jobs, webhooks and the balance.

Every result starts with a line such as ok | credits charged: 1 | credits remaining: 4999. A failure comes back as an error result with the API's error code, a retryable flag and what to do next. Tool parameters use the API's own names, including max_age_days and cursor.

Connect#

Use your normal API key. Create a key per agent in the dashboard so you can see its usage and revoke it alone.

The server is the Python package socialscrape-mcp. Add it to a client that starts servers as subprocesses, such as Claude Desktop, Claude Code or Cursor. uv runs it without a separate install step:

1{2  "mcpServers": {3    "socialscrape": {4      "command": "uvx",5      "args": ["socialscrape-mcp"],6      "env": { "SOCIALSCRAPE_API_KEY": "YOUR_KEY" }7    }8  }9}

The key stays on your machine and goes to the SocialScrape API with each request. A client that can only connect to a URL cannot use this server today.

Some clients limit how many tools they accept. To narrow the list, set SOCIALSCRAPE_PLATFORMS (for example github,threads) or SOCIALSCRAPE_TOOLSETS=core in the env block. With core alone an agent still reaches every endpoint through describe and call_endpoint.

Running out of credits#

An agent that runs out gets a 402 insufficient_credits result with payment details. An agent that can pay can buy a pack on its own; see Credits and pricing. To keep spending bounded, give each agent its own key on a team with a small balance.

Tips for agents#

  • Tell the agent to pass max_age_days when freshness is not critical; repeats then cost nothing.
  • The server asks for trim=true by default to keep results short and save context.
  • For many lookups, prefer batch over many single calls.
  • llms.txt and llms-full.txt hold these docs in a form models read well.