The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. Instead of writing API calls yourself, you tell your AI assistant what you need and it calls CreatorCrawl tools automatically.
Ask Claude to “analyze @charlidamelio’s latest videos” and it fetches the data for you.
Prerequisites
- Create a CreatorCrawl account at creatorcrawl.com to get 250 credits instantly, no card required.
- Generate an API key from the API Keys page in your dashboard.
Endpoint
CreatorCrawl uses Streamable HTTP transport at a single endpoint:
https://creatorcrawl.com/api/mcpClaude 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://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://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://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://creatorcrawl.com/api/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}Other MCP Clients
Any MCP client that supports Streamable HTTP transport will work. Point it to https://creatorcrawl.com/api/mcp with your API key in the x-api-key header.
Available Tools
Once connected, your AI assistant can use any of these 19 tools. Each call costs 1 credit.
| Tool | Description |
|---|---|
get_profile | Fetch a TikTok profile by handle |
get_profile_videos | Get videos from a profile with pagination |
get_followers | Get followers of a user |
get_following | Get accounts a user follows |
get_live | Check live stream status and viewer count |
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 |
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_popular_videos | Get trending popular videos |
get_popular_creators | Get trending popular creators |
get_popular_hashtags | Get trending popular hashtags |
get_popular_songs | Get trending popular songs and sounds |
get_trending_feed | Get the trending/For You feed by region |
get_song | Get details for a specific song |
get_song_videos | Get videos using a specific song |
Example Prompts
Once connected, try asking your AI assistant things like:
- “Get me the profile stats for @charlidamelio”
- “What are the trending hashtags on TikTok right now?”
- “Find fitness creators with over 1M followers”
- “Analyze the top comments on this TikTok video”
- “Search for videos about ‘AI tutorial’ from this week”
- “Get the transcript of this TikTok video”
- “Show me the most popular TikTok creators by engagement”
- “What songs are trending on TikTok in the US?”
Credits and Billing
Every MCP tool call costs 1 credit, the same as a regular API call. Your free account starts with 250 credits.
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? Check out the full API Reference powered by Scalar, or browse individual endpoint docs like Get Profile, Search Keyword, and Trending Feed.