Viralhunt MCP

ViralHunt MCP Server

An MCP server for [ViralHunt.io](https://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/claude → create the free account (free forever, no card, 24 content queries a day), then Account → API Access → Create access. Every token has a permission group (reader, writer, reviewer, publisher, full): a tool outside the group answers 403 insufficient_scope naming what it lacks, and viralhunt_account shows the token its own group. Give an agent that writes a writer token and the one that reviews a reviewer token. 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:

Guardrails baked in: it won't post to the wrong brand, only schedules in the future, drafts by default unless the user asked to publish now, never uses another page's text or branded picture, checks each network's media ceilings, and is told not to repost fake news / copyrighted media / spam.

Changelog

• 1.1.31 (2026-10-26) — viralhunt_brand_webhook takes format (json, discord, slack, auto) and test: true (one sample alert to the saved webhook, with what the receiver answered). The webhooks guide: https://viralhunt.io/webhooks.
• 1.1.30 (2026-10-26) — viralhunt_update_post on a SCHEDULED post works per account: each account's own text and pictures are patched only when they changed, a changed thread (new parameter) on X/Threads makes that network's post again, added accounts are created and dropped ones deleted; the answer lists patched, recreated, added, removed, refused; nothing under 6 minutes before the post's time (409 not_editable).
• 1.1.29 (2026-10-24) — allow_duplicate on viralhunt_schedule and viralhunt_approve_draft: the duplicate firewall refuses an account another post of the last 72 hours already carries the same text for (duplicate_of; 409 duplicate_post when every account is one). A send whose every network was cut answers status: processing with checking: true: never create it again.
• 1.1.28 (2026-10-23) — all and limit on viralhunt_brand_hot (the most commented threads too, rising first: the app's dashboard list); the answer carries machine (the always-on Chrome's heartbeat), so an empty list is read against whether anybody is searching.
• 1.1.27 (2026-10-22) — carousel on viralhunt_create_post / viralhunt_update_post: several pictures are allowed only when the user asked for a carousel (else 422 multiple_pictures); png replaces the post's picture instead of being added next to it; a post made on a template always has ONE picture, its render.
• 1.1.26 (2026-10-20) — the brand's voice on every project of viralhunt_targets (the owner's playbook: read first, follow over the general rules, offer to draft one when empty); complete means every network's copy (X, Bluesky, Threads) in overrides in the same create, never a cut.
• 1.1.25 (2026-10-19) — every picture on one of the organization's templates (create the template when none fits; pass the PNG and the design, a PNG alone is a flat file nobody can edit); the working agreement in viralhunt_schedule: a post for a person goes to Drafts complete, never to Review unless asked, handed over in one five-line message with the url the answer gives; url, drafts_url, project_id, project_name on create, drafts rows and get.
• 1.1.24 (2026-10-19) — viralhunt_list_posts (the queue and the history per target), viralhunt_delete_post (take a published target down), account_id on viralhunt_cancel_post; retry on a timed-out create needs force.
• 1.1.23 (2026-10-18) — cards: assigned_to by id, name or email on viralhunt_create_card; viralhunt_assign_card, viralhunt_get_card, viralhunt_list_cards, viralhunt_archive_card. Drafts rows carry publishes[] (the text each account really sends).
• 1.1.22 (2026-10-15) — viralhunt_brand_keywords takes run: true ("search now"); viralhunt_brand_status carries machine (is the always-on machine alive).
• 1.1.21 (2026-10-15) — Brand watch: viralhunt_brand_status, viralhunt_brand_keywords, viralhunt_brand_hot (the discussions heating up right now, with links), viralhunt_brand_alerts, viralhunt_brand_webhook (signed deliveries to the brand's own agent).
• 1.1.20 (2026-10-15) — viralhunt_translate_post describes what comes back (shortened, overrides, no em dashes) and the one-brand-two-languages pattern.
• 1.1.19 (2026-10-14) — viralhunt_schedule takes stage and assigned_to; viralhunt_update_post takes assigned_to and answers the stage after the edit; viralhunt_drafts filters by assigned_to; viralhunt_get_post carries the full drafts shape (overrides, design, render…); viralhunt_get_template with preview shows a template before any post; a too-long text answers text_too_long instead of a 500.
• 1.1.18 (2026-10-14) — design is always sent for a template-made picture (and viralhunt_update_draft repairs a PNG-only post with it): the app can then edit the image.
• 1.1.17 (2026-10-14) — viralhunt_trending takes sort: most_commented on every network that counts comments (tiktok new; facebook and pinterest map it to most_comments, x, bluesky and mastodon to most_replied).
• 1.1.16 (2026-10-13) — viralhunt_upsert_template takes action: archive; update works whether the action comes in the body or the URL; viralhunt_list_templates takes scope, per_page, page and lists the organization's own templates first.
• 1.1.15 (2026-10-13) — every draft is an Editorial Board card (card_id on create) that moves with the post; design_fields on update fixes the texts inside a designed image (a trusted reviewer too); template authors without admin ("Creates templates" on Team); templates never carry code (removed in the answer).
• 1.1.11 (2026-10-08) — approve by a member token on its own graded post (when ticked on Team); review_stats carries avg_score, self_published, published_over_fix.
• 1.1.10 (2026-10-07) — the reviewer's edit boundary (overrides and kind only, when trusted); text_limit per account.
• 1.1.9 (2026-10-07) — kind on create and update (fact | meme | quote | opinion | promo): the reviewer applies only that kind's rules.
• 1.1.8 (2026-10-07) — overrides[account] takes `first_comm