ViralHunt MCP Server
An MCP server for ViralHunt.io β the
all-in-one platform to discover what's trending, curate it with your team, and publish everywhere.
A BuzzSumo alternative with a built-in cross-network scheduler and an API that AI agents can drive
end to end.
Get a free token: https://viralhunt.io β Account β API Access (7-day trial, no card). Full API
docs: https://viralhunt.io/api.
What an agent can do through this MCP server
These are the tools this server exposes (they drive the full discover β publish β verify β correct
loop):
| Tool | What it does |
|---|
viralhunt_trending | Find topics β what's going viral on TikTok / Instagram / X / Facebook / Pinterest / RSS, ranked by viral score (engagement velocity) |
viralhunt_targets | List your brands/projects and the connected accounts you can post to |
viralhunt_schedule | Publish now or schedule a post (text + media) across your connected accounts |
viralhunt_get_post | Check a post's status + per-network permalinks |
viralhunt_update_post | Edit a still-scheduled post (body / media / networks / time) |
viralhunt_cancel_post | Cancel the not-yet-published targets of a scheduled post |
Guardrails baked in: it won't post to the wrong brand, only schedules in the future, and is told not to
repost fake news / copyrighted media / spam.
ViralHunt is a full product; the tools above are the agent-drivable slice. The rest lives in the app
(and some via the REST API):
- Trending Radar β a live cross-network feed of viral content by niche and time window.
- Cross-network publishing & scheduling β schedule/publish to up to 11 networks (Instagram,
Facebook, TikTok, X, LinkedIn, YouTube, Pinterest, Threads, Bluesky, Telegram, Google Business),
per brand.
- Editorial Board (team) β a kanban to curate before publishing: columns, categories, assignments,
comments and team chat, so a team manages what goes out. (Cards/columns/comments are in the REST API.)
- Auto-DM (comment β DM automation) β when someone comments your keyword on Instagram, ViralHunt
auto-replies and sends them a DM β like ManyChat, but flat pricing, unlimited contacts, and a monthly
cap that resets. Configured in the app (runs via webhooks); Facebook next.
- Reports β what each brand/network actually did: posts, reach, DMs sent, replies, top content.
Note: Auto-DM and the editorial board are product features, not tools this MCP exposes today. This
server focuses on the discover β publish β manage loop.
Install (Claude Desktop / Cline)
{
"mcpServers": {
"viralhunt": {
"command": "npx",
"args": ["-y", "viralhunt-mcp"],
"env": { "VIRALHUNT_API_KEY": "vhk_your_token_here" }
}
}
}
Config: VIRALHUNT_API_KEY (your vhk_β¦ token, required) and VIRALHUNT_BASE_URL (optional, defaults
to the production API). Run locally: VIRALHUNT_API_KEY=vhk_... npx viralhunt-mcp (Node β₯ 18).
Listed on the Official MCP Registry as
io.github.rodvan/viralhunt-mcp. License: MIT.