Connect Hermes Agent to live TikTok and Instagram data

Updated

Virlo is social listening for TikTok and Instagram Reels. Hermes Agent can run tools, cron jobs and skills on your own machine, but nothing in it reports which TikTok or Instagram videos are breaking out. Register Virlo as an MCP server and Hermes can pull trends, hooks, sounds and outliers from a database of 23.1M viral videos into any chat it answers. Hermes Agent is an open-source, MIT-licensed AI agent from Nous Research that runs on your machine or server and talks to you through the CLI or messaging gateways such as Telegram, Discord and Slack.

  • One hermes mcp add command with OAuth sign-in
  • Ask from the CLI, Telegram, Discord or Slack
  • Schedule research with Hermes cron jobs

Part of Virlo's AI assistant guides. Running a different self-hosted agent? See OpenClaw. Want the server details for any MCP client? See the MCP server guide.

How do I add Virlo to Hermes Agent?

Hermes keeps MCP servers in ~/.hermes/config.yaml. The CLI writes that entry for you and runs the Virlo sign-in.

  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: Register the Virlo server

    On the machine where Hermes runs, add Virlo as a remote MCP server. Hermes probes the server, finds its tools and saves the entry under mcp_servers in your config.

    Terminal
    hermes mcp add virlo --url https://dev.virlo.ai/api/mcp/mcp --auth oauth
  3. Step 3: Run the OAuth login

    Start the Virlo sign-in from a fresh terminal so the browser callback can reach Hermes, then approve access on the Virlo page. Hermes caches the token itself, so the config file never holds a secret.

    Terminal
    hermes mcp login virlo
  4. Step 4: Check the connection and reload

    Test the server, then run /reload-mcp inside any open Hermes session. Virlo's research tools now show up with the mcp_virlo_ prefix.

    Terminal
    hermes mcp test virlo
  5. Step 5: Ask Hermes from any channel

    Message Hermes on the CLI or in the Telegram, Discord or Slack chat you linked through its gateway, and name Virlo in the request the first time.

    Your first prompt
    Use Virlo to find the 5 TikTok videos in [your niche] with the highest Virality Score this week. For each, give me the hook, the format and why it beat the creator's usual views.

Prefer a key over OAuth on a shared server? Put the YAML below under mcp_servers in ~/.hermes/config.yaml, export VIRLO_API_KEY with a key from your Virlo developer dashboard, and run /reload-mcp.

OAuth, API key header or skill: which Hermes route fits?

RouteWhat goes in HermesCredentialBest for
MCP with OAuthhermes mcp add virlo --url https://dev.virlo.ai/api/mcp/mcp --auth oauthToken cached by Hermes after hermes mcp login virloYour own laptop or a server you can open a terminal on
MCP with a headerurl plus headers under mcp_servers.virlo in ~/.hermes/config.yamlAuthorization: Bearer with a virlo_tkn_ key from an environment variableDocker, VPS and gateway installs that restart without you
Virlo skillsnpx skills add Virlo-AI/Virlo-Agent-PluginUses the MCP server aboveTeaching Hermes when to pick each research tool and how to rank results
Virlo CLI in the terminal toolnpm install -g virlo-cli, then virlo setupKey saved to ~/.virlo/config.jsonCron jobs that should return plain JSON with --json

All four reach the same Virlo account. Most people start with OAuth and add the header route when Hermes moves to a server.

Which TikTok sounds would Hermes flag as breaking out today?

A Hermes cron job pointed at Virlo can send this to your Telegram before lunch: the TikTok sounds whose use jumped the most against the previous week, with the counts behind them.

In Virlo's data, "original sound - Hani" is the fastest-rising sound on TikTok: 236 TikTok videos used it in the last 7 days, against about 7 a week before, as of November 19, 2026.

As of November 19, 2026 at 12:03 UTC

Which TikTok sounds would Hermes flag as breaking out today?
SoundArtistTikTok videos (7 days)Usual week before
Cover art for original sound - Hanioriginal sound - HaniHani2367
ICKYSTICKY1.5MUTAYDOESNTGATEKEEP2179
original sound - thanks.forthemusicpor um propósito1769
Cover art for original soundoriginal soundRaven17821
Cover art for oryginalny dźwiękoryginalny dźwiękDavidBeSlime🌍17850

See all 300 breakout sounds on TikTok

Usage history and the TikTok videos behind every sound are in the Virlo app.

Open sounds in Virlo

How this sample is made

Source
Virlo's sound rankings for TikTok, built from the TikTok videos Virlo collects.
Window
TikTok videos posted in the last 7 days that Virlo collected. Counts are TikTok videos in Virlo's data, not every video on the platform.
Method
Ranked by breakout score: use in the last 7 days against the sound's usual weekly use before that, so a sound rising from a small base ranks above an old hit.
As of
November 19, 2026 at 12:03 UTC. 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, “Connect Hermes Agent to live TikTok and Instagram data”, virlo.ai/hermes-agent

How do I schedule Virlo research with Hermes cron?

Hermes ships with a scheduler that takes a prompt and a timing, runs the job unattended and delivers the result to the gateway you choose. Pair it with Virlo and the agent does your Monday research before you are awake.

A practical weekly loop for a marketer running Hermes on a small VPS:

  • Set up a job for weekdays at 8am that asks Virlo for breakout TikTok sounds in your niche and posts the top five to your Telegram chat.
  • Add a Monday job that pulls this week's trends to copy and writes them to ~/research/trends.md on the server.
  • Attach the short-form-trend-research skill to the Monday job with --skill so the output arrives as a content plan, not a raw list.
  • Give a Friday job the competitor handles you track and ask for any video of theirs that scored 18 or more on Virality Score.
  • Route the Friday digest to Slack so the whole team sees it, and keep the daily sound alert in your private Telegram.

Use the header route for cron jobs on servers. OAuth tokens refresh on their own, but a header-based entry has nothing that can wait on a browser.

What does the Hermes config for Virlo look like?

Hermes treats any entry with a url as a Streamable HTTP server, so there is no transport key to set. Each Virlo tool is registered as mcp_virlo_<tool> to keep it apart from Hermes's built-in tools.

Virlo entry in ~/.hermes/config.yaml
KeyValueWhy
mcp_servers.virlo.urlhttps://dev.virlo.ai/api/mcp/mcpVirlo's hosted server over Streamable HTTP
auth: oauthSet by --auth oauthHermes handles discovery, client registration, PKCE and refresh
headers.AuthorizationBearer ${VIRLO_API_KEY}The key route; Virlo keys start with virlo_tkn_
tools.includeOptional list of tool namesLimit Hermes to the research tools a profile needs

The full header version of the entry: mcp_servers: virlo: url: "https://dev.virlo.ai/api/mcp/mcp" headers: Authorization: "Bearer ${VIRLO_API_KEY}"

What can I ask Hermes Agent once Virlo is connected?

Send these from the CLI or any gateway chat. Swap the brackets for your details.

  • Morning sound alert

    Every weekday at [time], use Virlo to list the breakout TikTok sounds in [your niche] and send the top 5 to this chat.

  • Trend file

    Pull this week's trends to copy for [your niche] from Virlo and save them to ~/research/trends-[date].md with the part to keep and an example video.

  • Video teardown

    Look up [TikTok link] with Virlo. Give me the spoken hook, the on-screen text, the transcript and how far it beat the creator's usual views.

  • Competitor sweep

    Check @[competitor] on TikTok and Instagram with Virlo and tell me which of their recent videos are outliers and what they share.

  • Hook bank

    Collect 25 hooks from the highest Virality Score videos in [your niche] this month, grouped by hook type, and append them to ~/research/hooks.md.

  • Reels sounds

    Which sounds are trending on Instagram Reels this week? Pick three that suit a [tone] video for [your brand].

  • Team digest

    Every Friday, summarise what moved in [your niche] on TikTok and Instagram this week and post it to the #[channel] Slack channel.

  • Creator list

    Find 10 creators under [N] followers in [your niche] whose videos keep beating their follower count and save them as creators.csv.

Hermes Agent vs Nous Hermes models vs OpenClaw: which is this page about?

The Hermes name covers both an agent and a family of models, and Hermes Agent is often compared with OpenClaw.

Hermes Agent (this page)

The open-source agent from Nous Research that runs on your machine, talks through the CLI and messaging gateways, and adds Virlo with hermes mcp add.

Nous Hermes models

The Hermes language models from Nous Research. A model alone has no tools; it reaches Virlo only when an agent such as Hermes Agent runs it with the Virlo server attached.

OpenClaw

Another self-hosted agent you chat with from messaging apps. It connects to the same Virlo server with its own config.

What are the limits?

  • Hermes gets research, never publishing: Virlo reads public TikTok and Instagram data and holds no social logins, so no gateway can post through it.
  • MCP servers load from ~/.hermes/config.yaml per profile. After editing it, run /reload-mcp or restart the gateway.
  • Keep the key out of the YAML itself: reference ${VIRLO_API_KEY} and set the variable in the service environment.
  • TikTok videos come with transcripts; Instagram Reels return hooks, formats and view numbers. Trends to copy refresh hourly.
  • See pricing for what each Virlo plan covers.

Frequently asked questions

How do I add an MCP server to Hermes Agent?

Use hermes mcp add with a name and a URL. For Virlo that is hermes mcp add virlo --url https://dev.virlo.ai/api/mcp/mcp --auth oauth. Hermes saves it under mcp_servers in ~/.hermes/config.yaml. Then run hermes mcp login virlo to sign in and /reload-mcp inside a session to load the tools.

What is Hermes Agent?

Hermes Agent is an open-source AI agent from Nous Research, released under the MIT license. It runs on your own computer or server, uses tools, skills and MCP servers, schedules jobs with cron, and answers you from the CLI or messaging apps such as Telegram, Discord and Slack.

Does Hermes Agent support OAuth for MCP?

Yes. Set auth: oauth on an HTTP server entry, or pass --auth oauth to hermes mcp add, and Hermes handles discovery, client registration, PKCE and token refresh. Virlo supports all of that, so hermes mcp login virlo is the only step.

How do I install skills in Hermes Agent?

Hermes has a hermes skills command for browsing and installing skills from a hub or a SKILL.md URL. For Virlo, npx skills add Virlo-AI/Virlo-Agent-Plugin adds two skills that teach an agent which research tool to call and how to rank results by Virality Score.

Can Hermes Agent check TikTok trends on a schedule?

Yes. Add a Hermes cron job with a prompt that names Virlo, for example a weekday 8am request for breakout TikTok sounds, and choose the gateway that should receive it. The job runs unattended and posts the answer to that chat.

Where is the Hermes Agent MCP config file?

In ~/.hermes/config.yaml, under the mcp_servers key. Each server gets a name, a url for remote servers, and either auth: oauth or a headers map. OAuth tokens are cached separately by Hermes, so the file itself can stay free of secrets and be copied between profiles or kept in a private dotfiles repo.

Can Hermes Agent post to TikTok through Virlo?

No. Virlo is a read-only research source built on public TikTok and Instagram data, and it never holds your social logins. Hermes can rank, summarise and write from it, then deliver the result to Telegram, Discord or Slack, but publishing stays with you or the scheduler your team already runs.

Is Hermes Agent the same as OpenClaw?

No. Both are self-hosted agents you message from chat apps, but they are separate open-source projects with their own config formats, skill systems and gateways. Hermes keeps MCP servers in ~/.hermes/config.yaml. Each one can use Virlo, and the OpenClaw guide covers its setup step by step.

Put Virlo behind every Hermes chat

Register the server once and ask Hermes for TikTok and Instagram research from wherever you message it.