Skip to main content
Glama
mcp-tiktok-brand-presence-mapper

mcp-tiktok-brand-presence-mapper

TikTok Brand Presence Mapper MCP Server

Glama score MCP Registry npm version npm downloads license

MCP server for the Mamba Labs TikTok Brand Presence Mapper actor on Apify.

Resolve a TikTok handle or a company domain to the brand account with follower, like and video counts.

What it does

Resolve a TikTok handle, or a company domain, to that brand's official TikTok account. Returns follower, following, like and video counts, verification status, display name, bio and the account's outbound bio link, as one flat Clay ready row. Counts above roughly ten thousand are rounded by TikTok and the row flags that. A guessed account that fails the identity check is reported as identity_mismatch with no counts rather than being returned as the company's. Read only; requires an APIFY_TOKEN and consumes Apify credits per call.

Related MCP server: Company Identity Resolver MCP Server

Quick start

Add this to your MCP client configuration:

{
  "mcpServers": {
    "mamba-tiktok-brand-presence-mapper": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-tiktok-brand-presence-mapper"],
      "env": { "APIFY_TOKEN": "your-apify-token" }
    }
  }
}

Prerequisites

The actor is pay per event and consumes Apify credits per call. Pricing is on the actor page.

Example prompts

  • "How many TikTok followers does Gymshark have?"

  • "Find the TikTok account for allbirds.com and tell me if it is verified."

  • "Check whether patagonia.com has a TikTok presence at all."

Tool and inputs

Tool: map_tiktok_brand_presence

Input

Type

Meaning

handle

string

The TikTok handle, with or without the leading @, for example shopify. This is the PRIMARY input: only 4 of 14 B2B homepages declare a TikTok link, so

company_domain

string

Bare company domain, for example shopify.com. Used to FIND the handle when you do not have one, and to identity check a handle that discovery guessed.

company_name

string

Optional. Improves search accuracy and is what the identity gate checks a discovered account against.

includeFollowerCounts

boolean

When "true" (default) the profile page is fetched and the counts are extracted. Set "false" to resolve the profile URL only, which is cheaper and need

skipCache

boolean

When "false" (default) a successful lookup is cached for seven days and reused. Set "true" to force a fresh fetch. Sent as a string for Clay compatibi

escalateOnBlock

boolean

TikTok answers most requests over cheap datacenter routing and blocks a minority with a bot detection page. When "true" (default) a blocked fetch is r

max_charge_usd

number

Optional spending cap for this call, in USD. The actor stops before any charge that would take the run past this amount and keeps every row already charged.

Reading the output

Every row carries a per platform _status field, and it is the field to read first. The vocabulary is the same across the whole Mamba Labs social family:

Status

Meaning

ok

fetched and parsed, the value is there

not_found

we looked and there is no such profile

not_extractable

the profile exists and the value is not on the wire to us

blocked

the platform refused us, worth retrying later

identity_mismatch

we found a real profile and it belongs to someone else

skipped

you did not ask for this platform

false and null are never interchangeable. false means we looked and the answer is no. null means we could not look. If you filter for companies with no presence, filter on false, because null rows are unknown rather than absent.

Pricing

You pay per event on Apify, billed to your own Apify account. Prices from the live pricing record, read 2026-10-16:

Event

Price per event (USD)

Fires when

apify-actor-start

$0.00005

Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event).

company-checked

$0.004 on the Free plan, down to $0.0028 on higher Apify plans

Once per company for which the discovery cascade completed and a non degraded row was produced, whether or not a TikTok profile was found. Does not fire on a degraded row, because on a degraded row no discovery was performed.

profile-resolved

$0.003 on the Free plan, down to $0.0021 on higher Apify plans

Once per company whose candidate TikTok URL passed the identity gate. Fires on the validation work, not on a populated count. A candidate dropped as an impersonator does not charge: the work was done and the honest answer is that there is no such profile.

follower-count-extracted

$0.0025 on the Free plan, down to $0.00175 on higher Apify plans

Once per company where a numeric follower count was read off the public page. Does not fire on not_extractable, blocked, identity_mismatch or url only runs.

The actor's Apify page carries the current prices. Running this server consumes Apify credits.

Full actor documentation

apify.com/mambalabs/tiktok-brand-presence-mapper

Mamba Labs GTM Suite

Mamba Labs builds a fleet of GTM enrichment actors that share one flat, Clay ready output convention, so their rows join on company_domain with no cleaning step. Full fleet: apify.com/mambalabs

License

MIT

Available Tools

1 tool
map_tiktok_brand_presenceMap TikTok Brand PresenceA
Idempotent

Resolve a TikTok handle, or a company domain, to that brand's official TikTok account. Returns follower, following, like and video counts, verification status, display name, bio and the account's outbound bio link, as one flat Clay ready row. Counts above roughly ten thousand are rounded by TikTok and the row flags that. A guessed account that fails the identity check is reported as identity_mismatch with no counts rather than being returned as the company's, and a brand with no TikTok account reports tiktok_status not_found. Read tiktok_status before any count. Use it to look up one known brand per call; it does not search TikTok, list or read videos, or compare accounts, so pair it with the sibling presence mappers for other platforms. Read only; requires an APIFY_TOKEN and consumes Apify credits per call.

Inputs: handle, skipCache, company_name, company_domain, +3 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of misselection or overlap with sibling tools on this server. Its scope (resolve one known brand handle/domain to a TikTok account) is stated explicitly, including what it does not do.

    Naming Consistency5/5

    The single tool follows a clear verb_noun snake_case pattern (map_tiktok_brand_presence) and is namespaced by platform, which would remain predictable if sibling presence mappers were added.

    Tool Count3/5

    One tool is on the thin side for a server, though it is a focused, well-specified single-purpose utility rather than a trivial stub. It does one job (one brand lookup per call) and the description openly defers multi-brand, search and video operations to sibling mappers.

    Completeness4/5

    Within its declared scope the surface is complete: it returns identity status (tiktok_status, identity_mismatch) plus counts, bio and link, with clear failure semantics. Gaps are deliberate and documented (no batch lookups, no other platforms, no video data), so agents know to pair it with sibling servers.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Checks username availability and retrieves account information across major social media platforms including YouTube, TikTok, Threads, X (Twitter), and Instagram, perfect for brand name qualification and competitive research.
      10
      6
      8 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Resolves any combination of company name, domain, or LinkedIn URL into the canonical company identity (name, domain, LinkedIn URL) with confidence scores and match method.
      1
      145 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables resolving a company domain to its Instagram, Threads, and Facebook accounts with follower and post counts.
      1
      324 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Resolves company domains to their LinkedIn pages, providing exact follower counts and public firmographics such as industry, company size band, headquarters, founded year, and specialties.
      1
      319 npm
      MIT