Skip to content

fmd-labs/viral-app

v0.5.0MIT

Connect viral.app to your agent: OAuth MCP server with 100+ tools for UGC analytics, account and video tracking, tags, Creator Hub campaigns, briefs, job postings, applications, creator chat and payouts, the viral video library and live TikTok/Instagram/YouTube lookups, with interactive cards and event automations, plus seven workflow skills.

creator-briefs

Write a viral.app creator brief the way viral.app's Copilot does. Settle the product, find proven sample videos in the viral video library (or the brand's own tracked videos), let the user pick them, write a short structured brief creators can follow, attach the picks as numbered samples, and decide who reads it. Works over MCP or over the REST API with an API key, for agents that run on webhooks and schedules. Use for "write a brief", "brief my creators", a brief built from videos the user picked or swiped, sample videos for an existing brief, and improving a brief. Campaign setup and creator chat are in creator-campaigns; open-ended trend research is in viral-research.

creator-campaigns

Run viral.app Creator Hub workflows end to end. Link briefs to campaigns (writing one is creator-briefs), create, change, end or copy campaigns through the required preview step, assign and unassign creators, draft and publish job postings, review and answer applications, and read payouts (due, upcoming, paid, breakdowns). Use for any campaign, brief link, job posting, application or payout question in viral.app; the creator roster and chat are creator-management. Starting or canceling payouts and Jobs Discovery are dashboard-only.

creator-management

Run a viral.app creator roster day to day. Add creators one by one or from a CSV (track their accounts, link them, create the creator record), invite them and follow the invitation through, get their social accounts connected, reach them in direct chats, group chats and broadcasts, nudge the ones who are stuck (pending invite, no accounts, unread brief, behind schedule, unanswered messages), and audit the program. Works over MCP or over the REST API with an API key, for agents that run on webhooks and schedules. Use for onboarding creators, "invite these creators", "who hasn't connected their accounts", chasing creators, messaging many creators at once and program health checks. Campaigns, assignments and job applications are in creator-campaigns; briefs in creator-briefs.

ugc-automations

Set up "watch for X and do Y" automations on viral.app events such as new job applications, creator chat messages, payouts becoming due, campaign, brief and assignment changes, new videos from tracked accounts, and views or follower milestones. Covers MCP Events in ChatGPT (Work chats and dots) and scheduled polling in other clients, with latency expectations and rules for untrusted creator text. Use when the user wants to be told, or wants the agent to act, whenever something happens in viral.app. Not for one-off questions about current data or for recurring reports on a fixed schedule (ugc-reporting).

ugc-reporting

Build UGC performance reports from viral.app data, such as weekly or monthly recaps, KPI summaries with period-over-period change, leaderboards of top videos, accounts and creators, campaign KPIs and creator pacing, market breakdowns, Slack-ready summaries, and recurring reports through scheduled tasks or a ChatGPT page that stays updated. Use when the user asks how content, creators or campaigns performed over a period, wants a recap, dashboard or report for their team, or wants one on a schedule. Not for finding new formats or hooks (viral-research) or for alerts when a single event happens (ugc-automations).

viral-app-mcp

Core guide to the viral.app MCP server (UGC and creator-marketing analytics for TikTok, Instagram, YouTube, Facebook and Snapchat, plus the Creator Hub). Use whenever a task touches viral.app data or actions, to connect and authenticate the server, pick among its 100+ tools, follow the credit quote-then-confirm flow, get ids, units and date formats right, know what MCP cannot do, and load the specialized skill for the job (ugc-reporting, creator-briefs, creator-management, creator-campaigns, viral-research, ugc-automations). Not needed for general social-media advice that uses no viral.app data.

viral-research

Research what works in short-form UGC with viral.app. Search the curated viral video library by niche, format, hook, product type, region or language, find videos similar to a reference, pull deep hook, CTA and scene breakdowns, analyze a tracked video's actual content with AI (spends credits), check live platform data, and turn the findings into hooks, scripts and a creator brief. Use for "what's working in niche X", hook and format ideas, competitor or trend research, and inspiration for briefs. Not for reporting on the user's own performance (ugc-reporting).