Google Antigravity MCP setup for TikTok and Instagram research

Updated

Virlo is social listening for TikTok and Instagram Reels. Google Antigravity's agents can plan, code and test a whole feature, but they cannot see which TikTok or Instagram videos are taking off this week. Add Virlo to Antigravity's mcp_config.json and its agents can pull trends, hooks, sounds and outlier videos from a database of 23.1M viral videos, signing in on their own. Google Antigravity is Google's agent-first development platform, available as an IDE, a desktop app and a CLI.

  • A single serverUrl line in mcp_config.json
  • Automatic Virlo sign-in: no client ID or key required
  • Works across the Antigravity IDE, app and CLI

Part of Virlo's AI assistant guides. Working in Google's terminal agent? See Gemini CLI. Comparing agentic IDEs? See Kiro and Windsurf.

How do I add a custom MCP server to Google Antigravity?

Antigravity reads servers from one raw config file. Because Virlo supports automatic client registration, the entry needs nothing but the URL.

  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: Open the raw MCP config

    In the Antigravity IDE, click the … menu at the top of the agent side panel, choose MCP Servers, then Manage MCP Servers, then View raw config. In the Antigravity app, open Customizations, go to Installed and use Copy Config File Path in the MCP Servers header to find the same file.

  3. Step 3: Add Virlo with its server URL

    Paste this entry under mcpServers and save. The global file is ~/.gemini/config/mcp_config.json; a copy at <workspace>/.agents/mcp_config.json limits Virlo to one project.

    mcp_config.json
    {
      "mcpServers": {
        "virlo": {
          "serverUrl": "https://dev.virlo.ai/api/mcp/mcp"
        }
      }
    }
  4. Step 4: Authenticate with Virlo

    Antigravity registers itself with Virlo and opens the sign-in page. Approve access; in the app, click Authenticate next to virlo under Customizations, then Installed, and paste the code from the browser into Enter authorization code. Tokens refresh on their own after that.

  5. Step 5: Ask an Antigravity agent

    Start a new agent conversation in your workspace and give it a research goal. The agent shows each Virlo call in its plan and saves the output as files you can review.

    Your first prompt
    Use Virlo to collect this week's top 10 TikTok trends to copy in [your niche] and save them to research/trends.json with the part to keep, the part to change and an example video for each.

On a machine where the browser sign-in is awkward, use a key header instead. Make a key on the Virlo API Keys page and use this entry: { "mcpServers": { "virlo": { "serverUrl": "https://dev.virlo.ai/api/mcp/mcp", "headers": { "Authorization": "Bearer virlo_tkn_YOUR_KEY" } } } }

Sign-in vs API key vs MCP Store: which Antigravity route should I use?

RouteWhat goes in mcp_config.jsonHow it authenticatesUse it when
Automatic sign-inOnly "serverUrl"Antigravity registers with Virlo and runs OAuth; tokens saved in ~/.gemini/antigravity/mcp_oauth_tokens.jsonYour own laptop with a browser
API key header"serverUrl" plus "headers" with Authorization: Bearer virlo_tkn_…Your Virlo key on every requestRemote machines, shared VMs or the Antigravity CLI over SSH
Workspace file<workspace>/.agents/mcp_config.jsonSign-in or key, per developerKeeping Virlo inside one project
Virlo skillsnpx skills add Virlo-AI/Virlo-Agent-Plugin installs virlo and short-form-trend-researchUses the server you addedAgents that should rank by Virality Score and plan content weekly

Antigravity accepts url as well as serverUrl, but only over Streamable HTTP, which is what Virlo uses.

Antigravity agents with and without Virlo

Goal you hand the agentWithout VirloWith Virlo connected
Build a trends page for our siteMock cards filled with invented trendsCards built from this week's real Trends to copy records
Plan five launch videosFormats the model remembers from trainingFormats creators are copying right now, each with an example video
Choose audio for a demo clipWell-known songs from past yearsSounds gaining ground on TikTok and Instagram Reels this week
Explain a rival post that spikedA guess from the caption textSpoken hook, on-screen text, format and Virality Score against that creator's norm

What does an Antigravity agent receive from Virlo?

This is one real Trends to copy record, this week's top trend, in the shape an Antigravity agent gets back. Ask the agent to write it to JSON and it can render straight into whatever you are building.

In Virlo's data this week, "My moon my man couple montage" is the trend to copy with the most creators: 659 in the last 7 days, as of November 19, 2026.

As of November 19, 2026 at 13:07 UTC

What does an Antigravity agent receive from Virlo?
FieldValue
NameMy moon my man couple montage
StageFresh
Creators this week659
Creators last weeknew this week
Keep the sameThe song 'My Moon My Man' by Feist (often a specific remix or cover) and the theme of showing a romantic partner.
Make it yoursThe specific person or couple being shown and the setting of the clips.
Example videoExample video for the My moon my man couple montage trend@haleyybaylee

38 more trends to copy

The full list, with history and every example, is in the Virlo app and over the MCP server.

Open Trends to copy

How this sample is made

Source
Virlo's Trends to copy: formats found by Virlo's trend detector and published only after the team checks each one.
Window
Creators who posted each trend in the last 7 days, counted from TikTok and Instagram videos only. Trends made with an AI tool are left out.
Method
Ranked by creators posting this week. Stages: Fresh, Rising, Peaking, Fading.
As of
November 19, 2026 at 13:07 UTC. Refreshes every hour.
Made by
Numbers are pulled automatically from Virlo's data every hour; the text around them is written by the Virlo team.

Suggested citation: Source: Virlo, “Google Antigravity MCP setup for TikTok and Instagram research”, virlo.ai/antigravity

How Antigravity agents use Virlo for marketing research

Antigravity is built around handing a goal to an agent and reviewing what comes back: plans, task lists, file changes and browser checks. Virlo slots in as one more source the agent can consult, so a goal like "build a page showing this week's trends" ends with real data, not mock JSON.

  • Give the agent a research goal and let it decide which Virlo tools to call.
  • Ask for artifacts you can review: a trends file, a hooks table or a weekly brief in markdown.
  • Run several agents in parallel, one per niche or competitor, and compare their reports side by side.
  • Have an agent build a small internal dashboard from the files, then check it in the built-in browser.

Virality Score is how far a video beat its creator's usual views, and 18 or above is strong. Ask agents to sort by it so a small creator's breakout outranks a big account's routine post.

Antigravity IDE, app and CLI: one Virlo entry

The Antigravity IDE and CLI share the global ~/.gemini/config/mcp_config.json, so adding Virlo once covers both. In the CLI, type /mcp and press Enter to open the MCP Manager and confirm virlo is listed.

Long research runs can take time when an agent compares many videos. Add "timeoutSeconds": 600 to the virlo entry if you want to give individual calls more room.

Rules and workflows that point Antigravity agents at Virlo

Antigravity lets you save rules and reusable workflows for your agents. A rule such as "for social media research, call the virlo tools, sort by Virality Score and link every source video" means you no longer have to mention Virlo in each goal.

A saved workflow for your weekly brief works the same way: one command asks the agent to pull trends, hooks and sounds for your niche and write a dated file, so the research runs the same way every Monday no matter who starts it.

What can I ask Antigravity agents with Virlo connected?

Give these to an agent as goals. Replace the brackets with your own details.

  • Trend dataset

    Collect the 20 TikTok trends to copy with the most creators in [your niche] this week and save them to data/trends.json.

  • Dashboard build

    Build a page that reads data/trends.json and shows each trend as a card with its stage, then verify it in the browser.

  • Reels hooks

    Find Instagram Reels about [topic] with a Virality Score of 18 or higher and list their on-screen text hooks in docs/hooks.md.

  • Parallel competitors

    For each of @[competitor one], @[competitor two] and @[competitor three] on TikTok, report which videos beat their usual views and why.

  • Sound shortlist

    Which sounds are breaking out on TikTok this week? Recommend two for a [tone] video about [your product].

  • Script from a video

    Get the transcript of [TikTok link] and write a 30-second script for [your product] that keeps the same beats.

  • Weekly brief

    Combine Virlo trends, hooks and sounds for [your niche] into briefs/[date].md, with a source video linked for every idea.

  • Creator finder

    Find 10 creators under [N] followers in [your niche] whose videos keep outperforming their follower count, and save them to data/creators.csv.

Google Antigravity vs Gemini CLI vs the Gemini app: which guide fits?

Google offers several AI tools for builders, and they share models but not setup screens.

Google Antigravity (this page)

An agent-first IDE, desktop app and CLI. MCP servers go in mcp_config.json through Manage MCP Servers.

Gemini CLI

Google's open-source terminal agent. It adds Virlo with gemini mcp add and keeps servers in settings.json.

Gemini app

The consumer chat assistant at gemini.google.com, separate from both developer tools above.

Windsurf

Cognition's agentic editor, now Devin Desktop, which also uses a serverUrl key in its mcp_config.json.

What are the limits?

  • Virlo only reads public TikTok and Instagram data; Antigravity agents can research and build with it but never post or reach social accounts.
  • Remote servers must use Streamable HTTP in Antigravity; the legacy SSE transport and the httpUrl field are not accepted.
  • OAuth tokens are stored per machine, so each computer signs in to Virlo once.
  • Trends to copy refresh every hour after a check by the Virlo team.
  • For what each Virlo plan includes, see pricing.

Frequently asked questions

How do I add an MCP server to Google Antigravity?

In the IDE, open the … menu on the agent side panel, choose MCP Servers, then Manage MCP Servers and View raw config. Add an entry under mcpServers with a serverUrl and save. For Virlo the URL alone is enough, because Antigravity handles the sign-in automatically.

Where is the Antigravity mcp_config.json file?

The global file is ~/.gemini/config/mcp_config.json and applies to all projects. A workspace file at <workspace>/.agents/mcp_config.json applies to one project. In the Antigravity app, Copy Config File Path in the MCP Servers section shows the exact location. Workspace entries apply on top of the global file for that project only.

Does Antigravity support OAuth for remote MCP servers?

Yes. For servers that support Client ID Metadata Documents or Dynamic Client Registration, Antigravity needs only the serverUrl and runs the sign-in itself. Virlo supports both, so you approve access once in the browser and tokens refresh automatically afterwards. No client ID, secret or callback URL has to be registered by you.

Is Virlo in the Antigravity MCP Store?

You add Virlo as a custom server through View raw config rather than the MCP Store list. It takes one line, and once saved it behaves like any store server: it appears under Manage MCP Servers and every agent in the workspace can call it.

Can Google Antigravity see TikTok and Instagram videos?

With Virlo connected, agents receive trends to copy, outlier videos ranked by Virality Score, hooks, sounds, hashtags, creator stats and TikTok transcripts. That text describes what is inside each video well enough to explain a hit or draft a new script.

What is the difference between Antigravity and Gemini CLI?

Antigravity is an agent-first IDE and app where you manage agents working on goals; Gemini CLI is an open-source agent that runs in your terminal. Both can use Virlo, with different config files. The Gemini CLI guide covers the terminal setup.

Virlo shows as needing authentication in Antigravity. What now?

Open Customizations, then Installed, click Authenticate next to virlo, finish the sign-in in your browser and paste the authorization code back into the field. If you work on a machine without a browser, switch to the API key entry with an Authorization header.

Can Antigravity agents post to TikTok through Virlo?

No. Virlo has no posting tools and never signs in to social accounts. Agents can gather data, write scripts and build tools with it, and you publish through your usual social apps or scheduler. Agents need no social login for any research goal.

Can I use an API key instead of signing in on Antigravity?

Yes. Add a headers object to the virlo entry with Authorization set to Bearer and your virlo_tkn_ key. That suits remote machines and shared virtual machines where a browser sign-in is awkward. Keep the global file private, because the key sits in it as plain text.

Give Antigravity agents a social media brain

Add one serverUrl, sign in once, and ask an agent what your niche is copying on TikTok and Instagram.