Skip to main content
Glama
InfluIQ MCP Server

InfluIQ MCP Server

by tommysdaniel

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

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)

  1. Go to influiq.com and sign in

  2. Navigate to Settings > API Keys

  3. Click Generate API Key (requires Pro or Enterprise plan)

  4. Set the INFLUIQ_API_KEY environment variable in your MCP config

Setup

cd influiq-mcp-server
npm install
npm run build

Configure 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 env block — you'll authenticate via the influiq_login tool.

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

INFLUIQ_API_KEY

No

Your InfluIQ API key (format: iq_...). If not set, use influiq_login tool.

INFLUIQ_API_URL

No

Custom API URL (default: https://backend.influiq.com/api)

INFLUIQ_APP_URL

No

Custom app URL for login page (default: https://influiq.com)

Available Tools

Authentication

Tool

Description

influiq_login

Sign in via browser (opens login page)

influiq_auth_status

Check current authentication status

Analysis

Tool

Description

influiq_start_analysis

Start a new influencer analysis (YouTube/Instagram)

influiq_get_analysis

Get full analysis results by ID

influiq_get_analysis_progress

Poll analysis progress

influiq_list_analyses

List past analyses with filters

influiq_get_dashboard_stats

Get aggregated stats and credit balance

Discovery

Tool

Description

influiq_discover_influencers

Browse the discovery database by category, platform, engagement, etc.

influiq_get_discovery_profile

Get detailed discovery profile

influiq_get_discovery_filters

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

influiq_ai_discover_influencers

AI search for campaign-fit influencers (costs credits)

influiq_get_ai_discovery_pricing

Get the credit-cost tiers for AI discovery

influiq_get_ai_discovery_history

List your past AI discovery runs

influiq_get_ai_discovery_run

Get a past AI discovery run with full results

Reputation

Tool

Description

influiq_generate_reputation_report

Generate a reputation report

influiq_get_reputation_report

Get a report by ID

influiq_list_reputation_reports

List your reports

Billing

Tool

Description

influiq_get_credits_balance

Check credit balance

influiq_get_subscription

Get subscription status and usage

influiq_list_plans

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 tools
influiq_auth_statusCheck Authentication StatusA
Read-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 InfluencersA
Read-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 ResultsA
Read-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 ProgressA
Read-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 BalanceA
Read-onlyIdempotent

Check your current analysis credit balance.

No arguments required.

Returns: { credits: number }

Inputs: no named parameters.

influiq_get_dashboard_statsGet Dashboard StatisticsA
Read-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 OptionsA
Read-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 ProfileA
Read-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 ReportA
Read-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 StatusA
Read-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 HistoryA
Read-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 PlansA
Read-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 ReportsB
Read-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 InfluIQA
Idempotent

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:

  1. Go to https://influiq.com → Settings → API Keys

  2. Click "Generate API Key" (requires Pro or Enterprise plan)

  3. 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

    A3.9/5.0

    Scored across 16 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI-native creator discovery for influencer marketing, including creator search, lookalikes, profile lookup, and Instagram post transcript analysis.
      14
      38 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI applications with real-time, evidence-backed context on creators, audiences, brands, trends, and sponsorships, including breakout topic search and browsing tools.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      A
      quality
      C
      maintenance
      Enables brands to create, update, add photos to, and track influencer-marketing offers through AI assistants, while letting anyone search public campaigns without a token.
      8
      1
      Apache 2.0