Add Virlo to the Warp terminal and research TikTok
Updated
Virlo is social listening for TikTok and Instagram Reels. The Warp Agent can run shell commands and edit code, but nothing in Warp can tell it which TikTok or Instagram formats are spreading this week. Paste Virlo into Warp's MCP servers page and the agent can query a database of 23.1M viral videos for trends, hooks, sounds and outliers without leaving the terminal. Warp is an agentic development environment built around a modern terminal, with built-in AI agents, Warp Drive and team sharing.
- Paste one JSON snippet into Settings, then sign in
- Share the server with your team from Warp Drive
- Reads Claude Code and Codex MCP files you already have
Part of Virlo's AI assistant guides. Running Claude Code or Codex inside Warp? Their guides are Claude Code and Codex.
How do I add an MCP server to Warp?
Warp accepts the same JSON most MCP clients use, so the whole setup is one paste and one approval.
Step 1: Create your Virlo account for free
Step 2: Open the MCP servers page
In Warp go to Settings, then Agents, then MCP servers. The same list is reachable from Warp Drive under Personal, then MCP Servers. Click
+ Add.Step 3: Paste the Virlo server
Warp takes an
mcpServersobject where each key is a server name. Paste this snippet and save; Warp registers virlo as a URL-based server.Warp MCP server JSON{ "mcpServers": { "virlo": { "url": "https://dev.virlo.ai/api/mcp/mcp" } } }Step 4: Sign in to Virlo
Because the entry has no header, Warp starts an OAuth login and opens your browser on the Virlo approval page. Approve it and virlo shows as running in the MCP servers list. Warp keeps the credentials on this device.
Step 5: Ask the Warp Agent
Type a natural-language request in the Warp input. The agent sees Virlo's research tools next to its shell tools and asks before calling them, unless you have allowed them.
Your first promptUsing the virlo MCP server, show me which hook types reach a Virality Score of 18+ most often on TikTok in [your niche], then write the top five to notes/hooks.md.
Prefer files? Put the same JSON in ~/.warp/.mcp.json for every project, or in .warp/.mcp.json at a repo root for that project only.
Settings page vs .mcp.json file vs shared server: where should Virlo live in Warp?
| Where | How | Who gets Virlo | Notes |
|---|---|---|---|
| Settings > Agents > MCP servers | Click + Add and paste the JSON | You, on this machine | Starts automatically with Warp |
~/.warp/.mcp.json | Save the mcpServers JSON in your home folder | You, in every project | Handy for dotfiles |
.warp/.mcp.json in a repo | Commit the file at the project root | Anyone opening that repo in Warp | Warp asks for approval each session |
| Shared from Warp Drive | Click the share icon on the virlo entry | Teammates, under the Shared section | Each person signs in with their own Virlo account |
Every option points at the same Virlo endpoint, so the answers are identical wherever the server is defined.
Warp terminal alone vs Warp with Virlo
| Question | Warp Agent alone | Warp Agent with Virlo |
|---|---|---|
| Which hook types win on TikTok right now? | No data to check | Hook-type rates from tagged TikTok and Instagram videos |
| Seed a demo app with real social data | Writes placeholder rows | Pulls real videos with links and Virality Scores |
| What sound should this Reel use? | Cannot see sound charts | Trending and breakout sounds for Reels and TikTok |
| What did @[competitor] post that worked? | Would need a scraper | Their outlier videos, ranked against their usual views |
Which hook types is the Warp Agent seeing win right now?
A live answer the Warp Agent can fetch through Virlo: hook types ranked by how often TikTok videos that use them hit a Virality Score of 18 or more, with the Instagram rate beside each one.
In Virlo's snapshot of 1,365,774 hook-tagged TikTok videos, POV setup hooks reached a Virality Score of 18 or more 32.9% of the time, against 18.1% on Instagram.
As of November 19, 2026
| Hook type | TikTok: share at 18+ | Instagram: share at 18+ | TikTok videos |
|---|---|---|---|
| POV setup | 32.9% | 18.1% | 49,587 |
| Shock statement | 31.8% | 16.8% | 70,816 |
| Relatable scenario | 31.2% | 15.3% | 84,123 |
| Trend reference | 30.3% | 15.3% | 6,884 |
| Comparison | 29.8% | 19.0% | 13,443 |
| Before and after | 28.6% | 14.6% | 9,249 |
Hook types by niche, with every hook behind them
Split by 20+ niches, with the hooks and videos behind each number, in the Virlo app.
Open hooks in VirloHow this sample is made
- Source
- Virlo's daily hook snapshot: 1,365,774 TikTok and 264,108 Instagram 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, the "strong" band. Virality Score measures how far a video beat its creator's usual views.
- 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, “Add Virlo to the Warp terminal and research TikTok”, virlo.ai/warp
Does Warp pick up Virlo from my other agents?
Yes, if you already added Virlo to another agent. Warp reads Claude Code's ~/.claude.json and .mcp.json, Codex's ~/.codex/config.toml and .codex/config.toml, and shared .agents/.mcp.json files. Project-level entries wait for your approval each session.
Global servers from those third-party files only start on their own once you turn on "Auto-spawn servers from third-party agents" in Warp's MCP settings. Until then they appear in the list but stay stopped.
You can also ask the Warp Agent to write the file for you with its /agent-add-mcp skill, then approve the result.
A Warp workflow for marketers who code
Warp suits marketers who build their own tools, because research and code sit in one window. A typical loop with Virlo connected:
- Ask the agent for this week's trends to copy in your niche and save them as JSON in the repo.
- Have it scaffold a small page or script that reads that JSON and renders cards.
- Pull the transcript of the strongest TikTok and draft a script in a Markdown file beside the code.
- Share the virlo server from Warp Drive so a teammate can rerun the same research tomorrow.
What can I ask the Warp Agent to research?
Run these in Warp once virlo is running. Replace anything in brackets.
Hook table
Which hook types win most often on TikTok and on Instagram in [your niche]? Save a two-column comparison to docs/hooks.md.
Trend JSON
Pull this week's trends to copy for [your niche] and write them to data/trends.json with name, stage and creators this week.
Competitor teardown
Find the five videos from @[competitor] that beat their usual views by the most, and list the hook and format of each.
Sound pick
Which Instagram Reels sounds are breaking out this week? Give me three that fit [your brand] and why.
Transcript
Get the transcript of [TikTok link] and mark the hook, the turn and the call to action.
Quick dashboard
Read data/trends.json and build a single HTML page that shows each trend as a card with its example video link.
Outlier hunt
Search Virlo for Instagram Reels about [topic] from the last 14 days with a Virality Score of 18 or more and sort them by date.
Agent check-in
What did my Virlo marketing agent for [your niche] find on its latest run? Summarise the three strongest videos and why they worked.
Warp terminal vs Warp cloud agents vs other Warps: which one is this?
The Warp name covers a few products, and a couple of unrelated tools share it too.
Warp terminal and local agents (this page)
The desktop app where you type commands and prompts. Virlo is added under Settings, Agents, MCP servers.
Warp cloud agents
Warp's automation platform runs agents in the cloud and connects MCP servers through its own dashboard, separate from the desktop MCP list.
Cloudflare WARP
A VPN-style app from Cloudflare. It has no agent and no MCP support.
Warpcast
A social app for the Farcaster network, unrelated to the Warp terminal.
What are the limits?
- Virlo only reads public TikTok and Instagram data; the Warp Agent cannot post or reach your social accounts through it.
- OAuth credentials stay on the device, so a new machine needs one more Virlo sign-in.
- Project-scoped
.warp/.mcp.jsonservers ask for approval in every session; global ones start automatically. - Trends to copy refresh every hour and are reviewed by the Virlo team before they appear.
- See pricing for Virlo plans.
Frequently asked questions
How do I add an MCP server to Warp terminal?
Open Settings, then Agents, then MCP servers, and click + Add. Paste a JSON snippet with an mcpServers object; for Virlo the entry only needs a url. Warp then signs you in through the browser and lists the server as running.
Does Warp support remote MCP servers?
Yes. Warp handles URL-based servers over Streamable HTTP or SSE as well as command-based ones that it launches locally. A URL entry takes a url and optional headers, and authentication can be OAuth in the browser, a bearer token in a header or environment variables. Virlo works with the first two.
What is Warp AI?
Warp AI refers to the agents built into the Warp terminal. You type a request in plain English and the agent runs commands, edits files and calls MCP tools. With Virlo connected, that same agent can answer questions about TikTok and Instagram performance.
Can the Warp Agent see TikTok data?
Not by itself, since Warp has no social data of its own. Once Virlo is added as an MCP server, the agent can request trends to copy, hooks, trending sounds, hashtags and outlier videos for TikTok and Instagram, each with links back to the original posts and a Virality Score where it applies.
Where does Warp store MCP config?
Servers added in Settings live in Warp itself and appear in Warp Drive under Personal. File-based servers go in ~/.warp/.mcp.json for global use or .warp/.mcp.json at a project root. Warp also reads Claude Code and Codex config files if they exist on your machine, which saves setting Virlo up twice.
Can I use a Virlo API key in Warp instead of OAuth?
Yes. Add a headers object to the virlo entry with Authorization set to Bearer followed by your Virlo key, which starts with virlo_tkn_. With a header in place, Warp skips the browser login and sends the key on every request, which helps on machines you reach over SSH.
How do I share the Virlo server with my Warp team?
Click the share icon on the virlo entry in the MCP servers page. Teammates find it under the Shared section in Warp Drive, and Warp swaps any sensitive values for variables they fill in themselves. Sharing needs a Warp team, and each person still approves their own Virlo sign-in.
Is the Warp Agent the same as Claude Code?
No. Warp has its own agent, but you can also run Claude Code inside the Warp terminal like any other command. Each one keeps its own MCP setup, although Warp can read Claude Code's .mcp.json file and reuse a Virlo entry from it. The Claude Code guide covers that agent.
Does Warp use the MCP servers I set up for Claude Code or Codex?
It can. Warp reads ~/.claude.json, .mcp.json and Codex's config.toml files and lists the servers it finds. Project entries wait for your approval each session, and global ones from other agents start only after you enable Auto-spawn servers from third-party agents in Warp's MCP settings.
Put social media research in your terminal
One paste in Warp's MCP servers page connects Virlo to the Warp Agent.
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
- Google Antigravity
- goose
- 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