Agents Index

ViralCat

Online

Schedule and publish social posts across platforms, with drafts, media uploads and analytics.

Visit publisherConnectJSON

What it can do: 21 tools

  • list_brands read-onlyList 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` (al
  • get_brand_details read-onlyFull 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
  • list_posts read-onlyList 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|...). Ret
  • get_pipeline_summary read-onlyHigh-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 dat
  • list_connections read-onlyList 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 e
  • post_performance read-onlyPublish-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 engageme
  • content_queue read-onlyThe 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.
  • campaign_summary read-onlyPer-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.
  • diagnose_failures read-onlyGroup 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
  • preflight_check read-onlyREAD-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 m
  • create_draftWRITE (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 sl
  • schedule_postWRITE (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
  • cancel_postWRITE (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 m
  • retry_failed_postsWRITE (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_ru
  • reschedule_postWRITE (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 schedul
  • refresh_post_metricsWRITE (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 op
  • reconnect_platformWRITE (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/goog
  • upload_mediaWRITE (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
  • create_media_uploadWRITE (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 b
  • create_brandWRITE (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 Driv
  • update_brandWRITE (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 m

Connect it

Claude Code
claude mcp add --transport http viralcat https://viral-cat.com/api/mcp/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://viral-cat.com/api/mcp/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "viralcat": {
      "url": "https://viral-cat.com/api/mcp/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "viralcat": {
      "type": "http",
      "url": "https://viral-cat.com/api/mcp/mcp"
    }
  }
}

Questions

What does ViralCat do?

Schedule and publish social posts across platforms, with drafts, media uploads and analytics. It exposes 21 tools to AI assistants.

What tools does ViralCat provide?

21 tools, including list_brands, get_brand_details, list_posts, get_pipeline_summary, list_connections, post_performance, content_queue, campaign_summary, diagnose_failures, preflight_check, create_draft, schedule_post….

How do I connect ViralCat to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://viral-cat.com/api/mcp/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does ViralCat require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is ViralCat online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes ViralCat?

viral-cat.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Analytics & BI