SocialCrawl

ridiodevelopment/socialcrawl-mcp

Gives Claude direct access to 21 social platforms including TikTok, Instagram, YouTube, Twitter, LinkedIn, and Reddit through a single unified API. Instead of managing credentials for each platform separately, you get one API key that works across 105 endpoints for profiles, posts, comments, search, and trending content. The server dynamically discovers available endpoints so Claude can explore what's possible on each platform before making requests. You'd reach for this when building social media analytics, content research tools, or anything that needs to pull data from multiple platforms without dealing with per-platform authentication. Runs via npx with just an API key from socialcrawl.com, which includes 100 free credits to start.

tools: 7
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: Nov 8, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.socialcrawl.dev/mcp --name socialcrawl --header 'Authorization: Bearer ${API_TOKEN}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http socialcrawl https://mcp.socialcrawl.dev/mcp --header 'Authorization: YOUR_AUTHORIZATION'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 7 tools

Verified live against the running server on Nov 6, 2026.

socialcrawl_findStart here: a task in plain words -> the best endpoints (3 by default) of 646, each with the params the task supplies (URLs and @handles resolved), the params still missing, the credit cost and the exact call. With no task it lists platforms, or one platform's endpoints. Free;...3 params

Start here: a task in plain words -> the best endpoints (3 by default) of 646, each with the params the task supplies (URLs and @handles resolved), the params still missing, the credit cost and the exact call. With no task it lists platforms, or one platform's endpoints. Free;...

Parameters* required

limitinteger

Endpoints to return (default 3).

platformstring

Only this platform's endpoints (slug, e.g. 'tiktok'); alone, lists them.

taskstring

The job in plain words; URLs and @handles in it are resolved and filled. Omit to list platforms.

socialcrawl_endpointRead before calling: one endpoint's purpose, params, where the rows are and up to 25 response fields, cost rule, paging, latency, timeout, next endpoints and a sample link. id (or platform+resource, path), a platform slug (its endpoints) or a guide topic. Free.3 params

Read before calling: one endpoint's purpose, params, where the rows are and up to 25 response fields, cost rule, paging, latency, timeout, next endpoints and a sample link. id (or platform+resource, path), a platform slug (its endpoints) or a guide topic. Free.

Parameters* required

id*string

'platform/resource' for its contract; a platform slug for its endpoint table; or a guide topic (errors, pricing, pagination, judgments, hydration, overview).

methodstring

Only for an id served by several methods.one of GET · POST · PATCH · DELETE

pageinteger

Page of a long guide (default 1).

socialcrawl_estimateExact credits before you spend: one call (id, platform+resource or path, plus the params you will send; calls for a job total; items for a walk) or a plan of several calls. Uses the API's estimator when available, else the bundled pricing. A platform slug gives its price table...7 params

Exact credits before you spend: one call (id, platform+resource or path, plus the params you will send; calls for a job total; items for a walk) or a plan of several calls. Uses the API's estimator when available, else the bundled pricing. A platform slug gives its price table...

Parameters* required

bodyobject

POST body, for batch endpoints.

callsinteger

Number of such calls (an array is read as plan).

idstring

'platform/resource'; a platform slug for its price table; none for the overview.

itemsinteger

Rows wanted (prices a walk).

methodstring

one of GET · POST · PATCH · DELETE

paramsobject

The exact params you will send.

planarray

Several calls to total, instead of id.

socialcrawl_requestCall one endpoint (platform+resource, or id, or path). Validated locally first (a bad call is free), quoted, refused above max_credits and confirmed above the threshold. A large page is cut at row boundaries; socialcrawl_collect result_id reads the rest. Spends credits; needs...11 params

Call one endpoint (platform+resource, or id, or path). Validated locally first (a bad call is free), quoted, refused above max_credits and confirmed above the threshold. A large page is cut at row boundaries; socialcrawl_collect result_id reads the rest. Spends credits; needs...

Parameters* required

bodyobject

JSON body for POST batch endpoints, e.g. { ids: [...] }.

confirmboolean

true only once the user approved spending above the threshold (default 100 credits).

fieldsstring

Row paths exactly as socialcrawl_endpoint lists them, e.g. 'post.id,post.content.text,post.engagement.*' (or an array). Cuts tokens.

formatstring

json (default), csv (canonical columns) or summary.one of json · csv · summary

idempotencyKeystring

Makes a retry safe: a replay returns the original response for 0 credits (24h).

max_creditsinteger

Spend cap: refused free when the quoted hold exceeds it (collect: the walk's budget).

max_itemsinteger

Show at most this many rows; the full page stays behind the result link.

methodstring

Only for a resource served by several methods (prism/jobs). Inferred: a body selects POST.one of GET · POST · PATCH · DELETE

paramsobject

Query params, e.g. { handle: 'x', limit: 10 }. Arrays join with commas (label). Sent as strings.

platform*string

Platform slug, e.g. 'tiktok'. An unknown slug gets a did-you-mean.

resource*string

Resource path, e.g. 'post/comments'; path params as 'jobs/{job_id}' + params.job_id, or the concrete path.

socialcrawl_collectWalk a paged endpoint (id, platform+resource or path) to `items` unique rows, the last page or max_credits: cursors supplied, duplicates dropped, stops on a 402, refused free when one page exceeds max_credits. Small results come back whole. result_id (+offset, limit, format) r...10 params

Walk a paged endpoint (id, platform+resource or path) to `items` unique rows, the last page or max_credits: cursors supplied, duplicates dropped, stops on a 402, refused free when one page exceeds max_credits. Small results come back whole. result_id (+offset, limit, format) r...

Parameters* required

confirmboolean

true only once the user approved spending above the threshold (default 100 credits).

fieldsstring

Row paths as socialcrawl_endpoint lists them, e.g. 'comment.text,comment.engagement.likes'.

formatstring

jsonl (default), json or csv.one of jsonl · json · csv

idstring

platform/resource of a paged endpoint, e.g. 'tiktok/post/comments'.

itemsinteger

Stop once this many unique rows are collected.

limitinteger

result_id: rows (200).

max_creditsinteger

Spend cap: refused free when the quoted hold exceeds it (collect: the walk's budget).

offsetinteger

result_id: first row.

paramsobject

Params for every page, as in socialcrawl_request. No cursor.

result_idstring

Read a stored result instead of walking. Free.

socialcrawl_accountFree checks: balance (with this session's spend), transactions (itemised ledger; the receipts for one request_id), status (platform health; read it before retrying a 502/503) and freshness (whether this server's bundled catalogue is behind the API).4 params

Free checks: balance (with this session's spend), transactions (itemised ledger; the receipts for one request_id), status (platform health; read it before retrying a 502/503) and freshness (whether this server's bundled catalogue is behind the API).

Parameters* required

cursorstring

transactions: next_cursor from the last page.

limitinteger

transactions: page size.

request_idstring

transactions: receipts for one request.

viewstring

balance (default, with this session's spend), transactions (ledger), status (platform health), freshness (catalogue vs live API).one of balance · transactions · status · freshness

socialcrawl_manageStateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused fr...6 params

Stateful work by area + action: monitors (scheduled recipes, webhooks, alerts), cohorts (mention search over your own panel of accounts), web (scrape, search, crawl and agent jobs, change monitors, browser sessions) and jobs (Prism background jobs). A wrong field is refused fr...

Parameters* required

action*string

area*string

What to manage.one of monitors · cohorts · web · jobs

dry_runboolean

idstring

Monitor, cohort, query, web job/monitor/session or prism job id.

idempotencyKeystring

For web crawl/batch, cohort writes and job submit.

inputobject

The action's fields, e.g. { recipe, cadence }, { url }, { keywords }, or the job body (max_credits, confirm allowed). Monitor alert rules, incl. rows_new: socialcrawl_endpoint id=monitors.

Configuration

SOCIALCRAWL_API_KEY*secret

Your SocialCrawl API key. Get a free key at socialcrawl.dev (100 credits, no credit card required).

Readme

socialcrawl-mcp

MCP server for SocialCrawl — access 21+ social media platforms through one unified API.

What it does

SocialCrawl MCP gives AI agents instant access to 21 social media platforms and 105 endpoints through a single, unified API. Retrieve profiles, posts, comments, search results, trending content, and analytics from TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Reddit, and more — no per-platform authentication required. Agents discover available endpoints dynamically, so they always work with the latest capabilities without any hardcoded platform logic.

Quick Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "your_api_key_here"
      }
    }
  }
}

View the full README on GitHub

Details

Repository: github.com/ridiodevelopment/socialcrawl-mcp
Categories: Data & Analytics, Finance & Commerce, Media & Entertainment
Package: socialcrawl-mcp
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Resources: 7
Prompts: 42
Tools verified: Nov 6, 2026

Related Data & Analytics MCP servers

View all

Configrog0x/mcp-config-toolsJSON, YAML, TOML, INI config tools for AI agents0stars

yellideurbanmorph/overlookedSpecies of India: find species, where they occur, and their status, from open biodiversity data.0stars

Databazaarshagarwal/databazaar-mcpSearch and preview datasets publicly. Account-required full data via MCP.0stars

Syncky Healthsyncky/syncky-openApple Health data, end-to-end encrypted between iPhone and local Syncky agent, allowed write-back0stars

Tollt0ll-xyz/toll-pluginsRobinhood Chain checks for agents: coins, devs, ERC-8004 agents, pre-sign check, Stock Token data.0stars

DataGraphio.github.team-earth/datagraphUrban intelligence knowledge graph. Structured locality data for civic problem-solving.0stars