Influencers Club Creator Marketing MCP

MCP to access the world's largest influencer discovery and enrichment database

GitHub

Influencers Club MCP Server

Beta — This project is under active development. It works and can be tested, but expect changes before the stable release.

MCP server for the Influencers Club API — creator enrichment, discovery, audience analysis, content data, batch operations, and account management.

Prerequisites

Quick Start (pip)

git clone https://github.com/Influencers-Club/influencers-club-mcp.git
cd influencers-club-mcp
pip install -e .

Then add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "influencers-club": {
      "command": "influencers-club-mcp",
      "env": {
        "INFLUENCERS_CLUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop — the server will appear as "influencers-club". That's it.

Where do files go? By default, exported CSVs and uploads are saved to exports/ and imports/ inside the cloned repo folder. No extra configuration needed.

To use a custom location, add these env vars:

"EXPORT_HOST_DIR": "/your/custom/exports",
"IMPORT_HOST_DIR": "/your/custom/imports",
"OUTPUT_DIR": "/your/custom/exports",
"IMPORTS_DIR": "/your/custom/imports"

Other Clients

Claude Code

Add to your project's .mcp.json or global ~/.claude/settings.json:

{
  "mcpServers": {
    "influencers-club": {
      "command": "influencers-club-mcp",
      "env": {
        "INFLUENCERS_CLUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code / Cursor

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "influencers-club": {
      "command": "influencers-club-mcp",
      "env": {
        "INFLUENCERS_CLUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

Docker (Advanced)

Use Docker if you want filesystem isolation or prefer containerized deployments.

git clone https://github.com/Influencers-Club/influencers-club-mcp.git
cd influencers-club-mcp
docker build -t influencers-club-mcp .

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "influencers-club": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-p", "127.0.0.1:8090:8090",
        "-e", "INFLUENCERS_CLUB_API_KEY=your_api_key_here",
        "-e", "UPLOAD_PORT=8090",
        "-e", "UPLOAD_BIND=0.0.0.0",
        "-v", "/path/to/exports:/exports",
        "-v", "/path/to/imports:/imports",
        "-e", "EXPORT_HOST_DIR=/path/to/exports",
        "-e", "IMPORT_HOST_DIR=/path/to/imports",
        "influencers-club-mcp"
      ]
    }
  }
}

Note: Replace /path/to/exports and /path/to/imports with actual paths on your machine. The path appears 4 times — update all of them.

Examples by OS:

  • macOS/Linux: /Users/john/influencers-club-mcp/exports
  • Windows: C:\\Users\\John\\Desktop\\influencers-club-mcp\\exports (use double backslashes)

After configuring, restart your client. The server will appear as "influencers-club".

Available Tools (29)

Creator Discovery

ToolDescriptionCost
discover_creatorsAI semantic search with filters (followers, engagement, location, etc.)0.01/creator
discover_creators_to_fileMulti-page discovery with CSV export to disk0.01/creator
find_similar_creatorsFind creators similar to a seed creator0.01/creator
audience_overlapCompare audience overlap between 2-10 creators (auto-visualized)1 credit

Enrichment

ToolDescriptionCost
enrich_by_handleFull enriched profile: email, demographics, audience, income, brand deals1 credit
enrich_by_handle_rawBasic profile data: bio, followers, verification status0.03 credits
enrich_by_emailFind creator profiles from an email0.05 credits
connected_socialsDiscover all linked social accounts for a creator0.5 credits

Content Data

ToolDescriptionCost
get_creator_postsFetch recent posts with engagement metrics (IG, TikTok, YouTube)0.15 credits
get_post_detailsDeep content analysis (comments, transcript, audio)0.03 credits

Batch Enrichment

ToolDescriptionCost
create_batch_enrichmentUpload CSV of up to 10,000 handles/emails for bulk processingvaries
get_batch_statusCheck batch job progress (auto-polls every 35s)free
download_batch_resultsDownload completed batch results as CSVfree
resume_batchResume a paused batch after adding creditsfree

File Management

ToolDescriptionCost
get_upload_urlGet the browser upload page URL for batch CSV filesfree
wait_for_uploadAuto-detect when a file has been uploadedfree
list_import_filesList uploaded CSV files ready for enrichmentfree
list_export_filesList exported result filesfree
setup_export_pathConfigure where exported files are savedfree

Discovery Reference Data

ToolDescriptionCost
get_languagesAvailable languages for filteringfree
get_locationsAvailable locations per platformfree
get_brandsAvailable brand identifiersfree
get_youtube_topicsAvailable YouTube topicsfree
get_gamesAvailable Twitch gamesfree
get_audience_brand_categoriesAudience brand categoriesfree
get_audience_brand_namesAudience brand namesfree
get_audience_interestsAudience interest categoriesfree
get_audience_locationsAudience geographic locationsfree

Account

ToolDescriptionCost
check_creditsCheck account credits balancefree

Usage Examples

Find fitness influencers on Instagram:

"Find 5 Instagram creators with 50k-500k followers who post about fitness and have an engagement rate above 3%."

Enrich a creator profile by handle:

"Get me the full profile for @cristiano on Instagram, including audience demographics."

Batch enrich a CSV of emails:

"I have a CSV of 3,000 emails to batch enrich." — Claude will open the upload page for you.

Find similar creators for campaign scaling:

"I like the creator @MrBeast on YouTube. Find 10 similar creators with at least 100k followers."

Compare audience overlap:

"Compare the audience overlap between @nike, @adidas, and @puma on Instagram." — Claude will generate a Venn diagram.

Get a creator's recent posts:

"Show me the latest posts from @garyvee on TikTok with engagement metrics."

Find all connected social accounts:

"What other social media accounts does @cristiano have linked to their Instagram?"

Check your remaining API credits:

"How many credits do I have left?"

Batch Enrichment Modes

ModeInputCostRequires Platform
basicemails0.05/recordNo
rawhandles0.03/recordYes
fullhandles1/recordYes

For large files (100+ entries), Claude opens a browser upload page at http://localhost:8090. Drag-and-drop your CSV — Claude auto-detects the upload and starts processing. For smaller batches (under 100), Claude enriches them in parallel automatically.

The upload page accepts multi-column CSVs and automatically extracts the correct column.

Supported Platforms

CapabilityPlatforms
EnrichmentInstagram, TikTok, YouTube, OnlyFans, X/Twitter, Twitch, LinkedIn (raw mode only)
DiscoveryInstagram, TikTok, YouTube, OnlyFans, X/Twitter, Twitch
Content DataInstagram, TikTok, YouTube
Audience OverlapInstagram, TikTok, YouTube

Environment Variables

VariableRequiredDefaultDescription
INFLUENCERS_CLUB_API_KEYYes—Your Influencers Club API key
UPLOAD_PORTNo8090Port for the browser upload page
UPLOAD_BINDNo127.0.0.1Bind address. Set to 0.0.0.0 inside Docker.
UPLOAD_HOSTNolocalhostHostname for the upload URL. Set to your IP if Docker runs remotely.
EXPORT_HOST_DIRNo—Host path for exported files
IMPORT_HOST_DIRNo—Host path for uploaded files
MAX_CALLS_PER_MINUTENo300Client-side rate limit

Privacy Policy

This MCP server acts as a pass-through to the Influencers Club API. It does not collect, store, or log any user data, conversation data, or API responses. All data flows directly between Claude and the Influencers Club API using your personal API key. For the Influencers Club data and privacy practices, refer to the Influencers Club Privacy Policy.

Support

License

MIT

Servidores relacionados

NotebookLM Web Importer

Importa páginas web y videos de YouTube a NotebookLM con un clic. Utilizado por más de 200,000 usuarios.

Instalar extensión de Chrome