ViralHunt/Works with/Gemini
Gemini+ViralHunt

Give Gemini your social media

Gemini reads the web; ViralHunt measures it. Connect the two and your agent finds what is rising in your niche on 13 sources, explains why it works and turns it into a draft on your brand template. Works with Gemini CLI and with Antigravity CLI, which replaced it for most Google AI subscribers in June 2026.

Free forever · no card · 24 content queries a day on the free key
01You ask Gemini in plain words02ViralHunt finds what is rising on 13 sources03Gemini drafts it on your brand template04You approve, it goes out to 11 networks

What Gemini can do with ViralHunt

Gemini calls ViralHunt's MCP tools for live numbers it cannot get by searching: growth in the last day, the best hour per weekday, the hashtags that carried a post. With the skill it follows our method and stops at a draft for your review.

Find

Trending posts on 13 sources, ranked by growth in the last day, the best time to post per weekday and the hashtags, sounds and communities that carry a niche.

Create

Drafts on your own brand templates, one copy per network, translated into a second brand's language when you run one.

Publish, with you in charge

Scheduling to 11 networks on a paid plan. Agents leave drafts; nothing goes out until a person approves.

Set it up

Which one do you have? Google AI Pro and Ultra subscribers and free Code Assist users run Antigravity CLI since June 18, 2026; Gemini CLI stays for Code Assist Standard and Enterprise and for paid Gemini API keys. Steps for both.

01

Create a free account and your API key

The Free plan never expires and never asks for a card. In the app: Account, then API Access, then New token. It starts with vhk_. Keep it out of chats; it goes in a config file or an environment variable.

Create free account
02

Gemini CLI: add the server

One command. Use --scope user so it works in every folder (the default is the current project).

Local server (recommended)

gemini mcp add --scope user -e VIRALHUNT_API_KEY=vhk_your_key viralhunt npx -y viralhunt-mcp

Or the remote server, then sign in inside Gemini with /mcp auth viralhunt

gemini mcp add --scope user --transport http viralhunt https://viralhunt.io/mcp

The same in ~/.gemini/settings.json

{
  "mcpServers": {
    "viralhunt": {
      "command": "npx",
      "args": ["-y", "viralhunt-mcp"],
      "env": { "VIRALHUNT_API_KEY": "vhk_your_key" }
    }
  }
}
03

Antigravity CLI: add the server

Antigravity has no add command: edit the file below, then type /mcp to open the MCP Manager and reload. A remote server signs in by itself the first time.

~/.gemini/config/mcp_config.json

{
  "mcpServers": {
    "viralhunt": {
      "command": "npx",
      "args": ["-y", "viralhunt-mcp"],
      "env": { "VIRALHUNT_API_KEY": "vhk_your_key" }
    }
  }
}

Or the remote server

{
  "mcpServers": {
    "viralhunt": { "serverUrl": "https://viralhunt.io/mcp" }
  }
}
04

Install the skill and check it

Gemini CLI installs Agent Skills from a git repository; Antigravity keeps them too. Then /mcp should show viralhunt as connected with its tools.

Gemini CLI

gemini skills install https://github.com/viralhunt-io/viralhunt-skill --path skills/viralhunt --scope user --consent

Or by hand (both)

mkdir -p ~/.agents/skills/viralhunt
curl -fsSL https://raw.githubusercontent.com/viralhunt-io/viralhunt-skill/main/skills/viralhunt/SKILL.md \
  -o ~/.agents/skills/viralhunt/SKILL.md

Checked against Gemini's own documentation: Gemini CLI MCP · Gemini CLI skills · Antigravity MCP · Google's announcement.

Everything to copy, in one place

The same four pieces work in every agent. Gemini needs the ones marked in the steps above; the rest are here when you move to another tool.

🔗Remote MCP server

Nothing to install. Sign in with your ViralHunt account when the agent asks; it works for every agent that accepts a remote MCP address.

https://viralhunt.io/mcp

📦Local MCP server (npm)

For agents that run local servers. Node 18 or newer; your key goes in an environment variable, never in a chat.

npx -y viralhunt-mcp   # with VIRALHUNT_API_KEY=vhk_your_key
viralhunt-mcp on npm →

📚The skill (the method)

One text file that teaches any agent how to work ViralHunt: what to ask first, how to verify a story, which template fits which post, and to leave drafts instead of publishing.

Open SKILL.md → · GitHub

💬A first prompt

Paste it after connecting. Change the niche; the agent does the rest and stops at the draft.

Use ViralHunt. My niche is fitness for busy parents.
1. Show me what is rising on TikTok and Instagram in the last 24 hours, with the numbers.
2. Pick the three posts most likely to work for my brand and say why.
3. Turn the best one into a draft on my brand template, one copy per network, and leave it for my review.

Go further: run Gemini and your other AIs in one office

OfficeMatrix is a free, open-source office for your AI CLIs. It runs on your computer, on the subscriptions you already pay (Claude Code, Codex, Gemini, Grok, Kimi), and connects to ViralHunt with a six-letter code: no port, no tunnel, no key to copy. Then your team asks from inside ViralHunt (the composer, the board, a translation for your second brand) and the office answers, with the model you pick for each job. A person still saves every result.

  1. Install it. Node.js 18 and git are the only requirements.
    git clone https://github.com/rodvan/OfficeMatrix.git
    cd OfficeMatrix
    sh instalar.sh        # Windows: .\instalar.ps1
    node server.js
  2. Start your CLIs. Open http://127.0.0.1:4321. Getting started lists the CLIs it found and gives the install and sign-in command for each one missing. One is enough; more means more models to choose from.
    claudecodexgeminigrokkimi
  3. Connect ViralHunt. In the office press Connect ViralHunt. It shows a code and opens ViralHunt; you press Approve. The office now receives tasks the moment someone asks (a long-poll connection, like a chat bot).
  4. Ask from ViralHunt. In the composer, the design editor or a card, pick the office as the agent and say what you want: "rewrite this for LinkedIn", "make the picture in English for our second brand".

The full OfficeMatrix guide OfficeMatrix on GitHub →

What the free key does

Enough to see it work on your niche today. A paid plan, priced per brand, adds the live numbers, drafts on your templates and publishing.

FreeCreator, Studio, Agency
Content queries (trends, hashtags, sounds, best time, communities)24 a dayBy plan, hundreds an hour
Freshness of trending posts72 hours ago and olderAs it breaks
Engagement numbers and growthWithheldIncluded
Drafts, review, brand templates, publishing to 11 networks10 drafts a month to try templatesYes

Questions

Gemini CLI or Antigravity CLI?

Since June 18, 2026 Google AI Pro and Ultra subscribers and free Code Assist users run Antigravity CLI. Gemini CLI remains for Code Assist Standard and Enterprise licences and paid Gemini API keys. ViralHunt works in both.

Why does Gemini need ViralHunt if it can search the web?

Search shows what was published. ViralHunt measures what is growing: engagement read every few hours on 13 sources, so the agent can say this post gained most in the last day, not just that it exists.

The server shows as disconnected

For a local server, trust the folder (gemini trust) and check Node 18 or newer. For the remote server, run /mcp auth viralhunt; sign-in opens a browser, so it does not work over SSH.

Can Gemini publish without asking me?

No. Agents leave drafts and a person approves before anything goes out.

What does the free key do?

24 content queries a day with posts 72 hours old and numbers withheld. A paid plan adds live data, drafts on your templates and publishing to 11 networks.

Also works with

Five minutes to the first answer.

Create the account, connect Gemini, ask what is rising in your niche.

Create free account