Flowise MCP: research TikTok and Instagram from a Flowise agent

Updated

Virlo is social listening for TikTok and Instagram Reels. Flowise agents can call tools, read documents and hold a conversation, but no Flowise node tells them which TikTok or Instagram videos are breaking out. Paste Virlo's server into a Custom MCP tool and your Agentflow can pull hooks, trends to copy, sounds and outlier videos from a database of 23.1M viral videos. Flowise is an open-source, drag-and-drop builder for AI agents and LLM flows that runs in the cloud or on your own server.

  • One Custom MCP tool, one JSON block
  • Key kept in a Flowise variable, not in the flow
  • Refresh Available Actions to pick exactly which Virlo tools the agent sees

Part of Virlo's AI assistant guides. Coding the agent instead of drawing it? See LangChain. Using another canvas? See Dify.

How do I add Virlo as a Custom MCP tool in Flowise?

Five steps in the Flowise UI. You store the key as a variable, then point a Custom MCP tool at Virlo from inside an Agentflow.

  1. Step 1: Create your Virlo account for free

    Create your free Virlo account in under a minute. Already signed up? Open API Keys.
  2. Step 2: Save your Virlo key as a Flowise variable

    Create a key in the Virlo developer dashboard, then open Variables in Flowise and add one called virloKey holding that value. Flows read it at run time, so the key never sits in an exported flow.

  3. Step 3: Add a Custom MCP tool to the Agent node

    Open or create an Agentflow, select the Agent node and add a new tool of type Custom MCP. Paste this into its MCP Server Config field; the double curly braces pull in the variable you just saved.

    MCP Server Config
    {
      "url": "https://dev.virlo.ai/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer {{$vars.virloKey}}"
      }
    }
  4. Step 4: Refresh Available Actions

    Click refresh next to Available Actions and Flowise lists every Virlo research tool. Leave them all on for an open-ended assistant, or tick only the ones a narrow flow needs, such as trends and sounds.

  5. Step 5: Test it in the chat panel

    Save the flow and open the chat bubble. The agent shows which Virlo action it ran before answering.

    Your first prompt
    Use Virlo to show me 10 hooks from TikTok videos in [your niche] that beat their creator's usual views this month, grouped by hook type.

Embed the finished flow on a page or call it through the Flowise prediction API, and every caller gets live Virlo research without seeing your key.

Custom MCP vs Custom Tool vs API call: how should Flowise reach Virlo?

Flowise routeWhat you configureBest for
Custom MCP tool (Agent node)A JSON block with Virlo's url and an Authorization header from $varsAgents that pick the right research tool for each question
Custom Tool with JavaScriptA function that calls https://api.virlo.ai/v1/... with fetch and returns the JSONOne fixed lookup, such as content trends for a dashboard flow
HTTP node in AgentflowMethod, URL and a bearer header for a single Virlo endpointDeterministic steps before or after the agent
Selected Available ActionsTicks next to the Virlo actions you want exposedKeeping a support-style bot on a short leash

The Custom MCP route gives the agent every Virlo tool you allow; the other two are single calls you wire by hand.

Flowise on its own vs Flowise with Virlo: what does the agent know?

QuestionFlowise aloneFlowise with Virlo
Which hook type is winning on Instagram?An opinion drawn from training dataHook types ranked by how often they reach a Virality Score of 18 or more
Give me a format to copy this weekA guessTrends to copy with the part to keep and the part to make yours
Why did [TikTok link] take off?Only the caption, if you paste itHook, on-screen text, transcript and how far it beat the creator's baseline
Find creators for a campaignWell-known namesSmaller creators whose videos keep outperforming their follower count

Which hook types would a Flowise agent rank first today?

Hooks are the most common thing people ask a Flowise research bot about. Here is the live table Virlo returns: hook types ranked by how often they push a TikTok video into the strong Virality Score band.

In Virlo's snapshot of 1,365,774 hook-tagged TikTok videos, POV setup hooks reached a Virality Score of 18 or more 32.9% of the time, against 18.1% on Instagram.

As of November 19, 2026

Which hook types would a Flowise agent rank first today?
Hook typeTikTok: share at 18+Instagram: share at 18+TikTok videos
POV setup32.9%18.1%49,587
Shock statement31.8%16.8%70,816
Relatable scenario31.2%15.3%84,123
Trend reference30.3%15.3%6,884
Comparison29.8%19.0%13,443
Before and after28.6%14.6%9,249

Hook types by niche, with every hook behind them

Split by 20+ niches, with the hooks and videos behind each number, in the Virlo app.

Open hooks in Virlo

How this sample is made

Source
Virlo's daily hook snapshot: 1,365,774 TikTok and 264,108 Instagram videos whose opening hook was tagged by type.
Window
All tagged videos in the snapshot. Hook types with fewer than 1,000 videos on either platform, and videos with no hook, are left out.
Method
Share at 18+ = the share of videos with that hook type whose Virality Score is 18 or more, the "strong" band. Virality Score measures how far a video beat its creator's usual views.
As of
November 19, 2026. Rebuilt every day.
Made by
Numbers are pulled automatically from Virlo's data; the text around them is written by the Virlo team.

Suggested citation: Source: Virlo, “Flowise MCP: research TikTok and Instagram from a Flowise agent”, virlo.ai/flowise

How do I build a hook research chatbot in Flowise?

A small Agentflow turns Virlo into a hook assistant your whole team can open from a link. A layout that holds up in daily use:

  • Start node with a chat input, so teammates type a topic or paste a video link.
  • Agent node with your chat model, the Virlo Custom MCP tool, and a system message that asks for hooks with sources.
  • Condition node that checks whether the user pasted a link; if so, steer the agent to the transcript and video lookup.
  • A second LLM node that rewrites the best five hooks in your brand voice, kept short for on-screen text.
  • Turn on conversation memory so a follow-up such as "now do it for Instagram" keeps the topic.

Hook types come straight from Virlo's tagging of each video's opening line, so the bot can say which hook family wins, not just which words were used.

Which Flowise setup choices matter for a team?

Variables are shared across a Flowise instance, so one virloKey serves every flow that references it. Rotate the key in the Virlo dashboard and update the variable once; no flow needs re-editing.

Exported Agentflow JSON keeps the template text, not the secret. Importing it into staging or another instance only requires the same variable name to exist there.

On self-hosted Flowise, make sure outbound HTTPS to dev.virlo.ai is allowed. Docker installs need no extra image for Virlo, because the server is remote rather than a local process.

What can I ask a Flowise agent connected to Virlo?

Use these as chat messages or as the Agent node instruction. Replace each bracket.

  • Hook families

    Which hook types reach a Virality Score of 18 or more most often on TikTok and on Instagram? Show both rates side by side.

  • Paste-a-link teardown

    Break down [TikTok link]: spoken hook, on-screen text, format, and how far it beat the creator's usual views. Then suggest one version for [your brand].

  • Trend to brief

    Pick the two trends to copy with the most creators in [your niche] this week and write a one-paragraph brief for each.

  • Reels audio

    List the Instagram Reels sounds breaking out right now and flag the two that fit a [tone] product demo.

  • Lead magnet research

    Find 20 outlier videos about [topic] from the last 30 days and turn their hooks into a swipe file I can share with [audience].

  • Creator shortlist

    Find 8 TikTok creators in [your niche] under [N] followers whose videos regularly beat their follower count, with one standout video each.

  • Weekly hashtag check

    Which hashtags in [your niche] gained the most TikTok videos this week, and which ones are fading?

  • Embed widget answer

    You answer visitors on our site. When asked what to post about [topic], suggest two trends to copy from Virlo with one example video each, in under 80 words.

Flowise vs Dify vs LangChain: which guide do I need?

These three overlap in name and purpose. Pick the guide for the way you build.

Flowise (this page)

A visual builder with Chatflow and Agentflow canvases. Virlo enters through a Custom MCP tool on the Agent node.

Dify

An LLM app platform where MCP servers are workspace tool providers. Virlo is added once in the MCP tab and shared by every app.

LangChain

The Python and TypeScript framework many visual builders borrow from. You connect Virlo in code with the LangChain MCP adapter.

What are the limits?

  • The Flowise agent can only read through Virlo: public TikTok and Instagram data, no posting, no account logins.
  • The Custom MCP tool uses the bearer key from your variable; keep that variable restricted to people who manage flows.
  • If Available Actions stays empty, the URL or header is wrong; fix the JSON and refresh again.
  • Trend lists refresh hourly after a team check; hook-type rankings rebuild daily.
  • For what each Virlo plan includes, see pricing.

Frequently asked questions

How do I add an MCP server to Flowise?

Open an Agentflow, select the Agent node and add a Custom MCP tool. In MCP Server Config, paste JSON with the server url and any headers, then refresh Available Actions. For Virlo, use the dev.virlo.ai MCP URL and an Authorization header that reads your key from a Flowise variable.

Does Flowise support remote MCP servers?

Yes. The Custom MCP tool accepts Streamable HTTP servers configured with a url and headers, alongside local command-based servers. Virlo is a hosted Streamable HTTP server, so there is nothing to install or run next to your Flowise instance, and the same JSON works on Flowise Cloud, a Docker container or a bare Node install.

How do I use variables in the Flowise MCP Server Config?

Create the variable under Variables in Flowise, then reference it inside the JSON with double curly braces and the $vars prefix, for example {{$vars.virloKey}}. Flowise substitutes the value when the flow runs, so exported flows stay free of secrets. Use the same pattern for any other header Virlo or another server needs, keeping one variable per secret.

Can a Flowise AI agent get TikTok data?

Yes, once Virlo is attached. The agent can request trends to copy, outlier TikTok videos ranked by Virality Score, trending and breakout sounds, hashtags, creator lookups and transcripts, and answer in the chat with links to each source video. Follow-up questions keep the topic when conversation memory is on, so a user can drill from a trend into its top creators.

Why is Available Actions empty after I paste the config?

Flowise only lists actions after a successful connection. Check that the JSON is valid, that the url matches the Virlo MCP address exactly, and that the variable name inside $vars matches the one you saved, including capitals. Then press refresh again. A key copied with a trailing space is another common cause, so paste it fresh into the variable if the list stays blank.

Can I use Virlo in a Flowise Chatflow instead of an Agentflow?

The documented Custom MCP route sits on the Agentflow Agent node, which is where tool-calling agents live in current Flowise. For a fixed lookup inside a Chatflow, a Custom Tool that calls the Virlo REST API with fetch does the same job.

Can Flowise research Instagram trends with Virlo?

Yes. The agent can pull Instagram Reels on a topic ranked by Virality Score, trending and breakout Reels sounds, hook types and creator lookups. TikTok adds full transcripts on top of the same data. Ask for both platforms in one message and the agent returns a side-by-side answer, which is handy when a format is taking off on one app before the other.

Can a Flowise flow publish videos through Virlo?

No. Virlo is a read-only research source for public TikTok and Instagram videos. Flowise can turn its findings into scripts, briefs or messages, and you post through your usual tools. An HTTP node at the end of the flow can still hand the finished brief to a scheduler or a chat channel for a human to approve.

Is Flowise or Dify better for a Virlo research bot?

Both reach the same Virlo server. Flowise suits teams who like wiring an Agentflow node by node and storing secrets as variables; Dify suits teams who want MCP servers managed once per workspace and shared across apps. The Dify guide shows its MCP tab step by step.

Give your Flowise agent a social media brain

One Custom MCP tool and a variable connect Virlo to every Agentflow you build.