MCP server

ViralCat Official

com.viral-cat/viral-cat

Checked 28 Oct 2026, 09:03 UTC · Connected to it and listed its tools

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

Website

At a glance

Type

MCP server

Publisher

viral-cat.com (verified by the MCP Registry)

Status

Working at last check

Tools

21

Token cost

About 6,534 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

28 Oct 2026, 09:03 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http viral-cat https://viral-cat.com/api/mcp/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.viral-cat]
url = "https://viral-cat.com/api/mcp/mcp"

Gemini CLI

{"mcpServers":{"viral-cat":{"httpUrl":"https://viral-cat.com/api/mcp/mcp"}}}

Cursor

{"mcpServers":{"viral-cat":{"url":"https://viral-cat.com/api/mcp/mcp"}}}

VS Code

{"servers":{"viral-cat":{"type":"http","url":"https://viral-cat.com/api/mcp/mcp"}}}

Antigravity

agy mcp add viral-cat https://viral-cat.com/api/mcp/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"viral-cat","server_url":"https://viral-cat.com/api/mcp/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"viral-cat","server_url":"https://viral-cat.com/api/mcp/mcp"}

Tools

• campaign_summary ~208 tokens
  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.
• cancel_post ~298 tokens
  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 (
• content_queue ~155 tokens
  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.
• create_brand ~322 tokens
  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). Pu
• create_draft ~470 tokens
  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).
• create_media_upload ~481 tokens
  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 Loc
• diagnose_failures ~225 tokens
  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.
• get_brand_details ~234 tokens
  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.
• get_pipeline_summary ~161 tokens
  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.
• list_brands ~212 tokens
  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 r
• list_connections ~159 tokens
  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.
• list_posts ~266 tokens
  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 publishWarn
• post_performance ~306 tokens
  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/t
• preflight_check ~414 tokens
  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
• reconnect_platform ~218 tokens
  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
• refresh_post_metrics ~240 tokens
  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, th
• reschedule_post ~231 tokens
  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 (ar
• retry_failed_posts ~423 tokens
  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_minu
• schedule_post ~495 tokens
  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.
• update_brand ~606 tokens
  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
• upload_media ~410 tokens
  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

Browse

• Facebook tools
• File storage
• Social media
• Email marketing
• YouTube

Related MCP servers

• SendIt
  Publish and schedule social posts, upload media, and review analytics through OAuth.
• GEN
  GEN is the creative AI video engineer. Free editor/social publishing; AI credits via card/x402.
• Sprkly
  Schedule, publish and track social posts across TikTok, Instagram, Threads and YouTube Shorts.
• XCut AI – Viral Content Research
  Find viral posts, outliers, hooks and ads on Instagram, TikTok, YouTube and Facebook, then write.
• Nuntior — Social, Messaging, Blog & Telecom MCP
  Social media, DMs, blog syndication & E.164 telecom for AI agents across 18+ networks.
• PostQuickAI
  Draft, schedule and review social posts on X, LinkedIn, Instagram, TikTok, YouTube and more.
• Postel
  Draft, schedule and publish X (Twitter) and LinkedIn posts in your own voice.
• SocialHive
  Social media management, multi-platform publishing, AI generation, and cross-channel analytics.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/com.viral-cat/viral-cat.svg)](https://aptlynx.net/servers/com.viral-cat/viral-cat)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents