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.
Step 1: Create your Virlo account for free
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.
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.jsonlimits Virlo to one project.mcp_config.json{ "mcpServers": { "virlo": { "serverUrl": "https://dev.virlo.ai/api/mcp/mcp" } } }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.
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 promptUse 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?
| Route | What goes in mcp_config.json | How it authenticates | Use it when |
|---|---|---|---|
| Automatic sign-in | Only "serverUrl" | Antigravity registers with Virlo and runs OAuth; tokens saved in ~/.gemini/antigravity/mcp_oauth_tokens.json | Your own laptop with a browser |
| API key header | "serverUrl" plus "headers" with Authorization: Bearer virlo_tkn_… | Your Virlo key on every request | Remote machines, shared VMs or the Antigravity CLI over SSH |
| Workspace file | <workspace>/.agents/mcp_config.json | Sign-in or key, per developer | Keeping Virlo inside one project |
| Virlo skills | npx skills add Virlo-AI/Virlo-Agent-Plugin installs virlo and short-form-trend-research | Uses the server you added | Agents 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 agent | Without Virlo | With Virlo connected |
|---|---|---|
| Build a trends page for our site | Mock cards filled with invented trends | Cards built from this week's real Trends to copy records |
| Plan five launch videos | Formats the model remembers from training | Formats creators are copying right now, each with an example video |
| Choose audio for a demo clip | Well-known songs from past years | Sounds gaining ground on TikTok and Instagram Reels this week |
| Explain a rival post that spiked | A guess from the caption text | Spoken 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
| Field | Value |
|---|---|
| Name | My moon my man couple montage |
| Stage | Fresh |
| Creators this week | 659 |
| Creators last week | new this week |
| Keep the same | The song 'My Moon My Man' by Feist (often a specific remix or cover) and the theme of showing a romantic partner. |
| Make it yours | The specific person or couple being shown and the setting of the clips. |
| Example video |
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 copyHow 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
httpUrlfield 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.
More AI assistant guides
- AI assistant guides
- Claude
- Claude Code
- Cursor
- MCP server
- TikTok MCP server
- Instagram MCP server
- ChatGPT
- ChatGPT dots
- OpenAI Codex
- Gemini CLI
- Grok Build
- Claude Cowork
- n8n
- Zapier
- Grok Bot
- Muse
- Claude Duet
- Hermes Agent
- Kimi K3
- Cue
- Manus
- Perplexity Computer
- Paperclip
- OpenClaw
- NanoClaw
- DeepSeek
- AI agents CLI
- ChatGPT agent
- Perplexity
- Microsoft Copilot
- Le Chat
- Notion
- Slack
- Discord
- Telegram
- Google Sheets
- Windsurf
- VS Code
- GitHub Copilot
- Cline
- JetBrains
- Kiro
- goose
- Warp
- OpenCode
- Zed
- Amp
- Factory Droid
- Raycast
- Lovable
- Replit
- Bolt.new
- v0
- Ollama
- LM Studio
- Open WebUI
- LibreChat
- Make
- Pipedream
- Gumloop
- Lindy
- Relevance AI
- Airtable
- ClickUp
- Dify
- Flowise
- LangChain
- CrewAI
- OpenAI Agents SDK
- Mastra
- Vercel AI SDK
- Claude Agent SDK