@creatorcrawl/mcp

Official Model Context Protocol (MCP) server for CreatorCrawl. Gives any MCP-compatible AI agent — Claude Desktop, Claude Code, Cursor, Windsurf, Zed, and more — 60+ tools for TikTok, Instagram, YouTube, LinkedIn, Twitter/X, and Reddit.

Profiles, posts, comments, transcripts, ads, search, and trending data as structured JSON.

Two ways to run it

Stdio (local install) — for desktop clients

# Claude Code
claude mcp add creatorcrawl \
  --env CREATORCRAWL_API_KEY=YOUR_API_KEY \
  -- npx -y @creatorcrawl/mcp

# Claude Desktop / Cursor / Windsurf — add to your MCP config
{
  "mcpServers": {
    "creatorcrawl": {
      "command": "npx",
      "args": ["-y", "@creatorcrawl/mcp"],
      "env": { "CREATORCRAWL_API_KEY": "YOUR_API_KEY" }
    }
  }
}

Streamable HTTP (hosted) — for cloud agents

# Claude Code
claude mcp add creatorcrawl \
  --transport streamable-http \
  --header x-api-key=YOUR_API_KEY \
  -- https://app.creatorcrawl.com/api/mcp

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

Get an API key

Tool reference

60+ tools across six platforms:

TikTok: profile, profile-videos, video-info, transcript, search-keyword, search-users, comments, popular-creators, popular-hashtags, popular-songs, popular-videos, trending-feed
Instagram: profile, basic-profile, posts, reels, post-info, comments, transcript, story-highlights, highlights-details, search-reels, embed
YouTube: channel, channel-videos, channel-shorts, video, search, search-hashtag, transcript, comments, playlist, trending-shorts
LinkedIn: profile, company, company-posts, post, ads-search, ad
Twitter / X: profile, tweet, user-tweets, transcript, community, community-tweets
Reddit: search, subreddit-details, subreddit-posts, subreddit-search, post-comments

Each tool returns structured JSON. See the full schema at https://creatorcrawl.com/mcp-docs.

Response shape (v0.2.0+)

As of 0.2.0, all tools return a canonical normalized shape across every platform:

snake_case fields everywhere (follower_count, created_at, avatar_url)
ISO 8601 timestamps (2025-04-12T15:30:00Z)
Unified envelope: { data, page?, meta }
Every tool advertises an outputSchema (MCP 2025-06-18 spec)
Tool calls return both content (LLM-readable summary) and structuredContent (full typed envelope)

Example tool call result

{
  "content": [{ "type": "text", "text": "Found creator @mrbeast (YouTube) — 320M followers." }],
  "structuredContent": {
    "data": {
      "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
      "handle": "mrbeast",
      "name": "MrBeast",
      "bio": "SUBSCRIBE FOR A COOKIE!",
      "url": "https://youtube.com/@mrbeast",
      "avatar_url": "https://...",
      "verified": true,
      "follower_count": 320000000,
      "post_count": 812,
      "view_count": 67000000000,
      "platform": "youtube"
    },
    "meta": { "platform": "youtube", "fetched_at": "2026-05-15T12:00:00Z" }
  }
}

Example list/search result with pagination

{
  "content": [{ "type": "text", "text": "20 posts from @creator." }],
  "structuredContent": {
    "data": [
      {
        "id": "7349...",
        "url": "https://www.tiktok.com/@creator/video/7349...",
        "type": "video",
        "created_at": "2026-04-30T18:14:22Z",
        "text": "Post caption...",
        "media": [{ "type": "video", "url": "...", "thumbnail_url": "..." }],
        "view_count": 1240000,
        "like_count": 98000,
        "comment_count": 1200,
        "share_count": 4500,
        "author": { "id": "...", "handle": "creator", "name": "Creator", "platform": "tiktok" },
        "platform": "tiktok"
      }
    ],
    "page": { "cursor": "eyJvZmZzZXQiOjIwfQ==", "has_more": true },
    "meta": { "platform": "tiktok", "fetched_at": "2026-05-15T12:00:00Z" }
  }
}

Breaking change in 0.2.0: field names, casing, and envelope structure changed. If you were parsing the previous response shape, update your consumers.

Configuration

Env var	Required	Description
`CREATORCRAWL_API_KEY`	yes	Your CreatorCrawl API key
`CREATORCRAWL_MCP_URL`	no	Override the upstream URL (default: `https://app.creatorcrawl.com/api/mcp`)

Pricing

Pay-as-you-go credits starting at $29 for 5,000 calls. Most tools cost 1 credit per call. Full pricing at creatorcrawl.com/#pricing.

Companion packages

TypeScript SDK: @creatorcrawl/sdk — direct API client for code workflows
Agent Skill: creatorcrawl/creatorcrawl-skill — teaches agents how to use the MCP server effectively
Docs: creatorcrawl.com/mcp-docs

License

MIT

@creatorcrawl/mcp