Skip to main content
Glama
mambalabsdev

Influencer Finder MCP Server

Influencer Finder MCP Server

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

MCP server for the Mamba Labs Influencer Finder actor on Apify.

Keywords or a curated niche in, influencer handles out, one flat row per creator per platform.

Install

npx -y @mambalabsdev/mcp-creator-finder

Claude Desktop

{
  "mcpServers": {
    "mamba-creator-finder": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-creator-finder"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

Get an Apify token at console.apify.com/account/integrations.

Related MCP server: Influship MCP

Tool

find_influencers

Find influencers by keyword or niche across seven creator platforms, with follower counts.

Input

Type

Required

Notes

keywords

array

no

Search phrases, one per line, for example "budget travel" or "meal prep coach". Each keyword is searched on each platform. Use niche instead to load a curated keyword set.

niche

string

no

Loads a curated set of search keywords for the niche (about 60 per niche, measured in the September 2026 pre-research). max_keywords_per_niche caps how many are used. Leave as custom to search only your keywords. Default "custom".

max_keywords_per_niche

integer

no

How many keywords from the niche set to search. 1 to 60. Default 10.

platforms

array

no

Which platforms to search, and which platforms a bare @handle is looked up on. A full profile URL carries its own platform and ignores this. Supported: TikTok, Instagram, YouTube, Pinterest, Twitch, Threads, and podcasts.

max_creators_per_keyword

integer

no

Cap per search. Search engines honor the site: filter for the first page or two only, so 20 to 30 per keyword with more keywords beats deep paging. Default 20.

max_creators

integer

no

Hard cap on rows returned, so a broad niche cannot run away. Default 200.

follower_min

integer

no

Drop creators whose follower count is known and below this. A creator whose count the search did not show is kept, so a later profile read can fill it. Default 5000.

follower_max

integer

no

Drop creators whose follower count is known and above this. Default 500000.

us_only

boolean

no

Launch scope is US creators. Discovery carries no country signal, so country_guess is null on every row of this actor and this field changes nothing here. It is accepted so the same input runs unchanged on the Influencer Lead List Builder. Default true.

batch_size

integer

no

Rows fetched at once. Leave empty for the measured per platform default; the measurement is in the README. Higher is faster and, above the measured point, loses rows.

keyword_time_budget_secs

integer

no

Wall time allowed for each keyword on each platform, in seconds. A hung search page is given up at the budget, so a full niche set finishes as a SUCCEEDED run. 10 to 600. Default 60.

country

string

no

Runs the search engine queries from this country so results lean to creators there: any, US, GB, CA, AU, IE, NZ, DE, FR, NL, or SE. any rotates the exit country. Default "any".

contribute_to_shared_pool

boolean

no

On by default. Contributes the public records this run finds to a shared creator and agency pool that all users of this actor read from. Only public data already in the returned rows is sent, and a contribution is not charged. Set false to read the pool and write nothing. Default true.

max_charge_usd

number

no

Optional cost cap in USD for this run. The actor stops before an item that could take its charges past this amount. Omit to rely on the maximum cost per run set in Apify.

Nothing is required. Influencer Finder answers a run with no usable input with a row carrying row_status and error_reason rather than failing, and the tool mirrors that.

Pricing

Influencer Finder is pay per event on Apify. Every price below is flat across every tier: FREE, BRONZE, SILVER, GOLD, PLATINUM, and DIAMOND.

Event

Charged for

Price

Fires when

actor-start

Actor start

$0.001

Once per run, on start. Covers the run overhead.

apify-actor-start

Apify actor start

not charged

Apify's synthetic start event. This actor prices its own actor-start event instead, so apify-actor-start is not charged on top of it.

creator-found

Creator found

$0.007

Once per creator row returned by keyword or niche discovery with a handle and a profile URL. A search that returns nothing charges nothing.

Reading the output

Every row carries row_status and error_reason. A creator the actor could not read comes back as a row saying why, not as a gap in the list, so an absence is readable rather than inferred. Filter on row_status before loading a table.

What this actor shares

The run contributes the records it finds to a shared creator and agency pool that all users of this actor read from. What one run finds, the next run can read.

The toggle is contribute_to_shared_pool. It is on by default. Set it to false and the run still reads the pool and writes nothing to it.

What this actor contributes. The creator ID, platform, and handle of every creator it finds. No profile detail, because this actor reads none.

Only public data that is already in your own output. Every field written to the pool is a field this run returned to you, read from a page the platform or the creator publishes to anyone without a login. Nothing from your Apify account, your input list, your API keys, or your own notes is sent. A contribution never deletes anything from the pool.

What a contribution is labeled with. The actor ID, the run ID, the pool key issued to the actor build, and a hash of the calling IP address, used for the rate limit and nothing else. Your Apify account and your user ID are not recorded.

Contributing is free. No event is charged for a write to the pool. If the pool is unreachable the run finishes as normal, the rows are dropped, and the run log says so.

Actor

Actor ID tpkedmloIIWtXx6sg. The wrapper calls the actor by that immutable ID rather than by its Store slug, so a Store rename never breaks it.

Suite

Built by Mamba Labs.

Available Tools

1 tool
find_influencersFind Influencers by Keyword or NicheA
Read-onlyIdempotent

Searches TikTok, Instagram, YouTube, Pinterest, Twitch, Threads, and podcasts for creators matching your keywords or one of eight curated niche keyword sets, then filters them to a follower range. Returns one flat row per creator per platform with handle, profile URL, display name, follower count, the search that found them, a stable creator_id, and similar creators from the same keyword cluster. Discovery only: it does not read bios, emails, or link in bio pages, which is what Influencer Profile Scraper and Link in Bio Scraper and Newsletter Detector do. Every row carries row_status and error_reason, so an absence is readable rather than silent. Charges $0.001 per run plus $0.007 per creator returned; a search that returns nothing charges the run start only. Contributes the public records in its rows to a shared creator pool, free and on by default; contribute_to_shared_pool explains it and turns it off. A run that does not succeed is returned as an error with its run ID and status. Requires an APIFY_TOKEN and consumes Apify credits. Read only.

NameRequiredDescriptionDefault
nicheNoLoads a curated set of search keywords for the niche (about 60 per niche, measured in the September 2026 pre-research). `max_keywords_per_niche` caps how many are used. Leave as custom to search only your keywords. Default: "custom".
countryNoRuns every search engine query from this country with the matching Google country setting, so results lean to creators there. any rotates the exit country. Default: "any".
us_onlyNoLaunch scope is US creators. Discovery carries no country signal, so country_guess is null on every row of this actor and this field changes nothing here. It is accepted so the same input runs unchanged on the Influencer Lead List Builder, where it acts at the profile stage. Default: true.
keywordsNoSearch phrases, one per line, for example "budget travel" or "meal prep coach". Each keyword is searched on each platform. Use `niche` instead to load a curated keyword set.
platformsNoWhich platforms to search, and which platforms a bare @handle is looked up on. A full profile URL carries its own platform and ignores this. Supported: TikTok, Instagram, YouTube, Pinterest, Twitch, Threads, and podcasts. Not X, not Facebook pages, not LinkedIn.
batch_sizeNoRows fetched at once. Leave empty for the measured per platform default; the measurement is in the README. Higher is faster and, above the measured point, loses rows.
follower_maxNoDrop creators whose follower count is known and above this. Default: 500000.
follower_minNoDrop creators whose follower count is known and below this. A creator whose count the search did not show is kept, so a later profile read can fill it. Default: 5000.
max_creatorsNoHard cap on rows returned, so a broad niche cannot run away. Default: 200.
max_keywords_per_nicheNoHow many keywords from the niche set to search. 1 to 60. Default: 10.
keyword_time_budget_secsNoWall time allowed for each keyword on each platform, in seconds. A search page that hangs is given up at the budget, and the run starts no new keyword when its own timeout is closer than one budget, so a full niche set finishes as a SUCCEEDED run instead of timing out. 10 to 600. Default: 60.
max_creators_per_keywordNoCap per search. Search engines honor the site: filter for the first page or two only, so 20 to 30 per keyword with more keywords beats deep paging. Default: 20.
contribute_to_shared_poolNoOn by default. Contributes the public records this run finds to a shared creator and agency pool that all users of this actor read from, so a later run reads what this one found. Only public data already in the returned rows is sent, never your Apify account, your input list, or your API keys, and a contribution is not charged. Set false to read the pool and write nothing. Default: true.

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/openWorld/non-destructive, and the description adds material behavior the annotations cannot: exact pricing model ($0.001 per run + $0.007 per creator, run-start-only charge on empty results), the shared creator pool contribution that is on by default, APIFY_TOKEN and credit requirements, row_status/error_reason on every row, and error-with-run-ID on failure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the searched platforms, the matching logic, and the returned columns before moving to scope exclusions, pricing, and pool behavior. Dense but nearly every sentence carries actionable detail; it is slightly overstuffed for a description, keeping it out of the top tier.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, the description still enumerates the returned fields, explains row_status/error_reason, and covers billing, auth, and failure behavior for a 13-parameter tool. An agent has everything it needs to invoke this correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3 and the schema already carries the per-parameter detail. The description reinforces the follower-range filtering and niche-set behavior, but adds little syntax or format guidance beyond the schema (its us_only note is one exception). No credit above baseline is warranted.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (searches TikTok/Instagram/YouTube/Pinterest/Twitch/Threads/podcasts for creators matching keywords or a curated niche set), then narrows by follower range. It also names exactly what it returns per row (handle, URL, display name, followers, source search, creator_id, similar creators). An agent can distinguish this discovery tool from any profile-reading tool without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly frames the tool as 'Discovery only' and names the alternatives (Influencer Profile Scraper, Link in Bio Scraper, Newsletter Detector) for bio/email/link-in-bio needs. It also describes when a search yields nothing and how that is surfaced, so the agent knows both the right and wrong uses.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.1.1
    • Changedfind_influencers3 fields changed
      • addedInput schema / properties / contribute_to_shared_pool
        Added value: +{
        +  "description": "On by default. Contributes the public records this run finds to a shared creator and agency pool that all users of this actor read from, so a later run reads what this one found. Only public data already in the returned rows is sent, never your Apify account, your input list, or your API keys, and a contribution is not charged. Set false to read the pool and write nothing. Default: true.",
        +  "type": "boolean"
        +}
      • addedInput schema / properties / country
        Added value: +{
        +  "description": "Runs every search engine query from this country with the matching Google country setting, so results lean to creators there. any rotates the exit country. Default: \"any\".",
        +  "enum": [
        +    "any",
        +    "US",
        +    "GB",
        +    "CA",
        +    "AU",
        +    "IE",
        +    "NZ",
        +    "DE",
        +    "FR",
        +    "NL",
        +    "SE"
        +  ],
        +  "type": "string"
        +}
      • addedInput schema / properties / keyword_time_budget_secs
        Added value: +{
        +  "description": "Wall time allowed for each keyword on each platform, in seconds. A search page that hangs is given up at the budget, and the run starts no new keyword when its own timeout is closer than one budget, so a full niche set finishes as a SUCCEEDED run instead of timing out. 10 to 600. Default: 60.",
        +  "maximum": 600,
        +  "minimum": 10,
        +  "type": "integer"
        +}
  2. 1 tool updatev1.0.0
    • First observedfind_influencers

TDQS

A4.4/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool exposed, there is no possibility of selecting the wrong tool or confusing overlapping purposes. The description's references to sibling servers (Profile Scraper, Link in Bio Scraper) are out of scope for this set and do not create internal ambiguity.

Naming Consistency5/5

The single tool uses a clean verb_noun snake_case pattern (find_influencers) that directly reflects its action and resource. There are no competing conventions to clash with.

Tool Count3/5

One tool for a whole server is thin even for a narrowly scoped discovery service; a user has no way to list niches, retrieve a run's results by ID, or look up a creator by the creator_id the tool returns. The single tool is rich, but the surface is borderline minimal.

Completeness3/5

The discovery step is well covered across many platforms and the tool honestly declares its boundary (no bios, emails, or link-in-bio), which are handled by separate servers. However, within this server there is no follow-up operation: no pagination, no fetch-by-run-id, no lookup by the advertised stable creator_id, and no way to act on the shared pool it contributes to.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides comprehensive influencer marketing data from Instagram, YouTube, and TikTok via the CreatorDB Headless API V3. It enables advanced creator search, profile analysis, and access to performance metrics and audience demographics.
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Enables AI-native creator discovery for influencer marketing, including creator search, lookalikes, profile lookup, and Instagram post transcript analysis.
    14
    26 npm
    1
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables social media creators to pull TikTok, Instagram, Facebook, and YouTube analytics into a persistent vault, receive weekly digests, review scripts, build media kits, and draft brand outreach using official APIs only.
    MIT