Build Relevance AI agents on live TikTok and Instagram data

Updated

Virlo is social listening for TikTok and Instagram Reels. A Relevance AI agent can follow detailed instructions and run tools, but no built-in tool tracks which TikToks and Reels are outperforming this week. Connect Virlo through the agent's Tools tab and it can pull hooks, trends to copy, sounds and outlier videos from a database of 23.1M viral videos whenever a task calls for it. Relevance AI is a platform for building AI agents and multi-agent workforces that use tools, follow core instructions and run on triggers.

  • Tools tab, Add MCP, Connect my own: Virlo tools load automatically
  • Recurring Schedule trigger for a weekly hook and trend report
  • Custom webhook trigger so Virlo events wake the agent

Part of Virlo's AI assistant guides. Comparing agent platforms? See Gumloop or CrewAI.

How do I connect Virlo to a Relevance AI agent?

Six steps in the Relevance AI agent builder, one of them optional. The agent ends up with Virlo's research tools next to whatever tools it already has.

  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: Make a Virlo API key

    In the Virlo developer dashboard, open API Keys and create one named after the agent. You will paste it as the bearer credential when Relevance AI asks for authentication.

  3. Step 3: Open the agent and choose Add MCP

    Open the agent in the builder, go to the Tools tab, click Add MCP and pick Connect my own instead of the Notion, Canva or Atlassian presets. Enter the server URL below, label the connection virlo and use your Virlo key in the authentication details, where it is sent as a bearer token.

    Server URL
    https://dev.virlo.ai/api/mcp/mcp
  4. Step 4: Name Virlo in the core instructions

    Relevance AI fetches the server's tools and tags each one "(MCP: virlo)". Tell the agent when to reach for them, so research questions go to Virlo rather than a web search.

    Core instructions
    When a task mentions TikTok, Instagram, trends, hooks, sounds or creators, use the (MCP: virlo) tools first and cite the example video link for every claim.
  5. Step 5: Optional: let Virlo wake the agent

    Add a custom webhook trigger to the agent, copy its unique URL, and register it with Virlo using the request below. Finished marketing agent runs and tracked outliers then start tasks by themselves.

    Register the webhook
    curl -X POST https://api.virlo.ai/v1/webhooks \
      -H "Authorization: Bearer virlo_tkn_YOUR_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "url": "YOUR_RELEVANCE_AI_WEBHOOK_URL",
        "description": "Relevance AI agent",
        "enabled_events": ["content_research_agent.run.completed", "tracking.outlier_video.detected"]
      }'
  6. Step 6: Start a task and ask

    Open a new task with the agent and send a real request. The conversation task view lists each Virlo tool the agent called.

    Your first prompt
    Which hook types are winning on Instagram Reels in [your niche] right now? Show 5 real hooks for each of the top 2 types and rewrite one of each for [your brand].

Tools not loading? Re-check the URL and key, confirm the Virlo tools appear in the Tools tab, and disconnect and reconnect the server if credentials changed.

MCP connection vs API Tool step vs triggers: which Relevance AI route should I use?

Relevance AI routeHow it uses VirloBest for
Add MCP, Connect my ownThe agent sees every Virlo research tool and chooses per taskOpen questions, briefs and scripts built from live data
API Tool step in a custom toolA tool you build that sends one GET to an api.virlo.ai/v1 endpoint with an Authorization headerA fixed lookup such as trending Reels sounds, with a predictable output
Recurring Schedule triggerStarts the agent on a cron in AWS EventBridge formatWeekly hook reports and Monday trend briefs
Custom webhook triggerGives the agent a URL that Virlo posts events to, wrapped in your message templateReacting to finished marketing agent runs and tracked outliers

One Virlo key can serve the MCP connection and any API Tool steps. Label several connections differently if you use more than one key.

Which hook types would a Relevance AI agent recommend for Reels?

Ask the agent which openings work on Instagram and it reads Virlo's hook snapshot: how often each hook type reaches a Virality Score of 18 or more on Reels, compared with TikTok.

In Virlo's snapshot of 264,108 hook-tagged Instagram videos, comparison hooks reached a Virality Score of 18 or more 19.0% of the time, the best rate on Instagram.

As of November 19, 2026

Which hook types would a Relevance AI agent recommend for Reels?
Hook typeInstagram: share at 18+TikTok: share at 18+Instagram videos
Comparison19.0%29.8%2,947
POV setup18.1%32.9%8,409
Shock statement16.8%31.8%12,033
Trend reference15.3%30.3%1,106
Relatable scenario15.3%31.2%19,312
Before and after14.6%28.6%1,892

Hook types by niche, with the Reels behind them

Split by 20+ niches, with every hook and video behind each number, in the Virlo app.

Open hooks in Virlo

How this sample is made

Source
Virlo's daily hook snapshot: 264,108 Instagram and 1,365,774 TikTok 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. Sorted by the Instagram rate.
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, “Build Relevance AI agents on live TikTok and Instagram data”, virlo.ai/relevance-ai

How do I run a Relevance AI agent on Virlo data without starting each task?

Relevance AI triggers start tasks for you, and each trigger runs independently, so one agent can carry a schedule and a webhook at once.

  • Recurring Schedule: open the agent's Triggers section, choose Recurring Schedule and pick a time; advanced users can write a 6-field cron such as 0 8 ? * MON * for Mondays at 08:00 UTC.
  • Custom webhook: in the agent's trigger settings, copy its unique webhook URL and set the message template the agent receives with each delivery.
  • Register that URL with Virlo using the request in the table, choosing the events this agent should hear.
  • Use Pause all in the Triggers section while you edit the instructions, then Resume all.
Register the Relevance AI webhook with Virlo
Part of the requestValue
EndpointPOST https://api.virlo.ai/v1/webhooks
HeaderAuthorization: Bearer virlo_tkn_...
urlThe custom webhook URL copied from the agent
enabled_eventscontent_research_agent.run.completed and tracking.outlier_video.detected

Setup step 5 has the same request as a ready-to-run curl command.

What can a Relevance AI agent do with Virlo?

Task prompts and trigger templates. Swap each bracket for your own details.

  • Reels hook report

    Find the hook types with the highest share of Reels at a Virality Score of 18+ in [your niche], with 3 example hooks and links for each.

  • Trend brief (schedule)

    Every Monday: list this week's 5 trends to copy for [your niche] with the part to keep, the part to swap and an example video, then email it to [address].

  • Outlier analysis (webhook)

    Virlo sent this tracking event: {{payload}}. Read the video's hook and transcript with Virlo and explain in 3 bullets why it beat the creator's usual views.

  • Sound picks

    Which TikTok and Reels sounds are breaking out this week? Pick 2 per platform for a [tone] video about [topic].

  • Competitor breakdown

    Size up @[competitor] across TikTok and Instagram. Which recent videos outperformed, which hooks did they use, and what should [your brand] test next?

  • Creator scouting

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

  • Script writer

    Take the transcript of [TikTok link] from Virlo and write a 30-second script for [your product] that follows the same beats.

Relevance AI MCP client vs Relevance AI MCP server: which one adds Virlo?

Relevance AI documents MCP in both directions. Virlo uses the client side.

MCP client in the agent builder (this page)

Add MCP in an agent's Tools tab brings an outside server like Virlo into that agent.

Relevance AI MCP server

A server at mcp.relevanceai.com that lets Claude, Cursor or ChatGPT use your Relevance AI agents and tools. It points the other way.

Workforces

Several Relevance AI agents passing work between each other. Give Virlo to the research agent and let the others write and send.

CrewAI

An open-source framework for multi-agent crews in Python. The CrewAI guide shows how its agents reach Virlo.

What are the limits?

  • Virlo is read-only research on public TikTok and Instagram data; an agent can analyse and write with it, not publish through it.
  • Relevance AI connects to remote servers that speak Streamable HTTP, which is the transport Virlo's MCP server uses, so there is nothing to host yourself.
  • Scheduled triggers use AWS EventBridge cron with six fields; a five-field cron copied from elsewhere will be rejected.
  • A Virlo team can have 5 webhooks switched on at once, so send several event types to one agent webhook when you can.
  • See Virlo plans on pricing.

Frequently asked questions

How do I connect an MCP server to a Relevance AI agent?

Open the agent, go to the Tools tab and click Add MCP. Choose Connect my own, enter the server URL (for Virlo, https://dev.virlo.ai/api/mcp/mcp), give the connection a label and fill in the authentication. The agent fetches the server's tools straight away.

Does Relevance AI support MCP?

Yes. Agents can connect to any remote MCP server that supports Streamable HTTP, with presets for services like Notion and a custom option for the rest. Relevance AI also runs its own MCP server so outside assistants can call your agents.

Can a Relevance AI agent get TikTok data?

Yes, with Virlo connected. It can pull TikTok trends to copy, viral videos ranked by Virality Score, hooks and hook types, sounds, hashtags, creator lookups and transcripts, and use them in any task or workforce step. Mention Virlo in the core instructions so the agent knows when to use it.

Can Relevance AI analyse Instagram Reels hooks?

Yes. Through Virlo the agent can see which hook types reach a strong Virality Score most often on Reels, pull real hooks with links, rank Reels on a topic and list trending Reels sounds, then rewrite the best hooks for your brand.

How do I schedule a Relevance AI agent?

Open the agent's Triggers section and choose Recurring Schedule. Pick a time or write a cron expression in AWS EventBridge format, which needs six fields. Changes take effect immediately, and the agent runs its task, Virlo tools included, on that schedule.

Can Virlo trigger a Relevance AI agent?

Yes. Copy the agent's custom webhook URL from its trigger settings and register it with Virlo using POST /v1/webhooks, listing events such as content_research_agent.run.completed. Each event starts a task with the payload inside your message template. Several event types can share one agent webhook.

Should I use Add MCP or an API Tool step?

Use Add MCP when the agent should choose Virlo tools from a plain-English task. Build an API Tool step when you want one fixed request, such as trending Reels sounds, with a predictable output. Many agents use both. Both can use the same Virlo key.

Is Relevance AI like Gumloop?

Both are agent platforms that accept remote MCP servers. Relevance AI leans on tools, core instructions and multi-agent workforces; Gumloop on connectors, triggers and node-based workflows. The Gumloop guide covers adding Virlo there. In either product the Virlo connection takes a single URL and a sign-in, so the research side works the same whichever builder you choose.

Can Relevance AI post to TikTok through Virlo?

No. Virlo stays read-only: it studies public TikTok and Instagram videos without ever holding a login. A Relevance AI agent can pass its research to a publishing tool you already use. In a workforce, give Virlo to the research agent and let a later agent hand finished scripts and captions to the publishing tool your team already runs.

Give your Relevance AI agents a social media brain

Connect Virlo in the Tools tab and ask which hooks are winning on Reels this week.