SocialRouter MCP Server

An MCP server that exposes the SocialRouter API to LLM agents. Plug it into Claude Desktop, Claude Code, Cursor, or any MCP-compatible client to let the agent extract social media data and run query-driven searches through a single unified API.

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

{
  "mcpServers": {
    "socialrouter": {
      "command": "npx",
      "args": ["-y", "@socialrouter/mcp"],
      "env": {
        "SOCIALROUTER_API_KEY": "sr_live_xxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json with the same shape.

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 available providers and their supported platforms/types. | | get_provider | Get a single provider's details and pricing. | | get_extraction | Retrieve a previous extraction or search by ID. | | get_balance | Check your 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 |

License

MIT