Skip to main content

Automating Hubfluence with AI: The MCP Integration Guide

Connect Hubfluence to Claude or Codex and run your whole creator program with plain-English commands. What the MCP integration does, all the tools, setup steps, and safety.

Written by Michael Tona

What this is, in plain English

Hubfluence has an MCP integration. MCP (Model Context Protocol) is just a standard way to plug Hubfluence directly into an AI assistant like Claude or OpenAI's Codex. Once it's connected, you talk to your assistant in normal language and it runs Hubfluence for you.

Instead of clicking through the app, you type things like "Build me a list of skincare creators doing over $10k a month, then start an outreach sequence with the sample offer." The assistant does it, using the same Hubfluence account you already log into. No code. No spreadsheets. You describe the outcome, it handles the steps.

Think of it as a teammate who knows every corner of Hubfluence and never gets tired of repetitive setup.

What you can actually do with it

There are 64 tools available through the integration. That sounds like a lot, but they group into a handful of jobs you already understand: finding creators, building lists and Segments, running outreach, sending emails, managing samples, and pulling reports. You never memorize the tool names. You just ask, and the assistant picks the right ones.

A few real examples:

  • "Find 50 beauty creators with engaged audiences and put them in a new list called Q3 Beauty." It searches, filters, creates the list, and fills it.

  • "Start a DM sequence to everyone in that list offering a free sample, and follow up twice if they don't reply." It builds and launches the outreach.

  • "Which creators drove the most GMV last month, and which ones went quiet?" It pulls the numbers and writes you a summary.

  • "What's selling on TikTok Shop in the supplements category right now?" It runs Social Intelligence research and reports back.

A note on Read vs Write vs Destructive

Every tool is one of three types, and it's worth knowing the difference before you start:

  • Read tools only look things up. They pull reports, search creators, list your data. They never change anything. Totally safe to run any time.

  • Write tools create or update things: a new list, a new sequence, an added creator. These take action in your account.

  • Destructive tools delete or remove things: deleting a list, removing a creator, archiving a sequence. These can't always be undone, so the assistant will confirm with you first.

Of the 64 tools: 34 are read-only, 30 make changes, and 9 of those are destructive (delete or remove). The breakdown below labels each group so you always know what you're dealing with.

The full toolset, grouped by job

Analytics and reporting (7 tools, all Read)

Pull performance numbers without touching anything. GMV by creator, message volume, sample status, sequence health, top performers, and trends over time. This is where "give me a weekly recap" comes from.

Creator and market search (11 tools, all Read)

The research layer. Search the creator database with Smart Targeting Filters, look up individual creator profiles, and run Social Intelligence to see what's trending: top products, top brands, top categories on TikTok Shop right now. Pure lookups, so nothing changes in your account.

Creator Lists (8 tools, Read + Write + Destructive)

Create lists, add and remove creators, rename them, and look up what's inside. Use these to organize creators into groups you'll act on later (for example, "high performers" or "needs a follow-up"). Deleting a list or removing creators is the destructive part.

Segments (8 tools, Read + Write + Destructive)

Segments are smart, rule-based groups (for example, "everyone who drove over $5k last month"). These tools build, update, read, and delete Segments so you can target the right creators automatically instead of hand-picking them.

Outreach and direct messages (13 tools, Read + Write + Destructive)

The biggest group. Build and launch DM outreach sequences, add creators to them, set follow-ups, check status, pause, and remove. This is your bread-and-butter creator recruitment, run by plain-English instructions instead of manual setup.

Multi-channel sequences (1 tool, Write)

One tool that combines DM and email outreach into a single coordinated sequence, so a creator gets the right touch on the right channel without you wiring it up by hand.

Email outreach (8 tools, Read + Write + Destructive)

Create and run email sequences, add recipients, track sends and replies, and manage the flow. Same idea as DM outreach, on the email channel.

Samples and AI auto-approval rules (7 tools, Read + Write + Destructive)

Review sample requests, approve or decline, and set up auto-approval rules so the AI handles routine sample requests for you based on your criteria. Frees you from approving every single request by hand.

Email accounts (1 tool, Read)

Look up which sending email accounts are connected, so your email outreach goes out from the right address.

One-click workflows (recipes)

On top of the individual tools, there are four ready-made workflows. Each one chains several tools together for a common job, so you can ask for the whole thing in one line:

  • Weekly recap - a full summary of the week: GMV, outreach sent, replies, samples, and who's trending up or down.

  • Dormant creators - finds creators who went quiet so you can re-engage them before they churn.

  • Sample ROI review - shows which sample spend actually turned into sales, so you stop sending freebies that don't convert.

  • Outreach health check - audits your live sequences for problems (paused sends, low reply rates, quota limits) so nothing silently stalls.

Who this helps, and how

Solo founder. You're doing everything yourself. Use it as your operations team: "Find me 30 creators in my category, start outreach with a sample offer, and send me a recap every Friday." You set it up once and check the summaries.

Campaign manager. You're running daily creator ops. Use it to move faster: build Segments on the fly, launch follow-up sequences to non-repliers, and pull instant performance reports without leaving your chat window.

Agency or multi-brand operator. You're juggling several shops. Use it to standardize: run the same weekly recap and outreach health check across every brand, and spin up new lists and sequences for a new client in minutes.

How to connect it

You connect once, then it stays linked. You'll need your Hubfluence MCP access token (it starts with hubf_) from your Hubfluence account settings. The connection endpoint is https://api.hubfluence.io/mcp. Here's the setup for each assistant:

Assistant

How to connect

Claude (paid web/desktop plan)

Open Settings, go to Connectors, and add a custom connector. Paste the endpoint https://api.hubfluence.io/mcp and your hubf_ token when prompted.

Claude Desktop app

In Settings, open the Developer or Connectors section, add the Hubfluence MCP server with the same endpoint and token, then restart the app.

Claude Code (command line)

Run the add-connector command pointing at https://api.hubfluence.io/mcp and provide your hubf_ token as the bearer token. It connects on the next session.

OpenAI Codex CLI

Add Hubfluence as an MCP server in your Codex config with the endpoint https://api.hubfluence.io/mcp and your hubf_ token, then start a new session.

If you get stuck on setup, our team can walk you through it in Discord.

Safety and guardrails

A few things are built in so the integration stays trustworthy:

  • It uses your account, with your permissions. The assistant can only do what your Hubfluence login can already do. Nothing more.

  • Destructive actions ask first. Anything that deletes or removes will confirm with you before it runs.

  • Sending respects TikTok Shop limits. Outreach still obeys your daily invite quota. The assistant can't blast past the platform's caps.

  • You can read before you write. A safe habit is to ask it to show you the plan or the list first, then tell it to go.

Current limits

  • The integration controls Hubfluence features. It doesn't post to TikTok directly or move money.

  • Outreach volume is capped by your TikTok Shop invite quota, same as in the app.

  • The assistant works from the data in your connected shops. If a shop isn't connected in Hubfluence, it can't see it.

In-app vs the MCP integration

In the Hubfluence app

Through the MCP integration

How you work

Click through screens

Type plain-English requests

Best for

Hands-on review, visual dashboards

Fast setup, bulk actions, recaps

Reports

You read the dashboard

The assistant writes you a summary

Repetitive tasks

Done manually each time

Described once, run on demand

It's not either/or. Most operators use the app for review and the integration for speed.

FAQ

Do I need to know how to code? No. You talk to the assistant in normal sentences.

Is my data safe? The integration uses your own access token and your own permissions. It can't do anything you couldn't already do in the app, and destructive actions confirm first.

Which plan do I need? The MCP integration is available on the Business plan and above.

Can it delete things by accident? Destructive actions always ask for confirmation before running, so accidental deletes are very unlikely.

What if I get stuck? Join our Discord or email support@hubfluence.io and we'll help you get connected.

Did this answer your question?