Social Media MCP Server for AI Agents

The Model Context Protocol (MCP) is an open standard from Anthropic that lets AI assistants connect to external tools. CreatorCrawl ships an MCP server that exposes 58 tools across 6 platforms. Point your MCP client at the endpoint and your agent gets typed access to profiles, videos, comments, transcripts, ads, search, and trending data.

Ask Claude to "find 10 fitness creators on TikTok with over 100k followers and pull their last 5 videos" and it handles the tool calls for you.

#Prerequisites

1. Create a CreatorCrawl account at creatorcrawl.com for 250 free credits, no card required.
2. Generate an API key from the API Keys page in your dashboard.

#Endpoint

CreatorCrawl uses Streamable HTTP transport at a single endpoint:

https://app.creatorcrawl.com/api/mcp

Authenticate by passing your API key in the x-api-key header.

#Claude Desktop

Open Claude Desktop settings, go to the MCP section, and add this config. Or edit claude_desktop_config.json directly:

{
  "mcpServers": {
    "creatorcrawl": {
      "url": "https://app.creatorcrawl.com/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

#Claude Code (CLI)

Run this command in your terminal:

claude mcp add creatorcrawl \
  --transport http \
  "https://app.creatorcrawl.com/api/mcp" \
  --header "x-api-key: YOUR_API_KEY"

#Cursor

Open Cursor settings, go to MCP, and add this server config. Or add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "creatorcrawl": {
      "url": "https://app.creatorcrawl.com/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

#Windsurf

Open Windsurf settings, go to MCP, and add this server config. Or add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "creatorcrawl": {
      "serverUrl": "https://app.creatorcrawl.com/api/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

#Other MCP Clients

Any MCP client that supports Streamable HTTP transport works. Point it to https://app.creatorcrawl.com/api/mcp with your API key in the x-api-key header.

#Available Tools

Each tool call costs 1 credit. The full set follows.

#TikTok (20 tools)

Tool	Description
get_profile	Fetch a TikTok profile by handle
get_profile_videos	Get videos from a profile with pagination
get_video	Get detailed video metadata and stats
get_video_comments	Get comments on a video
get_video_transcript	Extract spoken transcript from a video
get_creator_transcripts	Bulk transcripts for a creator's recent videos
get_followers	Get followers of a user
get_following	Get accounts a user follows
get_live	Check live stream status and viewer count
search_keyword	Search videos by keyword with filters
search_hashtag	Search videos by hashtag
search_users	Search for TikTok users
search_top	Search top results across all content types
get_trending_feed	Get the trending/For You feed by region
get_popular_videos	Get popular videos
get_popular_creators	Get popular creators
get_popular_hashtags	Get popular hashtags
get_popular_songs	Get popular songs and sounds
get_song	Get details for a specific song
get_song_videos	Get videos using a specific song

#Instagram (11 tools)

Tool	Description
get_instagram_profile	Full profile with stats, bio links, and recent posts
get_instagram_basic_profile	Lightweight profile lookup
get_instagram_posts	Get a user's recent posts
get_instagram_post	Single post by URL with full metadata
get_instagram_comments	Comments on a post
get_instagram_reels	A user's reels
search_instagram_reels	Search reels by query
get_instagram_transcript	Transcript of a reel or video
get_instagram_story_highlights	List a user's story highlights
get_instagram_highlight_details	Stories inside a specific highlight
get_instagram_embed	Embeddable HTML for a post

#YouTube (10 tools)

Tool	Description
get_youtube_channel	Channel profile, subscriber count, total views
get_youtube_channel_videos	List videos for a channel
get_youtube_channel_shorts	List shorts for a channel
get_youtube_video	Single video metadata
get_youtube_comments	Comments on a video
get_youtube_transcript	Captions or auto-generated transcript
get_youtube_playlist	Playlist contents
search_youtube	Keyword search across YouTube
search_youtube_hashtag	Hashtag search
get_youtube_trending_shorts	Currently trending shorts

#LinkedIn (6 tools)

Tool	Description
get_linkedin_profile	Full LinkedIn profile with experience and recent activity
get_linkedin_company	Company page with headcount and overview
get_linkedin_company_posts	Recent posts from a company page
get_linkedin_post	Single post and its engagement
search_linkedin_ads	Search the LinkedIn Ad Library
get_linkedin_ad	Full creative and targeting for a single ad

#Twitter / X (6 tools)

Tool	Description
get_twitter_profile	Profile bio, followers, and stats
get_twitter_user_tweets	Recent tweets from a user
get_twitter_tweet	Single tweet with replies and engagement
get_twitter_transcript	Transcript from a video tweet
get_twitter_community	Community details
get_twitter_community_tweets	Tweets inside a Community

#Reddit (5 tools)

Tool	Description
get_reddit_subreddit_details	Subreddit size, activity, rules
get_reddit_subreddit_posts	Posts from a subreddit (sort by hot/new/top)
search_reddit_subreddit	Search within a specific subreddit
get_reddit_post_comments	Full nested comment tree for a post
search_reddit	Search across all of Reddit

#Example Prompts

Once connected, try asking your AI assistant things like:

• "Get the profile stats for @charlidamelio on TikTok"
• "Find 10 fitness Instagram creators with over 100k followers and rank by engagement"
• "Pull the last 20 tweets from @elonmusk and summarise the themes"
• "Search LinkedIn ads for Linear and tell me what audiences they are targeting"
• "Get the top 50 posts from r/webscraping this week and cluster by topic"
• "Pull the transcript of this YouTube video and write a one-paragraph summary"
• "What hashtags are trending on TikTok in the US right now"

#Credits and Billing

Every MCP tool call costs 1 credit, the same as a regular API call. Your free account starts with 250 credits. Credits never expire.

When you run out, your AI assistant will receive an error message explaining the credit limit. Buy more credits from the pricing page.

#REST API

Prefer to call the API directly? Browse the full API Reference or individual endpoint pages under /endpoints.