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 keyWhat 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.
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.
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-mcpOr the remote server, with sign-in
codex mcp add viralhunt --url https://viralhunt.io/mcp
codex mcp login viralhuntThe 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"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.mdCheck it works
List the servers, then open Codex and type /mcp: viralhunt should show its tools. Then ask the first prompt below.
codex mcp listChecked 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📚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.
- 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 - 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 - 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).
- 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".
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.
| Free | Creator, Studio, Agency | |
|---|---|---|
| Content queries (trends, hashtags, sounds, best time, communities) | 24 a day | By plan, hundreds an hour |
| Freshness of trending posts | 72 hours ago and older | As it breaks |
| Engagement numbers and growth | Withheld | Included |
| Drafts, review, brand templates, publishing to 11 networks | 10 drafts a month to try templates | Yes |
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