Use Grok Build to research TikTok and Instagram

Updated

Virlo is social listening for TikTok and Instagram Reels. Grok Build, xAI's coding agent and the grok CLI, has no view of what's taking off on social media by default. One grok mcp add command connects it to Virlo, and Grok can then search a database of 23.1M viral videos for trends, sounds, hooks and outliers, and write the findings into your project.

  • One command, then a browser sign-in
  • Shared with your repo through project scope
  • Read-only: research and scripts, never posting

Part of Virlo's AI assistant guides. Using Grok's always-on bots instead? See Grok Bot. Prefer Anthropic's terminal agent? See Claude Code.

How do I add Virlo to Grok Build?

Four commands in your terminal and one sign-in. You need Grok Build installed and a Virlo account.

  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

    Run this in your terminal. Add --scope project to save it in .grok/config.toml so everyone working in the repo gets Virlo too.

    Terminal
    grok mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp
  3. Step 3: Sign in to Virlo

    Start grok, run /mcps, select virlo and press i. Your browser opens the Virlo sign-in page; approve it and the server shows as ready. No key to paste.

    Inside Grok Build
    /mcps
  4. Step 4: Check the connection

    List your servers from the terminal. virlo should appear with its URL. If it shows as needing sign-in, repeat step 3.

    Terminal
    grok mcp list
  5. Step 5: Give Grok a research task

    Ask in plain English and tell Grok where to save the result. It picks the right Virlo tool for you.

    Prompt
    Use Virlo to find the 10 TikTok and Instagram videos about [topic] with the highest Virality Score this month. Save them to research/outliers.md with a one-line reason each worked.

Already set Virlo up for Claude Code in this repo? Grok Build also reads Claude Code-style .mcp.json files, so the same project config works in both agents.

grok mcp add vs config.toml vs .mcp.json: which setup should I use?

SetupWhere it livesBest for
grok mcp add (user scope)Your user config in ~/.grok/config.tomlUsing Virlo in every project on your machine
grok mcp add --scope project.grok/config.toml in the repoA team repo where everyone should have Virlo
[mcp_servers.virlo] by hand~/.grok/config.toml, with url set to the server URLDotfiles you keep in version control
Claude Code .mcp.jsonThe repo rootRepos shared between Grok Build and Claude Code

Every setup points at the same Virlo server and signs in the same way, so the data is identical.

Which TikTok sounds is Grok pulling this week?

Here is a real result Grok Build can fetch with Virlo's sound tool and save to sounds.md: the TikTok sounds used in the most videos over the last 7 days, with whether each one is licensed for brand use.

In Virlo's data, 331 TikTok videos used "original sound - cluberich" in the last 7 days, more than any other sound on TikTok as of November 18, 2026.

As of November 18, 2026 at 12:03 UTC

Which TikTok sounds is Grok pulling this week?
SoundArtistTikTok videos (7 days)Licensed for brands
original sound - cluberichcluberich331Yes
original sound - hazelgrayyehazel gray282Yes
original sound - greenwalksssGreenWalksss259Yes
original sound - HaniHani249Yes
original sound - rosyconfessionsᝰ.ᐟ248Yes

See all 300 trending TikTok sounds

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 the number of videos using each sound in the window. "Licensed for brands" = the sound is in TikTok's commercial music library.
As of
November 18, 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, “Use Grok Build to research TikTok and Instagram”, virlo.ai/grok-build

What can Grok Build do with Virlo?

Grok Build treats Virlo like any other MCP server: it reads the tool descriptions, picks one per step and shows you the call. Typical jobs:

  • Turn a research question into a Markdown, CSV or JSON file in your repo.
  • Seed an app or dashboard with real TikTok and Instagram rows instead of fake data.
  • Pull a TikTok transcript and rebuild it as a script template.
  • Rank videos by Virality Score, so a small creator's breakout counts.
  • Run in headless mode from a script or CI job once Virlo is configured.

What can I ask Grok Build to research?

Run these in a Grok Build session with Virlo ready. Replace the brackets.

  • Sound file

    Which TikTok sounds are trending this week? Write the top 10 to data/sounds.csv with title, artist and video count.

  • Trend tracker

    Pull the trends to copy for [your niche] and update research/trends.md, marking which ones are new since the last run.

  • Outlier dataset

    Find 50 Instagram Reels about [topic] from the last 30 days, ranked by Virality Score, and save them as data/reels.json.

  • Transcript to template

    Get the transcript of [TikTok link] and write templates/script.md with the hook, setup, turn and payoff marked.

  • Competitor file

    Look up @[competitor] on TikTok and Instagram and write competitors/[name].md with their outlier videos and repeated formats.

  • Hook table

    Which hook types reach a Virality Score of 18+ most often in [your niche]? Save the answer as a table in docs/hooks.md.

  • Build on it

    Read data/reels.json and build a small web page that shows the top 10 as cards with their links.

Grok Build vs Grok Bot vs Grok: which guide do I need?

xAI uses the Grok name for several products. Here is which one this page is about.

Grok Build (this page)

xAI's coding agent in the terminal. Add Virlo with grok mcp add and keep research as files.

Grok Bot

xAI's always-on bots. Virlo connects through a setup prompt, with ten ready-made social media bots.

Grok

The chat assistant on X and grok.com. For Virlo data inside the Grok family, use Grok Build or Grok Bot.

What are the limits?

  • Virlo serves public TikTok and Instagram data. It has no access to your social accounts and cannot post.
  • Grok Build loads servers when a session starts, so restart Grok after adding Virlo.
  • Transcripts are available for TikTok videos; Instagram Reels come with hooks, format and numbers instead.
  • Grok asks before running a tool unless you allow it in your settings, which matters for unattended runs.
  • Virlo plans are listed on pricing.

Frequently asked questions

How do I add an MCP server to Grok Build?

Run grok mcp add with the transport, a name and the URL. For Virlo: grok mcp add --transport http virlo https://dev.virlo.ai/api/mcp/mcp. Then start grok, open /mcps, select virlo and press i to sign in. grok mcp list confirms it is registered.

What is Grok Build?

xAI's agentic coding tool for the terminal. Like Claude Code or Codex, it reads your project, runs commands and edits files, and it can call MCP servers. With Virlo added it can also research TikTok and Instagram for you and save the results in the repo.

Can Grok Build research TikTok trends?

Yes, once Virlo is connected. Ask for this week's trends to copy, trending or breakout sounds, top hashtags or the videos with the highest Virality Score on a topic, and Grok calls the matching Virlo tool and returns real rows with links to the videos.

Do I need an API key to use Virlo in Grok Build?

No. Virlo's server supports OAuth, so Grok Build opens a browser sign-in the first time you connect, from /mcps. Virlo issues the credentials, and you never copy or store a key yourself.

Can I share the Virlo setup with my team?

Yes. Add --scope project to the grok mcp add command and the server is saved in .grok/config.toml inside the repo. Anyone who opens the project in Grok Build gets Virlo and signs in with their own Virlo account.

Does Grok Build work with Claude Code MCP config?

Yes. Grok Build reads Claude Code-style .mcp.json files, so a repo already set up for Claude Code with Virlo works in Grok Build too. The Claude Code guide has the command that writes that file.

Is Grok Build the same as the Grok CLI?

Yes. Grok Build runs in your terminal as the grok command, so "Grok CLI" and "Grok Build" usually mean the same tool. Every command on this page, such as grok mcp add and grok mcp list, runs in that CLI. Community tools named grok-cli are separate projects.

Is Grok Build the same as Grok Bot?

No. Grok Build is the coding agent for developers. Grok Bot is xAI's always-on bot product, where Virlo connects through a setup prompt and ten ready-made bots. The Grok Bot guide covers that route.

Can Grok Build post to TikTok through Virlo?

No. Virlo only reads public TikTok and Instagram data. Grok Build can research, rank and write scripts with it, but posting stays with you and the tools you already use.

Research social media from Grok Build

One command connects Virlo. Ask Grok what is working in your niche today.