Gentic Influencer — Documentation
Everything you need to go from sign-up to your first scored creator export.
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, billing, and creator data are all scoped to the organization.
- Go to the API Keys section in your dashboard.
- Click Create API Key. Give it a name (e.g. "Claude Code" or "n8n production").
- Copy the key immediately — it starts with
gentic_and is only shown once.
Anyone on your team can generate their own key, and they'll all share the same brand profile, search history, and credit balance.
Keep your key secure. Treat it like a password. Don't commit it to version control or share it publicly.
2. Connecting to the MCP Server
Gentic Influencer uses the Model Context Protocol (MCP) — an open standard for connecting AI agents to external tools. You connect once, and your agent gets access to all Gentic Influencer tools automatically.
Server URL: https://mcp.gentic.co/influencer
Claude Code (CLI)
Option A — OAuth (no API key needed):
claude mcp add gentic-influencer --transport http https://mcp.gentic.co/influencerClaude Code will prompt you to authenticate on first use.
Option B — API key:
claude mcp add gentic-influencer --transport http https://mcp.gentic.co/influencer --header "Authorization: Bearer <your-api-key>"Replace <your-api-key> with a key from your dashboard.
Claude Web / Claude Desktop / Claude Mobile
- Go to Settings → Connectors
- Click Add custom connector at the bottom of the page
- Enter the server URL:
https://mcp.gentic.co/influencer - Click Add — you'll be redirected to sign in and authorize access via OAuth
Custom connectors require a Claude Pro, Max, Team, or Enterprise plan.
ChatGPT
- Go to Settings → Apps & Connectors → Advanced settings and enable developer mode
- Go to Settings → Connectors → Create
- Set the connector name to Gentic Influencer and the URL to:
https://mcp.gentic.co/influencer - You'll see Gentic's tools listed if the connection is successful
- In a new chat, click + near the message bar, select More, and choose Gentic Influencer
ChatGPT Apps are available on Plus, Pro, Team, Business, Enterprise, and Education plans.
n8n
- Add an MCP Client node to your workflow
- Set the server URL to
https://mcp.gentic.co/influencer - Add your API key as a Bearer token in the authentication settings
Any Other MCP Client
Gentic Influencer uses standard Streamable HTTP transport. Any client that supports MCP can connect using the server URL and either OAuth or API key Bearer token authentication.
Agent Skills (Recommended)
For the best results, pair the MCP server with the Gentic agent skill. The MCP server gives your agent access to the tools; the skill teaches it the optimal workflow order — brand setup, search, score, review, and export.
1. Add the MCP server (if you haven't already):
claude mcp add gentic-influencer --transport http https://mcp.gentic.co/influencer --header "Authorization: Bearer <your-api-key>"2. Install the agent skill:
npx skills add gentic-co/agent-skills- MCP server — provides tool access (search, score, export, etc.)
- Agent skill — teaches the optimal workflow order: brand setup → search → score → review → draft outreach → export
Works with Claude Code, Cursor, Copilot, and 40+ other agents.
3. Step 1 — Set Up Your Brand
Tool: save_brand
Before searching, tell Gentic who you are. Your brand profile powers every search and score — the more context you provide, the better your results.
What to include
| Field | What to write | Example |
|---|---|---|
| brandName | Your brand name | "Heyday Skincare" |
| website | Your website URL | "https://heydayskincare.com" |
| description | Brand identity, values, voice, and target audience. Be specific — this directly influences match scoring. | "Clean skincare brand targeting women 25-40 who value ingredient transparency. Tone is warm, educational, never preachy. Hero products are the Vitamin C serum and overnight mask." |
| matchmakingInstructions | Detailed criteria for the type of creators you want. Think of this as your brief to a talent scout. | "Looking for micro-influencers (10K-100K followers) who post skincare routines, ingredient breakdowns, or get-ready-with-me content. Must have authentic engagement — avoid accounts with inflated follower counts. Prefer creators who have done brand partnerships before but are not oversaturated with sponsorships." |
| activeCampaignContext | The specific campaign or product you're currently sourcing creators for. Update this each time you run a new campaign. | "Summer 2026 launch of SPF 50 tinted moisturizer. Looking for creators who post outdoor/beach content or daily SPF routines." |
| initialOutreachCallToAction | The CTA paragraph appended to outreach emails — tells creators what to do next (e.g. product seeding offer, "reply if interested", "book a call"). Required for drafting outreach emails. | "We'd love to send you our new SPF 50 tinted moisturizer to try — no strings attached. If you're interested, just reply to this email and we'll get it shipped out!" |
| emailSignOff | Sign-off line for outreach emails. Defaults to "Team {brand_name}" if not set. | "The Heyday Skincare Team" |
Example prompt to your agent
"Use save_brand to set up my brand. Brand name is Heyday Skincare, website is heydayskincare.com. We're a clean skincare brand for women 25-40 who care about ingredients. We want micro-influencers who post skincare routines and ingredient content, 10K-100K followers, authentic engagement. Current campaign: summer SPF 50 tinted moisturizer launch."
Your agent will call save_brand with the structured fields. You can update any individual field later without overwriting the others.
Tip: Use fetch_page to auto-populate
Don't want to write your brand description from scratch? Ask your agent:
"Fetch the page at heydayskincare.com and use what you find to fill in my brand profile with save_brand."
The agent will use fetch_page ($0.10) to pull your website content, then use it to craft a rich brand description and save it.
Verify with get_brand
At any time, ask your agent to show your current brand profile:
"Show me my current brand profile."
This calls get_brand (free) and returns all your saved fields.
4. Step 2 — Exclude Existing Creators (Optional)
Tool: upload_excluded_creators
Cost: Free
If your brand already has creator relationships, upload them before searching so they're excluded from results. This prevents wasting search credits on creators you've already worked with, declined, or flagged.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| brandSlug | string | Yes | — | Brand identifier/slug |
| platform | enum | Yes | — | "instagram" or "tiktok" |
| usernames | string[] | Conditional | — | Array of usernames or profile URLs. Required if googleSheetsUrl is not provided. |
| googleSheetsUrl | string | Conditional | — | Public Google Sheets URL. Required if usernames is not provided. Must be shared as "Anyone with the link can view." |
| exclusionReason | enum | No | existing_relationship | One of: existing_relationship, declined, competitor, blacklisted |
| notes | string | No | — | Freeform context (e.g. "Q1 2026 roster") |
Input modes
You must provide exactly one of usernames or googleSheetsUrl — the tool will error if both (or neither) are provided.
- Usernames array — pass creator handles directly. Supports raw usernames, @-prefixed handles, and full Instagram/TikTok profile URLs (usernames are auto-extracted).
- Google Sheets URL — link to a public sheet. The tool reads usernames from the first column, skips the header row, and auto-normalizes just like the array input.
Key behaviors
- Auto-normalizes usernames: lowercases, strips
@prefixes, extracts handles from profile URLs - Deduplicates — usernames already in the exclusion list are skipped
- Returns a count of inserted vs. already-existed
- Capped at 5,000 usernames per call
- Excluded creators are automatically filtered out of all future
search_creatorscalls for that brand + platform
Example prompts
From a list:
"Exclude these Instagram creators from my searches: @skincarebyjess, @glowwithmel, @cleanbeautyliz"
From a spreadsheet:
"Import my existing creator roster from this Google Sheet and exclude them from future Instagram searches: https://docs.google.com/spreadsheets/d/..."
With a reason:
"Exclude these TikTok creators as competitors: @rivalbeauty, @competingbrand"
5. Step 3 — Search for Creators
Tool: search_creators
Cost: $0.15 per result returned (includes creator email)
This is the core tool. Describe the type of creator you're looking for in natural language, and Gentic searches across millions of Instagram and TikTok profiles using AI-powered vector search.
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| platform | Yes | — | "instagram" or "tiktok" |
| searchText | Yes | — | Natural language description of creators you want |
| brandSlug | Yes | — | Your brand identifier (your agent knows this) |
| limit | No | 10 | Number of results to return (1–50) |
| minFollowers | No | — | Minimum follower count |
| maxFollowers | No | — | Maximum follower count |
| minEngagementRate | No | — | Minimum engagement rate (0.03 = 3%) |
| country | No | "US" | Country filter |
| excludePrivateAccounts | No | true | Exclude private accounts |
| minPostsCount | No | — | Minimum number of posts |
| campaignContext | No | Auto-read from brand profile | Override campaign context for this search |
Example prompts
Simple search:
"Search for 20 Instagram fitness creators with 10K-50K followers."
Detailed search:
"Search TikTok for skincare creators who post ingredient breakdowns and routine videos. Min 15K followers, max 80K, engagement rate above 3%. Get me 30 results."
Multiple rounds:
"Search again with the same criteria — I want more creators."
Gentic automatically deduplicates across searches, so running the same query again surfaces fresh creators you haven't seen before.
What you get back (per creator)
- Username and full name
- Bio/description
- Follower count, following count, posts/videos count
- Engagement rate
- Email address (extracted and verified)
- Country/region
- Similarity score — how closely they match your search
- Match rating — letter grade (A+, A, A-, B+, B) based on similarity
- Estimated reach — projected engagement per post
How search works under the hood
Your search text is converted into a vector embedding and compared against Gentic's profile index using semantic similarity. This means you don't need exact keyword matches — "creators who talk about clean eating" will find profiles about nutrition, whole foods, meal prep, and related topics even if they never use the phrase "clean eating."
Results are filtered by your criteria (followers, engagement, country), deduplicated against your previous searches, and ranked by match score.
6. Step 4 — Score Your Matches
Tool: score_creators
Cost: $0.35 per creator scored
Search gives you relevant creators. Scoring tells you which ones actually fit your brand. This tool runs AI-powered analysis on your search results using your brand profile as context.
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| platform | Yes | — | "instagram" or "tiktok" |
| brandSlug | Yes | — | Your brand identifier |
| brandContext | No | Auto-assembled from brand profile | Override brand context |
| runId | No | — | Score a specific search run only |
| limit | No | 50 | Max creators to score per batch (1–200) |
Example prompts
Score everything unscored:
"Score my Instagram search results for Heyday."
Score a specific run:
"Score only the TikTok results from my last search."
Score in batches:
"Score the next 100 unscored creators."
What scoring produces (per creator)
| Field | Description |
|---|---|
| final_match_score | 0–100 overall score |
| brand_voice_alignment | How well the creator's tone matches your brand |
| audience_overlap | Estimated overlap between their audience and your target |
| profile_quality | Content quality, consistency, and professionalism |
| risk_factors | Red flags: fake followers, controversial content, over-saturation |
| final_analysis | Written paragraph explaining the score |
How scoring works
Scoring is asynchronous. When you trigger it, Gentic sends the batch to its AI scoring engine which analyzes each creator against your brand description and matchmaking instructions. Results are written back to your creator data automatically.
If you have more unscored creators than your batch limit, the tool will tell you how many remain — just call it again to process the next batch.
Pro tip
Run search first with a broad limit (e.g., 50), then score only the top results. Search costs $0.15/result and scoring costs $0.35/creator, so it's more cost-effective to cast a wide net with search and be selective about what you score.
7. Step 5 — View Your Results
Tool: get_creator_results
Cost: Free
After scoring, review your results directly in the conversation — no export needed. This tool returns scored creator data inline so you and your agent can discuss, filter, and iterate before deciding who to reach out to.
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| platform | No | All | Filter by "instagram" or "tiktok" |
| runId | No | All runs | Filter to a specific search run |
| minScore | No | — | Minimum final_match_score threshold (0–100) |
| sortBy | No | score | Sort by "score", "followers", or "engagement" |
| limit | No | 10 | Max results to return (1–50) |
| offset | No | 0 | Pagination offset for browsing through results |
Example prompts
Quick overview:
"Show me my top 10 scored creators."
Filtered view:
"Show me Instagram creators with a match score above 80, sorted by engagement."
Paginate:
"Show me the next 10 results."
What you get back (per creator)
- Username, full name, platform
- Followers, engagement rate, posts count
- Email and biography
- Match score (0–100) with brand voice alignment, audience overlap, and profile quality breakdowns
- Risk factors and final analysis
- Outreach email subject and body (if drafted)
When to use this vs. export
Use get_creator_results to review and discuss results with your agent in real time — ask follow-up questions, compare creators, or refine your criteria. Use export_creator_results when you're ready to move results into your CRM, outreach tool, or spreadsheet.
8. Step 6 — Draft Outreach Emails
Tool: draft_personalized_creator_outreach_email
Cost: $0.35 per email drafted
After scoring, generate personalized outreach emails for your top creators. The AI reads each creator's actual post content and match analysis to write emails that reference their specific topics and explain why they'd be a great fit — not generic "we love your content" templates.
How it works
- Reads your brand profile and the scored creator data (including
creator_post_content— their recent posts) - Generates a personalized subject line and email body for each creator
- References the creator's actual content themes and connects them to your brand's identity and campaign
- Appends your custom CTA paragraph (
initialOutreachCallToAction) and sign-off (emailSignOff) - Stores drafts back to the database — visible in
get_creator_resultsandexport_creator_results
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| platform | Yes | — | "instagram" or "tiktok" |
| brandSlug | Yes | — | Your brand identifier |
| runId | No | — | Draft for a specific search run only |
| minScore | No | 70 | Minimum match score threshold — only high-quality matches get emails |
| limit | No | 10 | Max emails to draft per call (capped at 10) |
Example prompts
Draft for top matches:
"Draft outreach emails for my top Instagram creators."
Higher score threshold:
"Draft outreach emails for TikTok creators with a match score above 85."
Specific run:
"Draft emails for the creators from my last search run."
Prerequisites
- Creators must be scored first — the tool only drafts for creators that have a match score
- Your brand profile must have
initialOutreachCallToActionset — add it viasave_brandif missing - Creators who already have an email draft are skipped automatically
How the emails are generated
Email drafting is asynchronous — the tool returns immediately and results are ready in about 30 seconds. The AI reads each creator's recent post content, their match analysis, and your brand profile to craft an email that references exactly what the creator talks about and why those themes align with your brand. Your custom CTA and sign-off are appended for consistency.
Once drafts are ready, they appear in get_creator_results and are included in export_creator_results CSV exports (as email_subject and personalized_email_body columns).
9. Step 7 — Export Your Results
Tool: export_creator_results
Cost: Free
Once your creators are scored, export everything as a CSV for your outreach tool, CRM, or spreadsheet.
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| platform | No | All | Filter by "instagram" or "tiktok" |
| runId | No | All runs | Filter to a specific search run |
| minScore | No | — | Only include creators with this minimum match score (0–100) |
Example prompts
"Export all my scored Instagram results with a match score above 70."
"Export everything as a CSV."
"Export only TikTok results from the last search run."
What's in the CSV
The export includes 22 columns:
creator_username, creator_full_name, platform, creator_followers,
creator_following, creator_posts_count, creator_avg_engagement,
creator_email, creator_biography, search_query, final_match_score,
brand_voice_alignment, audience_overlap, profile_quality, risk_factors,
final_analysis, email_subject, personalized_email_body, sent_as_email,
email_sent_at, similarity_score, campaign_context, created_at, run_idYour agent will return a download link. Links expire after 1 hour — download promptly or request a fresh export.
10. Tool Reference
| Tool | Description | Cost |
|---|---|---|
| search_creators | AI vector search across Instagram & TikTok profiles. Returns creators with emails. | $0.15/result |
| score_creators | AI match scoring against your brand profile. Produces scores, analysis, and outreach drafts. | $0.35/creator |
| save_brand | Save or update your brand profile (name, description, matchmaking criteria, campaign context). | Free |
| get_brand | View your current brand profile. | Free |
| upload_excluded_creators | Exclude existing creator relationships from future searches. Accepts username arrays or Google Sheets URLs. | Free |
| fetch_page | Extract readable text from any web page. Useful for pulling brand/product info. | $0.10/page |
| get_creator_results | View scored results inline. Filter by platform, run, or min score. Sort by score, followers, or engagement. | Free |
| export_creator_results | Export scored results as a downloadable CSV. | Free |
| draft_personalized_creator_outreach_email | AI-generate personalized outreach emails for scored creators. References their actual post content and match analysis. | $0.35/email |
11. Pricing
No subscriptions. No seat licenses. Pay only when your agent calls a paid tool.
| Action | Cost |
|---|---|
| Creator search result (includes email) | $0.15 |
| AI match score (per creator) | $0.35 |
| Outreach email draft (per creator) | $0.35 |
| Brand profile management | Free |
| Creator exclusion list upload | Free |
| Web page fetching | $0.10 |
| Inline results review | Free |
| CSV export | Free |
Example workflow cost
- Fetch brand page: 1 x $0.10 = $0.10
- Search 100 creators: 100 x $0.15 = $15.00
- Score top 30 matches: 30 x $0.35 = $10.50
- Draft outreach for top 10: 10 x $0.35 = $3.50
- Review results inline: Free
- Export CSV: Free
- Total: $29.10
Credits are deducted from your organization's balance in real-time. You can check your balance anytime in your dashboard.