https://mcp.creatorland.com/mcpTools reference
Your agent composes campaign work from two kinds of tools: read tools that turn the corpus into shortlists, profiles, and rate benchmarks, and outreach tools that take a shortlist live, reach a creator on your behalf, and broker the introduction. Every call is metered in credits, weighted by how heavy the tool is. You are only charged for calls that return data; refused, empty, and failed calls cost nothing, and status reads are always free. See the credits page for the full price index.
Read tools
Four tools read the Creatorland creator and brand-deal corpus, all available on the free tier. A fuller per-tool reference, with every field and a worked example, rolls out over time.
search_creators2 creditsRanked creator discovery. Describe the campaign in a brief, or seed it with a creator or a piece of content you already like, and get back a ranked, ready-to-pitch shortlist.
Two modes. In brief mode, pass a free-text brief and/or structured filters: platform, niche, country, city, follower range, interests, hashtags, brand affinities, verification, and minimum engagement rate, with a result limit (1 to 150) and a precision setting. In lookalike mode, pass a single seed creator or a seed post and get creators with the same profile.
A ranked list of creators, each with the signals behind the match (niche, audience geo, brand affinities, and how fresh the underlying data is) so your agent can explain every pick. On paid plans, each row can also carry an avatar, a stable signed image URL ready to render in a creator card.
get_creator_profile1 creditThe full profile for one creator: who their audience is, what they make, the brands they have worked with, and how current the data is.
One identifier for the creator: a social handle, a Creatorland user id, a source-platform user, an email, or a phone number.
The creator profile, including interests, hashtags, audience geography, and a data-freshness signal so you know how recently it was verified. On Pro, brand affiliations are included too, and the profile can carry an avatar, a stable signed image URL ready to render in a creator card.
query_market_intelligence5 creditsProMarket-level rate and deal benchmarks, built from real brand and creator deals, so your team can price a campaign and walk into the negotiation with a number it can defend.
A market or rate question, narrowed by vertical, sub-category, company type, deal type, and a recency window. In rate mode you can pass a quoted fee to see where it sits in the range.
An aggregate benchmark returned as a range, with the provenance line and recency window behind every number, so a figure you paste into a client deck is defensible by construction. Benchmarks are market-level for a vertical and tier, ready to cite.
get_member_content_stats1 creditA consented Creatorland member's first-party content stats, straight from their own connected accounts, for the campaigns where you are working with the creator directly.
The member you are working with, by their Creatorland identifier.
Account-level content performance the member has chosen to share, sourced first-party rather than estimated.
Audience intelligence
Two tools add a verified audience layer on top of a profile, so you can vet who a creator actually reaches before you sign. The report is a premium Pro read; a free coverage check sizes the spend first. Audience figures are vendor-derived rather than Creatorland first-party, and contact details are never included.
get_audience_report25 creditsProA verified audience report for one creator, built from a third-party audience-intelligence provider: who the audience really is, how real it is, and which brands it already leans toward — the diligence layer on top of a profile.
One creator by handle or identifier, and the platform. An optional force-refresh pulls a fresh report instead of serving the cache.
Real audience demographics, geography, interests, and audience brand-affinity, plus a credibility / fake-follower score and a credibility-adjusted true-fit read, with an "as of" freshness stamp. Instagram returns the full picture; TikTok and YouTube return demographics and geo only, and the report says so rather than fabricating the rest. Cache-first: a creator pulled in the last ~30 days re-serves at no vendor cost. Audience figures are vendor-derived, not Creatorland first-party; contact details are never included.
check_audience_coverageFreeA free preflight before any paid pull: for one creator or a list, it tells you who already has a cached audience report versus who needs a fresh pull, with the credit estimate, so the cost is on the table before you spend.
One creator, or a list of creators, by handle or identifier and platform.
Per-creator coverage (cached versus needs-a-fresh-pull) and the total credit estimate for the fresh pulls, so an agent can confirm the spend with a human first.
Avatars
On paid plans, search_creators rows, lookalike rows, and get_creator_profile can return a nested avatar object: a profile image for the creator, so your agent can render a real creator card instead of a blank tile. It is part of the avatar entitlement and is rolling out on Pro and pilot plans.
avatar: {
"url": "https://data-mcp.creatorland.com/img/...", // short-lived signed proxy URL
"source": "social_account" // discovery | social_account | creatorland_profile
} | nullurlis a stable signed image URL. It is safe to drop straight into an<img>tag, with no extra signing or proxying on your side.sourceis one ofdiscovery,social_account, orcreatorland_profile, recording where the image came from.- The whole object is
nullwhen no avatar is available. On free-tier plans, on results without the entitlement, and wherever an image is missing, you getnullrather than a broken URL, so always handle the null case. Avatars are a profile image only; contact details are never exposed.
For a copy-pasteable component that renders a creator card from a search row, with a branded placeholder for the null case, see the build a creator card recipe.
Outreach tools
Three tools turn a shortlist into a real conversation. They are Pro-only (the creator_connections entitlement); on a plan without it the tool still answers, with a successful note on how to upgrade rather than an error. For the flow and the privacy model behind these, read how outreach works.
request_creator_connection10 creditsProAsks Creatorland’s matchmaker to reach one creator on your behalf. It sends a three-touch email sequence from matchmaker@creatorland.com(Day 0, 3, and 7, auto-halting the moment the creator replies), fires a default-on in-platform connection request, and, on a yes, opens a double-opt-in joint intro. The creator’s contact details are never returned to you and never appear in any response; the introduction is the only path to them, and only after they agree.
The 10 credits are charged once per creator reached. They cover the whole sequence, the reply monitoring, and the intro brokering. You are never charged per email.
request_creator_connection {
"creator_ref": "<opaque ref from search/profile, or an identifier>",
"opportunity": {
"campaign_type": "<required>",
"comp_tags": ["<e.g. paid, gifting, affiliate>"],
"budget_band": "<optional, a market-credible range>",
"timeline": "<optional>",
"deliverables": "<optional>",
"brief_context": "<optional>",
"personal_message": "<optional, your own words>"
},
"options": { "send_connection_request": true }
}{
"conn_ref": "<ref>",
"status": "in_progress",
"typical_response_window": "2 to 5 days"
}Some requests come back as a successful note rather than a send, by design, so the loop stays safe and your credits stay yours:
- Not entitled: a free-tier plan gets upgrade guidance, not an error.
- Quality scan: a payload carrying contact info, a non-Creatorland link, or a "DM me" hand-off is declined; the matchmaker is the channel.
- Duplicate: an open request already exists for this brand and creator, so you get the existing reference back and no new charge.
- Cooldown: the same brand and creator inside 45 days, without a materially different opportunity, is held back.
get_connection_statusFreePass one connection reference and get the status of that outreach, the typical response window, and, only after a yes, the connected channel. Polling never costs a credit.
list_connectionsFreeLists your brand’s outreaches, newest first, each with its reference and status. Also free.
Both status reads return a simple status, one of in_progress, interested, connected, or closed, so you always know where an outreach stands. A connection’s existence and status are yours to see; the creator’s identity stays private until they choose to share it.
Bulk match and enrich
Two tools let you bring your own list: match the contacts you already have — emails, phone numbers, or social handles — against the corpus for free to see how many are creators and what enriching them would cost, then enrich the matches. The two steps are deliberately split so a human-confirmed cost always sits between the free count and any charge. A clean match means how many of your contacts we recognize in our corpus, never a guarantee, and no creator contact details are returned by either tool.
match_creatorsFreePhase one, and always free. Pass a list of identifiers you already hold, mixed emails, phone numbers, and social handles, with a minimum of 25 per call. You get back counts only: how many you submitted, how many matched the corpus, how many did not, and how many were duplicates, plus an estimated_credits for enriching the matches, your account balance, and a short-lived preview_token. There is no per-identifier map and no profile data at this step, so you can size the spend before committing to it.
match_creators {
"identifiers": [
"ava@example.com",
"+15551234567",
"instagram:@some_handle"
] // min 25 per call, mixed emails / phones / social handles
}{
"counts": {
"submitted": 1200,
"matched": 318,
"unmatched": 858,
"duplicates": 24
},
"estimated_credits": 954, // 318 matched x 3 credits
"account_balance": 2000,
"preview_token": "<short-lived>" // pass to enrich_matches to confirm
}enrich_matches3 creditsProPhase two, and the only paid step. It enriches your matched contacts at 3 credits per match and is available on the Pro and pilot plans; on a plan without it the tool answers with an upgrade message rather than an error. It requires the credit amount a human has confirmed, the cost-confirmation gate, so a charge can never happen on the agent’s own initiative. If your balance cannot cover every match, it does what you can afford, funding the matches it can in order and reporting how many remain unfunded, rather than failing the whole call.
Each enriched match returns the full profile surface: profile, deal signals, brand affiliations, avatar, and content stats. Large result sets come back as a downloadable file over a short-lived signed URL, CSV, JSON, or JSONL, rather than thousands of inline rows; request the format you want.
enrich_matches {
"preview_token": "<from match_creators>",
"confirmed_credits": 954, // the human-confirmed amount; the cost gate
"format": "csv" // optional: csv | json | jsonl for large sets
}{
"enriched": 318,
"credits_charged": 954,
"remaining_unfunded": 0, // matches left if the balance ran short
"download_url": "https://data-mcp.creatorland.com/exports/...", // large sets
"results": [ /* per-match profile, deal signals, brand affiliations, avatar, content stats */ ]
}Call match_creators first to get the count and the estimated_credits. Show that number to the person, get a yes, and only then call enrich_matches with the confirmed amount and the preview token. Skipping the confirmation is what turns a quote into a surprise charge, so the contract is built to make the confirm step explicit.
Prompts
Beyond tools, the server exposes MCP Prompts, the clickable starter prompts that show up in clients like Claude. Each one loads a Creatorland-shaped workflow that walks your agent through the right tools in the right order, so you start from a named template instead of a blank box. Prompts themselves cost nothing; you are billed only for the tool calls a workflow makes.
get_startedGreets a new user, asks what they are working on (a campaign, a brand, or a creator), and routes them to the right read tool before they spend credits.
shortlist-from-briefBuilds a creator shortlist from a campaign brief, fanning out one search_creators call per target and presenting a per-target slate with rationale.
lookalike-searchExpands a roster by finding creators similar to a seed creator that already worked, using search_creators in lookalike mode.
fair-price-checkJudges whether a creator’s quoted rate is fair: resolves the creator, assembles comparables, and benchmarks the rate against the deal corpus with provenance and honest caveats.