ViralHunt/Works with/Codex
Codex+ViralHunt

Your content team, inside Codex

Codex already writes your code. Give it ViralHunt and it also finds what is going viral in your niche, writes the post on your brand template and leaves it for your approval. One config file covers the Codex CLI, the IDE extension and the desktop app.

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

What Codex can do with ViralHunt

Codex calls ViralHunt's tools like any other MCP tools: it reads the radar, checks the best time to post, fills a template and saves a draft. With the skill installed it also follows our method: verify the story, write one copy per network, stop at the draft.

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

Three commands in a terminal. Codex reads ~/.codex/config.toml, so the CLI, the IDE extension and the desktop app all see ViralHunt at once.

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

Add the ViralHunt MCP server

The local server runs with npx (Node 18 or newer) and reads your key from the environment. Or use the remote address and sign in with your ViralHunt account instead of a key.

Local server (recommended)

codex mcp add viralhunt --env VIRALHUNT_API_KEY=vhk_your_key -- npx -y viralhunt-mcp

Or the remote server, with sign-in

codex mcp add viralhunt --url https://viralhunt.io/mcp
codex mcp login viralhunt

The same in ~/.codex/config.toml

[mcp_servers.viralhunt]
command = "npx"
args = ["-y", "viralhunt-mcp"]
startup_timeout_sec = 30

[mcp_servers.viralhunt.env]
VIRALHUNT_API_KEY = "vhk_your_key"
03

Teach it the method with the skill

Codex loads Agent Skills from ~/.agents/skills (all projects) or .agents/skills in a repo. Call it with $viralhunt, or let Codex pick it when you ask about content.

For all your projects

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
04

Check it works

List the servers, then open Codex and type /mcp: viralhunt should show its tools. Then ask the first prompt below.

codex mcp list

Checked against Codex's own documentation: Codex MCP · Codex skills.

Everything to copy, in one place

The same four pieces work in every agent. Codex 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 Codex 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

Does this work in the Codex desktop app and the IDE extension?

Yes. The CLI, the IDE extension and the desktop app read the same ~/.codex/config.toml. In the app you can also add it in Settings, MCP servers, Add server, then restart.

Does it work in ChatGPT on the web?

ChatGPT on the web does not read the Codex config. For ChatGPT use our ChatGPT guide.

Local server or remote address?

The local server (npx viralhunt-mcp) uses your API key and is the path we test every release. The remote address (https://viralhunt.io/mcp) needs nothing installed: you sign in with your ViralHunt account and approve what the agent may do.

Can Codex publish without asking me?

No. Agents leave drafts. A person approves before anything goes out, and each key can be limited to reading, drafting or reviewing.

What does the free key do?

24 content queries a day: trends, hashtags, sounds, best time and communities, 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 Codex, ask what is rising in your niche.

Create free account