`socialcrawl-mcp` is an MCP server that connects AI agents to the [SocialCrawl API](https://socialcrawl.dev) — a unified social media data API covering 21 platforms and 108 endpoints.
Retrieve profiles, posts, comments, search results, trending content, and analytics from TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Reddit, and 15 more platforms. One API key, one consistent response format, every platform.
**What the MCP server does:**
- Discovers available platforms and endpoints dynamically
- Fetches live social media data on your behalf
- Validates requests locally before making API calls (saves credits)
- Provides built-in API documentation the agent can query on demand
## Installation
### Claude Code (quickest)
```bash
claude mcp add --scope user socialcrawl -- npx -y socialcrawl-mcp
```
Then set your API key:
```bash
claude mcp add-env socialcrawl SOCIALCRAWL_API_KEY sc_your_key_here
```
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
## Setup
### 1. Get your API key
Sign up at [socialcrawl.dev](https://socialcrawl.dev) and grab your API key from the dashboard. Every account starts with **100 free credits** — no credit card required.
### 2. Add the key to your config
Replace `sc_your_key_here` in the installation config above with your actual API key (starts with `sc_`).
> [!TIP]
> You can also set `SOCIALCRAWL_API_KEY` as a system environment variable instead of putting it in the MCP config. The discovery and documentation tools work even without a key — only actual API requests need one.
## Usage
Ask your AI agent in natural language. The MCP server handles the rest.