InfluIQ MCP Server
The InfluIQ MCP Server connects AI tools to the InfluIQ platform, enabling influencer analysis, discovery, reputation reporting, and account management through natural language.
Authentication
Sign in via browser login or API key; check current authentication status.
Influencer Analysis
Start new analyses for YouTube channels or Instagram profiles (costs 1 credit).
Retrieve full results including engagement metrics, audience demographics, content quality scores, sponsorship detection, and brand-fit analysis.
Poll analysis progress, list historical analyses (filtered by platform/status), and view aggregated dashboard stats.
Influencer Discovery
Search a vast database by platform, category, follower count, engagement tier, language, country, verification status, sponsorship history, and recent activity.
Retrieve detailed influencer profiles and available filter options (categories, languages, countries).
AI-Powered Discovery
Use AI to recommend campaign-fit influencers based on a brand profile and campaign description (costs credits).
Check credit-cost tiers, view past AI discovery runs, and retrieve full results.
Reputation Reports
Generate reputation reports analyzing trust signals, risk factors, and overall reputation scores.
Retrieve previously generated reports by ID and list full report history with pagination.
Billing & Subscription
Check credit balance, view subscription plan status and billing period, and list available plans with pricing and features.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@InfluIQ MCP Server Analyze the YouTube channel @MrBeast"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
InfluIQ MCP Server
Connect your AI tools (Claude Desktop, Cursor, etc.) to InfluIQ to analyze influencers, discover creators, and generate reputation reports — all through natural language.
Prerequisites
Node.js 18+
InfluIQ account — sign up at influiq.com
Related MCP server: Upriver MCP
Authentication
You can authenticate in two ways:
Option 1: Browser Login (easiest)
Just use the influiq_login tool — it opens your browser to sign in securely. No API key needed.
Option 2: API Key (best for automation)
Go to influiq.com and sign in
Navigate to Settings > API Keys
Click Generate API Key (requires Pro or Enterprise plan)
Set the
INFLUIQ_API_KEYenvironment variable in your MCP config
Setup
cd influiq-mcp-server
npm install
npm run buildConfigure in Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"influiq": {
"command": "node",
"args": ["/path/to/influiq-mcp-server/dist/index.js"],
"env": {
"INFLUIQ_API_KEY": "iq_your_api_key_here"
}
}
}
}If using browser login instead of API key, omit the
envblock — you'll authenticate via theinfluiq_logintool.
Configure in Cursor
Add to your Cursor MCP settings:
{
"influiq": {
"command": "node",
"args": ["/path/to/influiq-mcp-server/dist/index.js"],
"env": {
"INFLUIQ_API_KEY": "iq_your_api_key_here"
}
}
}Environment Variables
Variable | Required | Description |
| No | Your InfluIQ API key (format: |
| No | Custom API URL (default: |
| No | Custom app URL for login page (default: |
Available Tools
Authentication
Tool | Description |
| Sign in via browser (opens login page) |
| Check current authentication status |
Analysis
Tool | Description |
| Start a new influencer analysis (YouTube/Instagram) |
| Get full analysis results by ID |
| Poll analysis progress |
| List past analyses with filters |
| Get aggregated stats and credit balance |
Discovery
Tool | Description |
| Browse the discovery database by category, platform, engagement, etc. |
| Get detailed discovery profile |
| Get available filter options |
AI Discovery
AI-powered discovery asks OpenAI + Claude to recommend real influencers for a campaign,
verifies each against the live platform, and returns them with a justification. It consumes
analysis credits and works best with a brand_profile and campaign_description.
Tool | Description |
| AI search for campaign-fit influencers (costs credits) |
| Get the credit-cost tiers for AI discovery |
| List your past AI discovery runs |
| Get a past AI discovery run with full results |
Reputation
Tool | Description |
| Generate a reputation report |
| Get a report by ID |
| List your reports |
Billing
Tool | Description |
| Check credit balance |
| Get subscription status and usage |
| List available plans |
Example Prompts
"Analyze the YouTube channel @MrBeast"
"Find tech influencers with over 100K followers and high engagement"
"What's my current credit balance?"
"Generate a reputation report for instagram.com/therock"
"Discover beauty influencers in the US who are recently active"
"Use AI to find 20 fitness YouTubers in the US for our new protein bar campaign"
"How many credits does an AI discovery of 30 influencers cost?"
Available Tools
16 toolsinfluiq_auth_statusCheck Authentication StatusARead-onlyIdempotent
Check your current authentication status with InfluIQ.
Shows whether you're authenticated via API key or browser login. If not authenticated, provides instructions for both methods.
No arguments required.
Inputs: no named parameters.
influiq_discover_influencersDiscover InfluencersARead-onlyIdempotent
Search the InfluIQ discovery database for influencers matching specific criteria.
Filter by platform, categories, follower count, engagement tier, language, country, and more. Free plans see up to 3 results; paid plans get full access.
Args:
platform: "youtube" or "instagram" (optional)
categories: Array of category slugs (e.g. ["tech", "gaming", "beauty"])
follower_min / follower_max: Follower count range
engagement_tier: "high" (>5%), "medium" (1-5%), or "low" (<1%)
language / country: Filter by language or country
is_verified: Only verified accounts
has_sponsorships: Only influencers with sponsorship history
is_recently_active: Only posted in last 30 days
q: Text search (name, handle, bio)
sort_by: "followerCount", "engagementRate", "qualityScore", or "lastPostedAt"
page / limit: Pagination
Returns: List of influencer profiles with metrics.
Inputs: platform, categories, follower_min, follower_max, +11 more.
influiq_generate_reputation_reportGenerate Reputation ReportA
Generate a reputation report for an influencer. Consumes credits.
Analyzes trust signals, risk factors, and overall reputation score.
Args:
influencer_url: Full URL to the YouTube channel or Instagram profile
platform: "youtube" or "instagram"
Returns: Report with overallScore, trustSignals, riskFactors, and recommendations.
Inputs: influencer_url (required), platform (required).
influiq_get_analysisGet Analysis ResultsARead-onlyIdempotent
Retrieve the full results of a completed influencer analysis.
Returns comprehensive data including engagement metrics, audience demographics, content quality scores, sponsorship detection, and brand-fit analysis.
If the analysis is still processing, check status with influiq_get_analysis_progress.
Args:
analysis_id: The UUID of the analysis (from influiq_start_analysis)
Returns: Full analysis object with profile, metrics, scores, and AI insights.
Inputs: analysis_id (required).
influiq_get_analysis_progressCheck Analysis ProgressARead-onlyIdempotent
Poll the progress of a running analysis. Lightweight endpoint.
Args:
analysis_id: The UUID of the analysis
Returns: { status, progress (0-100), currentStep }
Inputs: analysis_id (required).
influiq_get_credits_balanceGet Credits BalanceARead-onlyIdempotent
Check your current analysis credit balance.
No arguments required.
Returns: { credits: number }
Inputs: no named parameters.
influiq_get_dashboard_statsGet Dashboard StatisticsARead-onlyIdempotent
Get aggregated statistics: total analyses, completed count, recent analyses, platform breakdown, and current credit balance.
No arguments required.
Returns: { totalAnalyses, completedAnalyses, recentAnalyses, platformStats, analysisCredits }
Inputs: no named parameters.
influiq_get_discovery_filtersGet Discovery Filter OptionsARead-onlyIdempotent
Get available filter options for discovery: categories, languages, and countries.
No arguments required.
Returns: { categories: [{slug, name}], languages: string[], countries: string[] }
Inputs: no named parameters.
influiq_get_discovery_profileGet Discovery ProfileARead-onlyIdempotent
Get detailed profile of a discovered influencer by ID.
Args:
profile_id: Discovery profile UUID
Returns: Full profile with metrics, categories, demographics, and sponsorship data.
Inputs: profile_id (required).
influiq_get_reputation_reportGet Reputation ReportARead-onlyIdempotent
Retrieve a previously generated reputation report by ID.
Args:
report_id: Report UUID
Returns: Full report with scores, trust signals, and risk factors.
Inputs: report_id (required).
influiq_get_subscriptionGet Subscription StatusARead-onlyIdempotent
Get your current subscription plan, status, usage, and billing period.
No arguments required.
Returns: { subscription: { status, currentPeriodEnd, usageUsedThisPeriod }, plan: { name, tier, includedUsagePerMonth, apiAccess } }
Inputs: no named parameters.
influiq_list_analysesList Analysis HistoryARead-onlyIdempotent
List your past influencer analyses with pagination.
Args:
page: Page number (default: 1)
limit: Results per page (default: 20, max: 50)
platform: Optional filter by "youtube" or "instagram"
status: Optional filter by "completed", "processing", "error"
Returns: Paginated list of analyses with basic info (id, platform, username, status, date).
Inputs: page, limit, platform, status.
influiq_list_plansList Subscription PlansARead-onlyIdempotent
List all available InfluIQ subscription plans with pricing and features.
No arguments required.
Returns: Array of plans with name, tier, pricing, included usage, and feature flags.
Inputs: no named parameters.
influiq_list_reputation_reportsList Reputation ReportsBRead-onlyIdempotent
List your reputation reports with pagination.
Args:
page: Page number (default: 1)
limit: Results per page (default: 20)
Returns: Paginated list of reputation reports.
Inputs: page, limit.
influiq_loginLogin to InfluIQAIdempotent
Sign in to InfluIQ by opening the login page in your browser.
A browser window will open where you can securely enter your credentials. After logging in, the session is automatically linked — no need to copy tokens.
This is an alternative to API key authentication. For API keys:
Go to https://influiq.com → Settings → API Keys
Click "Generate API Key" (requires Pro or Enterprise plan)
Set INFLUIQ_API_KEY in your MCP server config
No arguments required.
Inputs: no named parameters.
influiq_start_analysisStart Influencer AnalysisA
Start a new influencer analysis on InfluIQ. Consumes 1 analysis credit.
Supports YouTube channels and Instagram profiles. Provide either a URL or a platform + username.
Returns an analysisId to poll for results with influiq_get_analysis.
Args:
platform: "youtube" or "instagram"
url: Full URL to the channel/profile (e.g. https://youtube.com/@MrBeast)
username: Channel handle or username (e.g. "MrBeast", "@MrBeast")
brand_profile_id: Optional brand profile ID for brand-fit scoring
Returns: { analysisId, status, platform, creditsRemaining }
Inputs: platform (required), url, username, brand_profile_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Every tool has a distinct purpose. For example, generate_reputation_report vs get_reputation_report are clearly different (create vs retrieve), and get_analysis vs get_analysis_progress serve different stages. No two tools have overlapping functionality.
Tools follow a 'influiq_' prefix with mostly snake_case verbs. Most use 'get_' or 'list_' for retrieval, but there are minor deviations like 'auth_status' (not 'get_auth_status') and 'login' (no prefix verb). Still, the pattern is recognizable and predictable.
16 tools is slightly above the typical 3-15 range but still justified. Each tool covers a unique aspect (auth, discovery, analysis, reports, credits, plans) without redundancy. The count is reasonable for the domain's complexity.
The tool set covers the core lifecycle: authentication, discovery (search, filters, profile details), analysis (start, progress, results), and reputation (generate, get). Minor gaps exist (no brand profile management), but no critical missing operations for the stated purpose.
Maintenance
Related MCP Connectors
Search 455M+ Instagram, TikTok and YouTube creators and analyze influencers from your AI assistant.
Manage 230M+ influencers, track campaigns, and access real-time CIMS analytics via AI agents
Find and analyze influencers with creator search, lookalikes, profiles, posts, and transcripts.
Search 1.8M+ YouTube, TikTok and Instagram creators with emails and run outreach from your AI agent.
Related MCP Servers
AlicenseAqualityCmaintenanceEnables AI-native creator discovery for influencer marketing, including creator search, lookalikes, profile lookup, and Instagram post transcript analysis.1438 npm1MIT
Upriver MCPofficial
AlicenseNot gradedqualityDmaintenanceProvides AI applications with real-time, evidence-backed context on creators, audiences, brands, trends, and sponsorships, including breakout topic search and browsing tools.MIT
Mysocial Intelligenceofficial
AlicenseNot gradedqualityCmaintenanceEnables creators to connect their social channels so AI assistants can read their published Instagram, TikTok, YouTube, LinkedIn and Threads history, including posts, metrics, transcripts, comments and audience data, then use bundled skills to plan next posts, research creators, maintain brand docs, manage product catalogues and find outreach targets.MIT- AlicenseAqualityCmaintenanceEnables brands to create, update, add photos to, and track influencer-marketing offers through AI assistants, while letting anyone search public campaigns without a token.81Apache 2.0