MCP documentation

Connect your AI assistant.
Put creator data to work.

Search 455M+ Instagram, TikTok and YouTube creators from the assistant you already use.

IQFluence MCP is a remote Model Context Protocol server that gives AI assistants access to IQFluence influencer data: 455M+ Instagram, TikTok and YouTube creators. From Claude, ChatGPT, Codex, Cursor and other MCP clients you can find creators, open audience reports with fake-follower checks, compare creators, check audience overlap, build media plans, read posts and comments, and see Campaign Monitoring results. The assistant works on behalf of your IQFluence account through OAuth and spends MCP credits, a balance separate from your website and API credits. The first 3 results of every search are free.

Supported assistants

Server URL
https://mcp.iqfluence.io/mcp

Swipe horizontally to view the full table.

ParameterDetails
TransportStreamable HTTP (remote server, nothing to install)
AuthenticationOAuth 2.1 in the browser; API key (Authorization: Bearer) for scripts and CI
Free trial5 MCP credits on the first connection, valid for 30 days, once per account
PlansStarter $199/mo (300 credits), Pro $299/mo (500 credits)
Supportsupport@iqfluence.io
LegalPrivacy Policy · Terms of Service

You need an IQFluence account. Create one for free.

Swipe horizontally to view the full table.

AssistantWho can connect it
Claude: web, Desktop, mobile appAny plan; on Free you can add one custom connector. In Claude Team and Enterprise the organization owner adds the connector, then every member connects their own IQFluence account.
Claude Code, Codex, Cursor, VS Code, OpenCode, Gemini CLIAny user, with one command or one line of config.
ChatGPT: webBusiness, Enterprise and Edu: the workspace admin connects it. Pro: the user connects it in developer mode. Free, Plus and Go don't support custom servers yet.

Claude

  1. Open Customize → Connectors. Click Add → Add custom connector.
  2. Name: IQFluence. URL: https://mcp.iqfluence.io/mcp. Click Continue.
  3. Leave the sign-in settings as they are: Claude detects OAuth on its own. Click Add.
  4. Click Connect. In the IQFluence window check the account and click Allow access. If you are not signed in, IQFluence asks you to sign in first.
  5. Done. The connector works on the website, in Claude Desktop and in the mobile app.

Describe the task in plain words and mention IQFluence. Claude asks for permission before calling a tool: Allow once or Always allow. Reports, comparisons, media plans, overlaps, campaigns and balance appear as cards in the chat; ask for a table if you need the raw numbers.

Claude Team and Enterprise. The organization owner adds the connector: Organization settings → Connectors → Add → Custom → Web, same URL. Then each member opens Customize → Connectors and clicks Connect next to IQFluence.

Claude Code

Claude Code
claude mcp add --transport http --scope user iqfluence https://mcp.iqfluence.io/mcp
claude mcp login iqfluence

The second command opens your browser. Click Allow access; the terminal shows “Authenticated with "iqfluence"”. Then run claude and ask a question. --scope user makes IQFluence available in all projects. You can also sign in from inside Claude Code: /mcp → iqfluence → Authenticate.

Codex

Codex
codex mcp add iqfluence --url https://mcp.iqfluence.io/mcp

Codex detects OAuth and opens your browser. Click Allow access; the terminal shows “Successfully logged in”. The setup is shared by the Codex CLI and the Codex IDE extension. To sign in again: codex mcp login iqfluence.

ChatGPT

ChatGPT connects custom MCP servers on the website only, on the Pro, Business, Enterprise and Edu plans.

Pro

  1. Open Plugins → Add → Add custom MCP server. If the item is missing, turn on developer mode: Settings → Apps → Advanced settings → Developer mode.
  2. Name: IQFluence. Server URL: https://mcp.iqfluence.io/mcp. Authentication: OAuth. Tick “I understand and want to continue” and click Create as a plugin.
  3. Click Connect IQFluence, then Allow access.
  4. Open the plugin and click Try in chat. In the chat select @IQFluence and ask a question.

Business, Enterprise, Edu

  1. The admin turns on developer mode: Settings → Apps → Advanced settings → Developer mode.
  2. Workspace settings → Apps → Create: name IQFluence, URL https://mcp.iqfluence.io/mcp, authentication OAuth.
  3. Click Scan Tools, sign in to IQFluence and click Allow access. Wait for the tool list and click Create.
  4. Test the draft in a chat, then publish it: Workspace settings → Apps → Drafts → Publish. Employees connect their own IQFluence accounts.

Other clients

Every client uses the same server URL and browser sign-in (OAuth); only the place where you enter the URL differs.

Cursor

Add the following configuration to ~/.cursor/mcp.json or .cursor/mcp.json.

Cursor configuration
{
  "mcpServers": {
    "iqfluence": {
      "url": "https://mcp.iqfluence.io/mcp"
    }
  }
}

VS Code (Copilot)

Open the Command Palette → MCP: Add Server → HTTP, or add the following configuration to .vscode/mcp.json.

VS Code configuration
{
  "servers": {
    "iqfluence": {
      "type": "http",
      "url": "https://mcp.iqfluence.io/mcp"
    }
  }
}

OpenCode

  1. Add the remote server to opencode.json.

    OpenCode configuration
    {
      "mcp": {
        "iqfluence": {
          "type": "remote",
          "url": "https://mcp.iqfluence.io/mcp",
          "enabled": true
        }
      }
    }
  2. Sign in with your IQFluence account.

    OpenCode authentication
    opencode mcp auth iqfluence

Gemini CLI

  1. Add the HTTP server.

    Gemini CLI configuration
    gemini mcp add --transport http iqfluence https://mcp.iqfluence.io/mcp
  2. Then authenticate inside Gemini CLI.

    Gemini CLI authentication
    /mcp auth iqfluence

API key instead of OAuth. For scripts and CI, create a key in Profile → API keys and send Authorization: Bearer <your API key>. Requests through MCP still spend MCP credits.

API key authentication
claude mcp add --transport http --scope user iqfluence https://mcp.iqfluence.io/mcp --header "Authorization: Bearer YOUR_API_KEY"

Example prompts

  • “Find 5 US food creators on Instagram: 50–200K followers, ER above 3%”
  • “Analyze Instagram creator johnnyscookin: who is the audience?”
  • “Compare johnnyscookin, chefsummerstorm and surelynotvegan for a US campaign”
  • “Build a media plan for these three creators with fees of £500, £800 and £1,200”
  • “How much do the audiences of @a and @b overlap?”
  • “Show recent TikTok posts for #veganrecipes”
  • “How is my Campaign Monitoring campaign doing?”
  • “How many credits do I have left?”

Tools and pricing

The assistant picks the right tool for the task. It states the cost of paid steps and asks you first if a task costs more than 5 credits.

Swipe horizontally to view the full table.

ToolWhat it doesCost
search_influencersFinds Instagram, TikTok and YouTube creators by niche, location, size, engagement and audience demographicsFirst 3 results free; further rows come back hidden
unlock_search_resultsReveals hidden search rows0.02 credits per account
lookup_filter_valuesFinds filter values: locations, interests, brands, languages, hashtagsFree
get_influencer_reportFull creator report: audience and its quality, engagement, growth, content, contacts1 credit; free if bought in the last 30 days
compare_influencersCompares 2–5 creators1 credit per creator without a recent report
build_media_planExpected views, engagements, CPM and cost per engagement1 credit per creator without a recent report
audience_overlapShared audience and unique reach across creators1 credit per calculation; free if a creator has no audience data
get_contactsPublic contacts: email, phone, other social accounts0.04 credits per account with contacts
get_hashtag_postsPublic posts with a hashtag0.02 credits per page; first TikTok page 0.04
get_creator_postsA creator's latest posts0.02 credits per page; first TikTok page 0.04
get_postOne post's stats and content0.02 credits
get_post_commentsComments under a post0.02 credits per page; first YouTube page 0.04
list_my_reportsReports bought in the last 60 daysFree
list_campaignsCampaign Monitoring campaignsFree
get_campaign_statsCampaign results: views, engagement, budget, top postsFree
get_account_balanceMCP balance, plan and today's spend for this connectionFree

MCP credits and plans

Swipe horizontally to view the full table.

StarterPro
Credits per month300500
Monthly billing$199/month$299/month
Yearly billing (20% off)$1,910.40$2,870.40
  • Trial: 5 credits on the first connection, once per account, valid for 30 days.
  • Plan credits arrive monthly and don't roll over. Upgrading from Starter to Pro is prorated.
  • Top-ups: $0.79 per credit, from 50 credits, with an active plan; valid for 3 months.
  • Prices exclude VAT. Plans and top-ups are on the MCP page; only a team admin can buy them, by card. For bank transfer or cancellation, email support@iqfluence.io.

Data and privacy

What the server receives. Only what your assistant sends when it calls a tool: the tool name and its arguments, such as search filters, creator usernames or profile links, hashtags, post links or a campaign ID. IQFluence does not receive your conversation, other messages or files; the assistant decides what goes into each call. When you connect, the assistant also registers its app name (for example “Claude”), which you see in the “MCP · Claude” key.

What is stored and for how long.

  • Paid requests (searches, unlocks, reports, contacts, overlaps, posts) are saved to your account's request history with their parameters, cost and time, the same way as website and API requests. We keep this history for billing, accounting and support.

  • Technical logs record each call's tool name, status, duration and assistant app; our internal API logs also record request addresses with their parameters. Technical logs are kept for up to 14 days.

  • Sign-in tokens are stored only as hashes. An access token is valid for 1 hour, a refresh token for 90 days.

  • Page cursors for posts and comments are kept for 24 hours.

Who else receives data.

  • Tool calls are processed on IQFluence infrastructure. We don't send them to AI models, don't use them to train models and don't share them with third parties for their own purposes.

  • Tool results go back to your assistant, so the company behind it (Anthropic, OpenAI, Cursor and others) processes them under its own terms.

  • Cards in the chat load creator photos from IQFluence's image service and, for YouTube creators, from YouTube's image servers.

  • Plans and top-ups are paid on the IQFluence website through Stripe; the assistant never sees payment details.

Where the data is hosted. The MCP server and its databases run in data centers in Germany (EU).

Revoking access and deleting data. Delete the “MCP · …” key in Profile → API keys: the assistant loses access at once and its sign-in tokens are deleted. To delete your account and its data, email legal@iqfluence.io from your account email.

IQFluence is operated by Ritmos Austeros – Unipessoal LDA, Lisbon, Portugal, and complies with GDPR. See the Privacy Policy and Terms of Service.

Limit or turn off access

After you connect, Profile → API keys shows a key named “MCP · assistant name”, for example “MCP · Claude”. It works only through the assistant. There you can set a daily credit limit for that assistant or delete the key to revoke access at once. Ask the assistant “how much have I spent today” to see this connection's spend and limit.

Troubleshooting

  • The assistant doesn't use IQFluence. Check that the connector is enabled in this chat, or say “using IQFluence…”. In ChatGPT, select @IQFluence.
  • “Data is being collected, ETA ~N min”. A fresh report is being prepared; no credits were charged. Try again later.
  • The overlap wasn't calculated. One of the creators has no audience data; no credits were charged.
  • “Your account changed”. You signed in or out of IQFluence during the connection. Start connecting again from the assistant.
  • The assistant stopped working with IQFluence. The “MCP · …” key may have been deleted. Connect again.
  • Credits ran out or access is paused. The assistant gives a link to the MCP page to buy a plan, top up or update the payment method.

Questions: support@iqfluence.io.