CreatorDB MCP Server

An MCP (Model Context Protocol) server that provides access to the CreatorDB Headless API V3 for influencer marketing data across Instagram, YouTube, and TikTok.

Features

This MCP server exposes 31 tools covering all CreatorDB API V3 endpoints:

General Operations

• get_api_usage - Get API usage statistics and quota consumption

Instagram (11 tools)

• instagram_get_profile - Complete profile with metadata, stats, hashtags, niches

• instagram_get_contact - Contact information (emails)

• instagram_get_content_detail - Detailed content information

• instagram_get_performance - Engagement rates, likes, comments, consistency scores

• instagram_get_performance_history - Historical performance data

• instagram_get_sponsorship - Sponsored content information

• instagram_get_audience - Demographics: country, gender, age breakdown

• instagram_search - Advanced search with 10+ filter types

• instagram_natural_language_search - AI-powered natural language queries

• instagram_get_niches - All available niches with creator counts

YouTube (11 tools)

• youtube_get_profile - Complete profile with pricing estimates, topics, niches

• youtube_get_contact - Contact information

• youtube_get_content_detail - Video details and performance

• youtube_get_performance - Views, engagement, content statistics

• youtube_get_performance_history - Historical performance data

• youtube_get_sponsorship - Sponsored content data

• youtube_get_audience - Audience demographics

• youtube_search - Advanced search with filters

• youtube_natural_language_search - AI-powered search

• youtube_get_topics - Content categories

• youtube_get_niches - Available niches

TikTok (9 tools)

• tiktok_get_profile - Complete profile with follower stats, hashtags, niches

• tiktok_get_contact - Contact information

• tiktok_get_content_detail - Video details

• tiktok_get_performance - Engagement metrics

• tiktok_get_performance_history - Historical data

• tiktok_get_audience - Audience demographics

• tiktok_search - Advanced search with filters

• tiktok_natural_language_search - AI-powered search

• tiktok_get_niches - Available niches

Installation

Configuration

Set your CreatorDB API key as an environment variable:

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

Usage with Claude Code

Development

API Details

• Base URL: https://apiv3.creatordb.app

• Authentication: API key via api-key header

• Response format: JSON with success, data, traceId, timestamp fields

Example Tool Calls

Search Instagram creators with filters

Natural language search

Get Instagram creator profile

Get YouTube creator profile

Get TikTok creator audience demographics

Search YouTube creators by topic

Filter Reference

Common Filter Fields (all platforms)

• displayName - Creator display name (string, supports fuzzy search)

• country - Country code in ISO 3166-1 alpha-3 (e.g., "USA", "GBR", "TWN")

• mainLanguage - Primary language in ISO 639-3 (e.g., "eng", "zht")

• niches - Content niches (array of strings)

• isVerified - Verified account (boolean)

• hasSponsors - Has sponsored content (boolean)

Instagram-specific

• totalFollowers - Follower count (number)

• avgEngagementRate - Average engagement rate (number, 0-1)

YouTube-specific

• totalSubscribers - Subscriber count (number)

• topics - Content topics (array of strings)

TikTok-specific

• totalFollowers - Follower count (number)

Filter Operators

• = - Equals (strings, booleans)

• > - Greater than (numbers)

• < - Less than (numbers)

• in - Value in array (arrays of strings)

Troubleshooting

API Key Issues

• Ensure CREATORDB_API_KEY is set correctly

• Check if the key has sufficient credits

• Header format is api-key: your-key (not Bearer token)

Common Errors

• 429 - Quota exceeded or rate limited

• 400 - Invalid parameters (check filter format)

License

MIT