{"id":"com.viral-cat/viral-cat","slug":"com-viral-cat-viral-cat","title":"ViralCat","description":"Schedule and publish social posts across platforms, with drafts, media uploads and analytics.","version":"1.0.0","publisher":{"kind":"domain","id":"viral-cat.com","label":"viral-cat.com","url":"https://viral-cat.com"},"website":"https://viral-cat.com","repository":"","remotes":[{"type":"streamable-http","url":"https://viral-cat.com/api/mcp/mcp"}],"packages":[],"published":"2026-09-16","updated":"2026-09-16","status":"online","auth":"","latency_ms":958,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"list_brands","title":"List Brands","description":"List brands (content profiles), newest first, with per-brand post counts (posted/scheduled) and the next scheduled date. Use to see which brands exist and how active each is. Excludes archived brands. Returns `total` (all active brands) next to `count` (rows returned): when `truncated` is true the roster was cut off by `limit`, so raise it (max 50) before concluding a brand does not exist.","read_only":true},{"name":"get_brand_details","title":"Get Brand Details","description":"Full content profile for one brand: description, taglines, hashtags, CTA/website URL, niche (category/subcategory), content type, target platforms, and active discount. Use this to write on-brand captions BEFORE calling create_draft or schedule_post. Read-only; returns no secrets.","read_only":true},{"name":"list_posts","title":"List Posts","description":"List posts across all platforms, newest scheduled first. Each row is one publication on one platform. Filter by status (draft|scheduled|posting|posted|failed|cancelled) and/or platform (youtube|tiktok|instagram|...). Returns caption, brand name, permalink, error message when present, and publishWarning for posts that succeeded with an anomaly (e.g. published without media).","read_only":true},{"name":"get_pipeline_summary","title":"Get Pipeline Summary","description":"High-level snapshot of the posting pipeline: active brand count, a status breakdown (how many scheduled/posted/failed/etc.), a per-platform breakdown, how many posts are due in the next 7 days, and the next scheduled date. Use for 'how's the pipeline?' style questions.","read_only":true},{"name":"list_connections","title":"List Connections","description":"List connected platform accounts (channels) and their health: platform, account username, connected flag, posting-enabled flag, and token expiry. Use to check which platforms are wired up and whether any connection has expired. Never returns access or refresh tokens.","read_only":true},{"name":"post_performance","title":"Post Performance","description":"Publish-outcome metrics over a rolling window (default 30 days): posted/failed/cancelled totals, success rate, per-platform breakdown, and the most recent published posts with permalinks plus their latest stored engagement snapshot (views/likes/comments/shares; available for youtube/tiktok/twitter/threads). Snapshots are stored, not live: call refresh_post_metrics first if the numbers must be curr","read_only":true},{"name":"content_queue","title":"Content Queue","description":"The forward content pipeline: drafts awaiting approval first, then scheduled posts in publish order. Use to review what is queued before it goes out, and to find draft ids for schedule_post.","read_only":true},{"name":"campaign_summary","title":"Campaign Summary","description":"Per-brand campaign rollup (brands are ViralCat's campaign unit): posted/scheduled/failed/draft counts, platforms used, next scheduled date, last posted date, and auto-post settings. Optionally scope to one brand_id.","read_only":true},{"name":"diagnose_failures","title":"Diagnose Failures","description":"Group failed posts by platform + normalized failure reason: counts, date range, affected brands, a sample raw error, a recoverable flag (retry_failed_posts can re-queue it) and a concrete suggested fix per group. Answers \"what is broken and why\" in one call. Read-only.","read_only":true},{"name":"preflight_check","title":"Preflight Check","description":"READ-ONLY: validate a post BEFORE it is scheduled or published, so a problem is caught up front instead of discovered as a failure afterwards. Checks the exact things that produced the failed-post backlog: incompatible media for the platform (e.g. video to Pinterest), a disconnected or unrefreshable platform token (LinkedIn has no refresh token on this API tier and needs a manual browser reconnect","read_only":true},{"name":"create_draft","title":"Create Draft","description":"WRITE (safe): create a DRAFT post for a brand. Drafts are never picked up by the publisher, so nothing goes live; a human approves in the dashboard or promotes it later with schedule_post. scheduled_date is a proposed slot (default: 7 days out).","read_only":false},{"name":"schedule_post","title":"Schedule Post","description":"WRITE (gated): queue a post for FUTURE publishing, at least 15 minutes out (immediate posting is not available over MCP). Either pass post_id to promote an existing draft, or brand_id + platform to create a new scheduled post. The publishing cron sends it at the scheduled time.","read_only":false},{"name":"cancel_post","title":"Cancel Post","description":"WRITE (safe): cancel a queued post, or move it to a new slot. Omit scheduled_date to CANCEL (status -> cancelled; the publisher ignores it). Pass scheduled_date to RESCHEDULE to that time instead (ISO 8601, at least 15 minutes out; a draft keeps its draft status). Works on draft or scheduled posts (cancel or reschedule); also works on FAILED posts but cancel-only (omit scheduled_date) — this is th","read_only":false},{"name":"retry_failed_posts","title":"Retry Failed Posts","description":"WRITE (gated): bulk re-queue recoverable failed posts (default reason classes: token_expired, missed_window, platform_transient_error, drive_media_missing). dry_run DEFAULTS TO TRUE and only returns the plan; pass dry_run=false to actually reschedule. Retries are staggered per platform (spacing_minutes apart) and capped at limit, so a bulk retry cannot dogpile a platform API. Posts that would stru","read_only":false},{"name":"reschedule_post","title":"Reschedule Post","description":"WRITE (gated): move ONE post to a new future slot (ISO 8601, at least 15 minutes out). Unlike cancel_post this also accepts FAILED posts: a failed post is re-queued (status -> scheduled, error cleared). Draft and scheduled posts keep their status. Refuses posts that would structurally fail again (archived brand, incompatible media, Facebook with no Page).","read_only":false},{"name":"refresh_post_metrics","title":"Refresh Post Metrics","description":"WRITE (gated): fetch current engagement (views/likes/comments/shares) for already-published posts and store today's snapshot, then read it back with post_performance. This is the only way to update the numbers without opening the dashboard Stats tab. Supported platforms: youtube, tiktok, twitter, threads; LinkedIn and the rest expose no engagement API. A 60-minute cooldown applies per account and ","read_only":false},{"name":"reconnect_platform","title":"Reconnect Platform","description":"WRITE (safe): attempt a server-side token refresh for a platform whose access token has lapsed, updating the stored connection's token/expiry. Works without a browser when a refresh token is on file (twitter/youtube/google_drive self-heal this way); returns needsManualReauth + a dashboard link when the platform genuinely requires a manual browser reconnect (e.g. threads). Cannot publish or touch c","read_only":false},{"name":"upload_media","title":"Upload Media","description":"WRITE (gated): fetch a public media URL and store it in the connected Google Drive, returning the Drive fileId to pass to create_draft or schedule_post. This uploads to YOUR OWN Drive; it publishes nothing and reaches no audience. Accepts video, image or audio up to 100MB. With brand, files land in the folder the generator actually reads for that media type: Viral-Cat/_Res/{brand}/Imgs for an imag","read_only":false},{"name":"create_media_upload","title":"Create Media Upload","description":"WRITE (gated): open a Google Drive upload session for media you hold locally, so a clip rendered on your own machine never has to be published publicly just so ViralCat can fetch it back. Returns an uploadUrl - PUT the bytes to it yourself (no auth header) and Drive stores the file; the response Location/id is the fileId for create_draft or schedule_post. When brand is given the file lands in the ","read_only":false},{"name":"create_brand","title":"Create Brand","description":"WRITE (gated): create a brand (content profile) so create_draft and schedule_post have something to target. Every other write here needs a brand_id, so an agent had no way to set one up. Returns the brand_id and the Drive folder the publisher will read its media from (Viral-Cat/_Res/{name}/Vids). Publishes nothing and reaches no audience.","read_only":false},{"name":"update_brand","title":"Update Brand","description":"WRITE (gated): correct a brand's content profile: description, taglines, hashtags, CTA and website links, content type, and the auto-post switch. This is the repair path for a brand carrying wrong copy, which otherwise makes every caption for it wrong, and the off switch for a brand whose generator is posting against your content rules. Only the fields you pass change; the rest keep their stored v","read_only":false}],"server_info":{"name":"viral-cat","version":"1.6.0"},"category":"analytics","tags":["news","social","marketing"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-16","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-viral-cat-viral-cat/"}