@virlo/mcp

The official MCP for Virlo — use the Virlo app 100% from your favorite system. Claude Code, Cursor, any MCP-compatible agent, or terminal. Have fun, and please please send the team feedback! We listen to all notes, requests, and love letters — [email protected]

What you can do

• Trend Research — Get trending topics, search for viral content with natural language, track niche leaderboards
• Orbit — Social Listening — Queue keyword-based searches across YouTube, TikTok, and Instagram. Get videos, Meta ads, creator outliers, and AI-powered intelligence reports
• Comet — Niche Monitoring — Create automated niche trackers that scrape videos on a schedule. Discover creator outliers, track Meta ads, and filter by platform, views, and date
• Content Parsing — Extract metadata, transcripts, and engagement data from any social media URL

Setup

1. Get your API token

Go to dev.virlo.ai and create a Personal Access Token in the API Tokens section.

2. Use as MCP server (Claude Code, Cursor, etc.)

Add to your MCP config:

{
  "mcpServers": {
    "virlo": {
      "command": "npx",
      "args": ["-y", "@virlo/mcp"],
      "env": {
        "VIRLO_API_KEY": "virlo_pat_your_token_here"
      }
    }
  }
}

Then ask your agent things like:

• "What's trending on Virlo right now?"
• "Search for AI productivity videos with 1M+ views"
• "Create an Orbit search for 'meal prep' across TikTok and YouTube"
• "Create a Comet to track 'ai tools' daily"
• "How many credits do I have?"

3. Use as CLI

npm install -g @virlo/mcp
virlo auth login

CLI Commands

virlo auth login|logout|status     Manage authentication
virlo trends                       Get current trending topics
virlo search <query>               Search for viral content
virlo orbit create                 Queue a keyword search (Orbit)
virlo orbit list                   List Orbit searches
virlo orbit status <id>            Check Orbit search results
virlo orbit videos <id>            Get videos from an Orbit
virlo orbit outliers <id>          Get creator outliers from an Orbit
virlo comets create                Create a Comet (niche tracker)
virlo comets list                  List your Comets
virlo comets videos <id>           Get videos from a Comet
virlo comets delete <id>           Delete a Comet
virlo content parse <url>          Parse a social media URL
virlo credits                      Check your credit balance

Use --format json on any command for machine-readable output.

MCP Tools

Trend Research

| Tool | Description | |------|-------------| | trends_list | Get current trending topics | | trends_search | Natural language search for viral content | | trends_niche_leaderboard | View which niches are trending |

Orbit — Social Listening

| Tool | Description | |------|-------------| | orbit_create | Queue a keyword search across platforms | | orbit_list | List all Orbit searches | | orbit_get | Get search status and AI analysis report | | orbit_videos | Get paginated video results with filtering | | orbit_ads | Get Meta ads from a search | | orbit_creator_outliers | Find creators outperforming their follower count |

Comet — Niche Monitoring

| Tool | Description | |------|-------------| | comet_create | Create a custom niche tracker | | comet_list | List your Comets | | comet_get | Get details of a Comet | | comet_videos | Get videos from a Comet | | comet_ads | Get Meta ads from a Comet | | comet_creator_outliers | Find breakout creators in a niche | | comet_delete | Delete a Comet |

Content & Account

| Tool | Description | |------|-------------| | content_parse_url | Parse social media URLs for metadata and transcripts | | account_credits_balance | Check credit balance |

Requirements

• Node.js 22+
• A Virlo account with an active subscription

Links

• Virlo
• Create API Token
• Report Issues