Influencers Club Creator Marketing MCP

访问全球最大的网红发现与丰富数据库的MCP

文档

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.

Two ways to use it:

Best for
ChatGPT (official app)No install — open the app link and connect with your Influencers Club account
claude.ai (hosted connector)No install — connect once with your Influencers Club account
Local install (stdio)Claude Desktop / Claude Code / IDEs, plus local file tools (CSV export, batch upload)

Use with claude.ai (Hosted Connector)

The hosted server runs at https://mcp-dashboard.influencers.club/mcp and signs you in with OAuth — no API key to copy around.

  1. In Claude, open Settings → Connectors → Add custom connector (or find Influencers Club in the connectors directory).
  2. Enter the URL: https://mcp-dashboard.influencers.club/mcp
  3. Click Connect — you'll be redirected to the Influencers Club dashboard to sign in and approve access.
  4. Done. Ask Claude things like "Find 5 Instagram creators in fitness with 50k-500k followers."

Requirements: an Influencers Club account with API credits. Discovery and enrichment tools consume credits (costs are listed on every tool and in the tables below); dictionary/lookup tools are free.

Notes:

  • The hosted connector exposes the API tools. File and batch tools (CSV export, bulk CSV enrichment) need a local filesystem and are available only in the local install.
  • Connection expired / 401 errors: disconnect and reconnect the connector to re-authenticate.
  • "Insufficient credits" errors: top up in the dashboard; calls keep failing until the balance is positive.

Use with ChatGPT

Influencers Club is an official app in ChatGPT:

  1. Open the app: Influencers Club for ChatGPT
  2. Click Connect — you'll be redirected to the Influencers Club dashboard to sign in and approve access.
  3. Done. The same API tools are available; the credit requirements and notes from the claude.ai section apply unchanged.

Fallback: Developer Mode

If the app isn't available in your workspace, add the hosted server as a custom connector:

  1. In ChatGPT, enable Settings → Apps → Advanced settings → Developer mode (available on Plus, Pro, Business, Enterprise, and Edu plans).
  2. Add a new connector with the URL: https://mcp-dashboard.influencers.club/mcp
  3. Click Connect — you'll be redirected to the Influencers Club dashboard to sign in and approve access.

Local Install (stdio)

Prerequisites

Quick Start (pip)

pip install influencers-club-mcp

Or install from source:

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"

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

API tools are available everywhere (hosted connector and local). Tools marked local only need the local filesystem, so they exist only in stdio installs.

Creator Discovery

ToolDescriptionCost
discover_creatorsAI semantic search with filters (followers, engagement, location, etc.)0.01/creator
discover_creators_to_file (local only)Multi-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 creators1 credit

Exclusion Lists

Team-shared blocklists of creator handles: one default list per platform plus any specific lists you create. A list filters a search only when passed in filters — exclude_list: [ids], exclude_default_list: true or exclude_all_lists: true. List ids are checked before a search; if they are not this platform's, or cannot be checked, the search is not run.

ToolDescriptionCost
list_exclusion_listsList the team's exclusion lists, optionally for one platformfree
create_exclusion_listCreate a specific list for a platformfree
get_exclusion_listGet one specific list by idfree
rename_exclusion_listRename a specific listfree
delete_exclusion_listDelete a specific list and its handlesfree
get_exclusion_list_handlesPage through a specific list's handlesfree
add_to_exclusion_listAdd handles to a specific listfree
remove_from_exclusion_listRemove handles from a specific listfree
get_default_exclusion_listGet a platform's default listfree
get_default_exclusion_list_handlesPage through a platform's default listfree
add_to_default_exclusion_listAdd handles to a platform's default listfree
remove_from_default_exclusion_listRemove handles from a platform's default listfree

Enrichment

ToolDescriptionCost
enrich_by_handleEverything below combined, plus recent posts1 credit
enrich_by_handle_analyticsAudience demographics, engagement, brand affinity; growth and income when the creator has them0.8 credits
enrich_by_handle_profileIdentity and contact: email, name, location, cross-platform links, vetting0.2 credits
enrich_by_handle_rawPlatform basics: bio, followers, verification status, recent post data0.03 credits
enrich_by_emailFind creator profiles from an email0.05 credits
connected_socialsDiscover all linked social accounts for a creator0.5 credits

enrich_by_handle and enrich_by_handle_analytics return every section of the report, compacted so it fits within the assistant's tool-result limit: image and profile links, internal IDs other than post IDs, and map coordinates are left out, lists come as column/row tables, and the longest lists are trimmed (top 30 audience brands, verified accounts only among notable likers and commenters or the 10 largest when none is verified, captions cut to 120 characters, the first 30 other links). The result's notes lists every cut. detail="full" keeps every entry, detail="raw" returns the API response as it came, and a sections list (overview, audience, audience_brands, audience_notable_users, audience_lookalikes, sponsors, sponsored_posts, lookalikes, and posts on the full tier) leaves out the parts a question doesn't need. enrich_by_handle_profile takes detail too: it leaves out image links and cuts other links to the first 30 unless detail="full".

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 (local only)

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 (local only)

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."

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."

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?"

Supported Platforms

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

Environment Variables (local install)

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
LOG_LEVELNoINFOLog verbosity on stderr: DEBUG, INFO, WARNING, ERROR or CRITICAL

Troubleshooting

  • Hosted connector shows "disconnected" or tools return 401 — remove and re-add the connector (or click Reconnect) to refresh the OAuth session.
  • Errors mentioning credits or limits — check your balance with check_credits or in the dashboard; calls fail until the limit resets or credits are added.
  • Local: server doesn't appear in Claude Desktop — verify the config JSON is valid and restart the app; check that influencers-club-mcp runs from a terminal.
  • Local: upload page unreachable — another process may hold port 8090; set UPLOAD_PORT to a free port.
  • Anything else: open an issue or email gjorgji.p@influencers.club.

Privacy Policy

This MCP server is a thin client between the connected AI assistant (e.g. Claude or ChatGPT) and the Influencers Club API. The sections below describe what the server itself does with your data; the Influencers Club platform's full data practices are governed by the Influencers Club Privacy Policy.

Data we collect. None. The server does not collect, persist, or transmit personally identifiable information about the human using the AI assistant. The only inputs it receives are the tool arguments the assistant sends (e.g. a creator handle or a CSV path) and the bearer token used to authenticate against the Influencers Club API.

How data is used. Tool arguments are forwarded directly to the Influencers Club API to fulfill the requested operation (discovery, enrichment, batch processing, etc.). Responses are returned to the assistant. The server performs no analytics, profiling, or model training on this data.

Storage. The server keeps no database. The only data written to disk are: (a) CSV exports/imports the user explicitly creates via the file tools, written to local directories the user controls (exports/, imports/, or paths set by EXPORT_HOST_DIR / IMPORT_HOST_DIR); (b) a small .ic_config.json file storing the chosen export path. No conversation content, API responses, or credentials are persisted.

Third-party sharing. The server communicates with exactly one third party: the Influencers Club API. No data is sent to any other endpoint, analytics service, or telemetry provider. The bearer token is transmitted only to the Influencers Club API over HTTPS and is redacted from any error messages returned to the assistant.

Retention. The server retains nothing in-process beyond the lifetime of a single tool call, with the exception of the user-controlled CSV files described above, which the user can delete at any time. Bearer tokens are read from environment variables (or, in hosted/HTTP mode, from the authenticated request) and are never written to disk.

Contact. Privacy questions and data-deletion requests: gjorgji.p@influencers.club. Security disclosures may also be filed via GitHub Issues.

Support

License

MIT