Gentic Influencer — Documentation
Connect any AI agent to 2M+ creator profiles with verified emails. Search by niche, score by brand fit, draft personalized outreach, and export matches — all through the Model Context Protocol.
1. Getting Started
Sign Up & Get Your API Key
Before you can use Gentic Influencer, you need an API key to authenticate your requests.
- Go to gentic.co/influencer and create an account.
- Create an organization from your dashboard. API keys and billing are scoped to the organization.
- Generate an API key and use it as a Bearer token in your MCP client.
2. Connecting to the MCP Server
The server is available at https://mcp.gentic.co/influencer. For Claude Code:
claude mcp add gentic-influencer \
--transport http \
https://mcp.gentic.co/influencer \
--header "Authorization: Bearer YOUR_API_KEY"For Claude Web and ChatGPT you can also connect via OAuth — no API key needed. See the connect section on the landing page for other MCP clients (n8n, OpenClaw).
3. Agent Skill
For the best results, pair the MCP server with the Gentic Influencer agent skill. The MCP server gives your agent tool access; the skill teaches it the optimal workflow order. Both the raw SKILL.md and a ready-to-upload .skill bundle are generated on demand from the live manifest, so they always reflect the current tools and pricing.
Add the skill directly via URL:
https://gentic.co/influencer/SKILL.mdOr upload a .skill bundle to Claude Managed Agents:
https://gentic.co/influencer/gentic-influencer.skillDownload this file and upload it wherever Claude Managed Agents asks for a .skill file. It's a zip bundle generated on demand from the latest SKILL.md.
4. When to Apply
- User wants to find influencers or creators for a brand campaign.
- User asks to search Instagram or TikTok for creator partnerships.
- User wants to score, review, or export creator match results.
- User is setting up or updating a brand profile for influencer matchmaking.
- User wants to draft or send outreach emails to creators.
- User wants to exclude existing creator relationships from future searches.
5. Workflow
1. Brand setup is required first
Always start with `get_brand`. If empty or missing, walk the user through `save_brand` before anything else — scoring and outreach both read from the profile. A good profile needs: `description` (brand identity, voice, target audience), `matchmakingInstructions` (what makes a creator a good fit, deal-breakers), `activeCampaignContext` (current product/campaign focus), `initialOutreachCallToAction` (the CTA paragraph for emails — e.g. product seeding, "reply if interested", "book a call"), and `emailSignOff` (defaults to "Team {brand_name}"). If the user has a website, use `fetch_page` (10¢) to pull context and draft the profile for them.
2. Upload excluded creators (optional)
If the brand already has creator relationships, call `upload_excluded_creators` so they don't show up in future searches. Two modes: pass a `usernames` array (agent extracts from a CSV or paste), or pass a public `googleSheetsUrl` (server-side fetch, extracts the first column). Auto-normalizes input — lowercases, strips `@`, handles Instagram/TikTok profile URLs. Deduplicated on insert. Capped at 5,000 per call.
3. Search both platforms in parallel
`search_creators` is **15¢/result**. Key rule: **always search both Instagram and TikTok** unless the user specifies one — run the two calls in parallel, don't serialize. Write descriptive `searchText` ("fitness micro-influencers who post workout routines and meal prep" beats "fitness influencers"). Use filters: `minFollowers`, `maxFollowers`, `country`, `minEngagementRate`. `campaignContext` auto-reads from the brand profile — only override if the user gives campaign-specific instructions. Each search gets a `run_id`. **Mention cost when running 50+ results.**
4. Score creators — async
`score_creators` is **35¢/result** and **runs async**. Tell the user results are processing and will be ready shortly — don't block waiting. Score both platforms if both were searched. `brandContext` auto-assembles from the brand profile — don't override unless asked. Scoring writes `final_match_score` (0-100) plus sub-scores back to the database.
5. Present results as a ranked table
Use `get_creator_results` to pull scored creators. Render as a **ranked markdown table** with columns: rank, username, platform, followers, engagement rate, match score, one-line analysis. **Bold any creator with score ≥ 80**. Below the table, highlight the **top 3** with a short paragraph each: why they fit, risk factors, personalized pitch angle. If `total` exceeds `count`, mention how many more results are available. If scores are null, scoring hasn't run yet — tell the user to run it first.
6. Draft outreach emails
`draft_personalized_creator_outreach_email` is **35¢/email**, capped at 10 per call. Requires `initialOutreachCallToAction` on the brand profile — prompt the user via `save_brand` if missing. Only drafts for creators that have been scored and don't already have an email. `minScore` defaults to 70 — only high-quality matches get emails. Sign-off is appended automatically from `emailSignOff`. Drafts are stored and visible in `get_creator_results` and `export_creator_results`.
7. Export when the user wants to share
`export_creator_results` is free and returns a CSV download link. **The link expires in 1 hour** — tell the user up front and remind them if the conversation stretches.
6. Tool Reference
9 tools, rendered live from the Gentic MCP manifest. Parameter tables come directly from each tool's JSON Schema.
draft_personalized_creator_outreach_email
Draft personalized outreach emails for scored creators using AI. Reads brand profile and creator data from MotherDuck, sends to Modal for async email generation. Only processes creators that have been scored but don't have an email yet. Billed at $0.35 per email actually drafted (not per requested).
| Parameter | Type | Description |
|---|---|---|
platformrequired | string | Platform to draft emails for enum: instagram, tiktok |
runId | string | Filter to a specific search run ID |
creatorUsernames | string[] | Specific creator usernames to draft emails for |
minScorerequired | number | Minimum match score threshold (default: 70) 0 – 100 · default: 70 |
maxCountrequired | number | Maximum number of emails to draft (default: 10, max: 10) 1 – 10 · default: 10 |
export_creator_results
Export scored creator matches as a downloadable CSV file. Uploads to storage and returns a signed download URL (expires in 1 hour). Results are filtered to the authenticated organization. Exports at most 100 rows, sorted by created_at DESC (most recently discovered first) — use filters (runId, platform, minScore, emailStatus) to narrow the set if you need a different slice.
| Parameter | Type | Description |
|---|---|---|
platform | string | Filter by platform enum: instagram, tiktok |
runId | string | Filter to a specific search run |
minScore | number | Minimum final_match_score threshold 0 – 100 |
emailStatus | string | Filter by email status: 'drafted' = has personalized email but not yet sent, 'sent' = email has been sent, 'none' = no email drafted enum: drafted, sent, none |
fetch_page
Fetch a web page and extract its readable text content. Use this to pull brand information from a company website or product details from a product page.
| Parameter | Type | Description |
|---|---|---|
urlrequired | string | URL to fetch and extract text from |
get_brand
Get the organization's current brand profile including brand identity, matchmaking instructions, and active campaign context.
This tool takes no parameters.
get_creator_results
Return scored creator matches so users can review them in-conversation. Results are filtered to the authenticated organization. Use this after search_creators → score_creators to view results inline without exporting.
| Parameter | Type | Description |
|---|---|---|
platform | string | Filter by platform enum: instagram, tiktok |
runId | string | Filter to a specific search run |
minScore | number | Minimum final_match_score threshold 0 – 100 |
scoredOnlyrequired | boolean | Only return creators that have been scored (default: true) default: true |
sortByrequired | string | Sort order (default: date) enum: date, score, followers, engagement · default: "date" |
limitrequired | integer | Max results to return (default: 10, max: 50) 1 – 50 · default: 10 |
offsetrequired | integer | Pagination offset (default: 0) 0 – 9007199254740991 · default: 0 |
emailStatus | string | Filter by email status: 'drafted' = has personalized email but not yet sent, 'sent' = email has been sent, 'none' = no email drafted enum: drafted, sent, none |
save_brand
Save or update the organization's brand profile. Used for initial brand setup and subsequent updates. All fields are optional so you can update individual fields without overwriting others.
| Parameter | Type | Description |
|---|---|---|
brandName | string | Brand name |
website | string | Brand website URL |
description | string | Brand identity, values, voice, and target audience |
matchmakingInstructions | string | Detailed influencer selection criteria — what kind of creators the brand wants, audience focus, content signals, targeting parameters |
activeCampaignContext | string | Currently active campaign/product context for creator searches |
initialOutreachCallToAction | string | The call-to-action paragraph placed at the end of personalized outreach emails to creators, right before the sign-off. Tells the creator what to do next. Written in the brand's voice, using 'we' not 'I'. Example: "We'd love to send you some of our best-selling products like our meal replacement shakes! There's no obligation to post—we simply want you to try our products and share your honest thoughts if you like them. Let us know if you're interested, and we'll send over the details!" |
emailSignOff | string | Sign-off line appended to the end of all outreach emails. Defaults to 'Team {brand_name}' if not set. Examples: 'Cheers, The Huel Team', 'Best, Team Oneskin', 'Talk soon, The Athletic Greens Crew' |
score_creators
Trigger AI-powered scoring for unscored creators in MotherDuck. Auto-assembles scoring context from the brand profile (description + matchmaking instructions). Per-row campaign context is included in each creator object. Scores are written back to MotherDuck asynchronously. Billed at $0.35 per creator actually scored. IMPORTANT: only run this when the user explicitly asks to score creators or evaluate brand fit. Do NOT auto-run after search_creators — the user should review raw search results first and decide whether scoring is worth the cost.
| Parameter | Type | Description |
|---|---|---|
platformrequired | string | Platform to score enum: instagram, tiktok |
brandContext | string | Override for brand context. If not provided, auto-assembled from the brand profile's description and matchmaking instructions. |
runId | string | Specific search run ID to score. If omitted, scores all unscored results for this brand+platform |
limitrequired | number | Max creators to score in this batch (default 10) 1 – 200 · default: 10 |
search_creators
Search for Instagram or TikTok creators using AI-powered vector search. Returns matching creator profiles with engagement metrics, reach estimates, and a vector similarity score (NOT a brand-fit score — run score_creators for that). USAGE: make ONE call per search intent and control result count via `limit` (1–50). Do NOT call repeatedly with variant keywords — write a single descriptive natural-language `searchText` instead (e.g. 'male menswear creators posting streetwear outfits and sneaker rotations'). COST: $0.15 per creator actually returned (not per requested). A search that returns 3 results costs $0.45 even if limit=10. Fewer results than `limit` usually means the database has limited matches for this query — broaden the query or lower filters rather than retrying with variants. Scoring is a separate, user-initiated step — do NOT automatically call score_creators after this unless the user explicitly asked to score.
| Parameter | Type | Description |
|---|---|---|
platformrequired | string | Social media platform to search enum: instagram, tiktok |
searchTextrequired | string | Search query describing the type of creators you're looking for |
limitrequired | number | Maximum number of results to return 1 – 50 · default: 10 |
minFollowers | number | Minimum follower count filter |
maxFollowers | number | Maximum follower count filter |
minEngagementRate | number | Minimum engagement rate filter (e.g., 0.01 for 1%) |
country | string | Country filter (e.g., 'USA', 'UK') |
excludePrivateAccountsrequired | boolean | Whether to exclude private accounts default: true |
minPostsCount | number | Minimum number of posts filter |
campaignContext | string | Campaign/product context for this search. If not provided, auto-reads active_campaign_context from the brand profile. |
upload_excluded_creators
Upload a list of creators to exclude from future search_creators results. Useful when a brand already has relationships with certain creators and doesn't want them re-discovered. Accepts either an array of usernames or a public Google Sheets URL.
| Parameter | Type | Description |
|---|---|---|
platformrequired | string | Platform for the excluded creators enum: instagram, tiktok |
usernames | string[] | Array of usernames to exclude. Required if googleSheetsUrl is not provided. |
googleSheetsUrl | string | Public Google Sheets URL. The tool fetches it as CSV and extracts usernames from the first column. Required if usernames is not provided. |
exclusionReason | string | Reason for excluding these creators (default: existing_relationship) enum: existing_relationship, declined, competitor, blacklisted |
notes | string | Freeform context, e.g. 'Q1 2026 roster' |
7. Pricing
Pricing is pulled live from the Gentic MCP manifest. All prices are per call and deducted from your Gentic credits.
| Tool | Cost |
|---|---|
| draft_personalized_creator_outreach_email | 35¢ / result (min 35¢) |
| export_creator_results | Free |
| fetch_page | 10¢ / call |
| get_brand | Free |
| get_creator_results | Free |
| save_brand | Free |
| score_creators | 35¢ / result (min 35¢) |
| search_creators | 15¢ / result (min 15¢) |
| upload_excluded_creators | Free |
8. Notes
- All tools are organization-scoped — users only see their own brand, runs, and excluded creators.
- Costs: `search_creators` 15¢/result, `score_creators` 35¢/result, `draft_personalized_creator_outreach_email` 35¢/email, `fetch_page` 10¢/page. Everything else is free. **Mention costs when running 50+ searches or scores.**
- `score_creators` is async — don't wait, tell the user results will be ready shortly.
- If a user asks to "find influencers" or "find creators" with no prior context, start from step 1 (brand setup).
- Export CSV links expire in 1 hour.