@socialrouter/mcp package is an MCP server that lets LLM agents call SocialRouter directly. Plug it into Claude Desktop, Claude Code, Cursor, or any MCP-compatible client and the agent gains the ability to extract social media data, run query-driven searches, browse providers, and check credits — without writing glue code.
Supported platforms include LinkedIn, Instagram, X, Reddit, Facebook, TikTok, YouTube, Pinterest, Bluesky, Snapchat, and Google Maps.
Configuration
Get an API key at socialrouter.io, then add the server to your MCP client config.Claude Desktop / Claude Code
Cursor
Add the same block to~/.cursor/mcp.json.
Tools
| Tool | Description |
|---|---|
extract | URL-driven extraction. Pass url (single) or urls (batch). |
search | Query-driven search (e.g. Google Maps place search). |
list_providers | List providers with their status, supported platforms, and supported extraction/search types. |
get_provider | Get a single provider’s details and pricing (extraction + search). |
get_extraction | Retrieve a previous extraction or search by ID. |
get_balance | Check the SocialRouter credit balance. |
get_usage | Get a usage summary by provider and platform. |
extract parameters
| Param | Required | Description |
|---|---|---|
url | one of url/urls | Single social media URL. |
urls | one of url/urls | Batch list of URLs (only effective for batch-capable actors). |
provider | yes | Service slug provider/platform/type[:tag] (e.g. apify/linkedin/profile.info, apify/linkedin/profile.posts:apimaestro). Copy from socialrouter.io/providers. |
limit | no | Max records (default 100). |
fallback | no | Whether to fall over to alternative providers on failure (default true). |
search parameters
| Param | Required | Description |
|---|---|---|
queries | yes | Non-empty list of search queries (terms or context-pinning URLs). |
provider | yes | Slug whose type is a search type, e.g. apify/googlemaps/place.search. |
limit | no | Per-query record cap (default 100). |
fallback | no | Whether to fall over to alternative providers on failure (default true). |
Environment variables
| Variable | Required | Default |
|---|---|---|
SOCIALROUTER_API_KEY | yes | — |
SOCIALROUTER_BASE_URL | no | https://api.socialrouter.io |