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.