ViralHunt

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 → time it → publish → verify → correct loop). Every number comes with its sample size and time window, so an agent can say how much to trust it:

Tool	What it does
viralhunt_trending	Find topics — what's going viral on TikTok, Instagram, X, Facebook, Pinterest, Bluesky, Douyin, Reddit, Mastodon, Tumblr, Hacker News and news RSS, ranked by viral score, each post with growth_24h (how much it moved between our two most distant readings)
viralhunt_best_time	When to post — best weekday + hour per network from the posts that went viral there (365-day sample, hit rate, sample size, your time zone, optional niche keyword)
viralhunt_top_hashtags	Which hashtags — top tags per network or across all, by engagement, posts or per-post; one tag's breakdown by network
viralhunt_trending_sounds	Which sound — trending audio on TikTok, Instagram Reels and Douyin, cross-network sounds first, with the posts that used it
viralhunt_best_communities	Where to post — best subreddits (peak per 1,000 members, timing, top posts, similar) and Bluesky custom feeds for a topic
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
viralhunt_list_templates	Browse the content template library (on-brand layouts you fill)
viralhunt_get_template	Get one template's full spec (html + css + variable manifest) to render
viralhunt_upsert_template	Author or edit a template — editing a curated one clones it into your copy (owner/admin)
viralhunt_assign_template	Assign a template to a project so its agents can use it (owner/admin)
viralhunt_board_context	The team's Editorial Board in one call: members (with ids), columns, categories
viralhunt_create_card	Hand a post to a teammate — create a kanban card (URL metadata auto-filled, assignee, priority, due date, category)
viralhunt_move_card	Move a card to another column (the is_done column completes it)
viralhunt_my_cards	The cards assigned to you (when the token belongs to an agent member of the team)
viralhunt_card_comments	Read or add comments on a card (notifies the assignee, mirrors to team chat)

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.

What ViralHunt the platform does (beyond this MCP)

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 Reports are product features, not tools this MCP exposes today. The editorial board is exposed (context, cards, moves, comments) so an agent can hand content to a team instead of publishing it directly.

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.