CreatorDB

You can access CreatorDB’s MCP server to query the CreatorDB Headless API V3, giving you programmatic access to influencer data across Instagram, YouTube, and TikTok through a consistent set of endpoints. This guide shows you how to install, configure, and run the MCP server so you can integrate CreatorDB data into your workflows and tools.

How to use

You will run the MCP server locally and connect to it with your MCP client. The server exposes a comprehensive set of tools that map to CreatorDB API V3 endpoints, including general usage statistics, Instagram, YouTube, and TikTok data retrieval, plus advanced search and natural language query capabilities. Use the client to request data by tool name and supply the required arguments described for each tool. The server responds with JSON containing success status, data, trace identifiers, and timestamps.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You will clone or copy the project, install dependencies, and build the TypeScript sources before running the server.

# Clone or copy this directory
cd creatordb-mcp

# Install dependencies
npm install

# Build the TypeScript
npm run build

Configuration

Set your CreatorDB API key as an environment variable to authorize requests from the MCP server.

export CREATORDB_API_KEY="your-api-key-here"

Usage with Claude Desktop

Configure Claude Desktop to load the MCP server by pointing to the built runtime and providing your API key through the environment. Ensure the path to the built index file is correct for your system.

{
  "mcpServers": {
    "creatordb": {
      "command": "node",
      "args": ["/path/to/creatordb-mcp/dist/index.js"],
      "env": {
        "CREATORDB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage with Claude Code

Add the MCP server using the CLI integration, then run the server with the same node-based invocation used in Claude Desktop.

# Add the MCP server
claude mcp add creatordb -- node /path/to/creatordb-mcp/dist/index.js

# Or with environment variable
CREATORDB_API_KEY=your-key claude mcp add creatordb -- node /path/to/creatordb-mcp/dist/index.js

Development

Developers can run in development mode, build for production, and start the server from the built output.

# Run in development mode (without building)
npm run dev

# Build for production
npm run build

# Run built version
npm start

API details

Base URL: https://apiv3.creatordb.app. Authentication is provided via the API key in the api-key header. Responses are JSON and include success, data, traceId, and timestamp fields.

Example tool calls

You can invoke any of the available tools by name and pass the required arguments as shown in the tool’s description. Examples below illustrate typical usage patterns and argument structures.

Troubleshooting

Common issues include missing or invalid API keys, quota or rate limits, and parameter errors. Ensure your CREATORDB_API_KEY is set correctly and has sufficient credits. If you receive a 429 or 400 error, verify your request parameters and quotas.

Available tools

get_api_usage

Fetch API usage statistics and quota consumption for monitoring and cost control.

instagram_get_profile

Retrieve the complete Instagram profile with metadata, statistics, hashtags, and niches.

instagram_get_contact

Obtain Instagram contact information such as emails.

instagram_get_content_detail

Get detailed information about specific Instagram content.

instagram_get_performance

Retrieve engagement metrics like likes, comments, and consistency scores.

instagram_get_performance_history

Access historical performance data for profiles or content.

instagram_get_sponsorship

Get information about sponsored posts.

instagram_get_audience

Obtain audience demographics including country, gender, and age breakdown.

instagram_search

Perform an advanced search with multiple filters.

instagram_natural_language_search

Execute AI-powered natural language queries for Instagram data.

instagram_get_niches

List all available niches with creator counts.

youtube_get_profile

Retrieve complete YouTube channel profile with pricing estimates, topics, and niches.

youtube_get_contact

Get YouTube contact information.

youtube_get_content_detail

Fetch YouTube video details and performance data.

youtube_get_performance

Access views, engagement, and content statistics.

youtube_get_performance_history

Historical performance data for YouTube channels or videos.

youtube_get_sponsorship

Information about sponsored content on YouTube.

youtube_get_audience

Audience demographics for YouTube channels.

youtube_search

Advanced search with filters to find YouTube creators or videos.

youtube_natural_language_search

AI-powered search for YouTube content.

youtube_get_topics

List content categories and topics.

youtube_get_niches

Available YouTube niches.

tiktok_get_profile

Obtain complete TikTok profile with follower stats, hashtags, and niches.

tiktok_get_contact

Get TikTok contact information.

tiktok_get_content_detail

Retrieve TikTok video details.

tiktok_get_performance

Engagement metrics for TikTok content.

tiktok_get_performance_history

Historical performance data for TikTok creators.

tiktok_get_audience

TikTok audience demographics.

tiktok_search

Advanced TikTok search with filters.

tiktok_natural_language_search

AI-powered TikTok search.

tiktok_get_niches

Available TikTok niches.