viral.app MCP server

viral-app-agents

Official viral.app plugins and install shortcuts for coding agents and chat apps. One install connects your agent to the viral.app MCP server: 50+ tools for social analytics, account and video tracking, tags and workflows, Creator Hub, and live TikTok/Instagram/YouTube/Facebook lookups, plus a usage skill that teaches the agent how to use them well.

The MCP server lives at https://viral.app/api/mcp (streamable HTTP, OAuth). You need a viral.app account with API access. Manage everything at viral.app/app/org/api/agents.

Install

Every client signs in with OAuth in your browser. viral.app supports dynamic client registration, so you never paste a client ID, secret, or API key. During consent you pick one organization.

Chat apps: Claude.ai and Claude Desktop · ChatGPT · Grok · Other chat apps

Plugins (MCP server + skill): Claude Code · Codex CLI · GitHub Copilot CLI · VS Code · Cursor · Gemini CLI · Qwen Code · Kiro · Devin · Factory Droid · Grok Build

MCP server only: Augment · JetBrains Junie · OpenCode · Amp · Goose · Zed · Warp · Mistral Vibe · Any other MCP client

Chat apps

Claude.ai and Claude Desktop

Add a custom connector with this URL, and leave client ID and secret empty:

https://viral.app/api/mcp

Open the connector settings or go to Settings, Connectors, Add custom connector.

ChatGPT

Install the viral.app plugin for ChatGPT.

Grok

On grok.com, open Connectors, choose New Connector, then Custom, and paste https://viral.app/api/mcp.

For Grok Bot, install viral.app from its Marketplace once it is listed there.

Other chat apps

These accept a custom remote MCP URL with OAuth. Use https://viral.app/api/mcp:

• Perplexity: Settings, Connectors, Custom connector, Remote. Pick OAuth and Streamable HTTP.
• Mistral Vibe (formerly Le Chat), Work mode: Connectors, Add Connector, Custom MCP Connector. Only admins can add connectors; use a name without special characters, such as viralapp.
• Notion custom agents (Business and Enterprise): an admin enables custom MCP servers under Settings, Connections. Then open the agent's Tools & Access, Add connection, Custom MCP server.

Plugins

Claude Code

claude plugin marketplace add https://github.com/fmd-labs/viral-app-agents
claude plugin install viral-app@viral-app

Or interactively: /plugin marketplace add https://github.com/fmd-labs/viral-app-agents, then /plugin install viral-app. Afterwards run /mcp, pick viral_app, and authenticate in the browser. The fmd-labs/viral-app-agents shorthand also works if you have GitHub SSH access.

Codex CLI

codex plugin marketplace add https://github.com/fmd-labs/viral-app-agents
codex plugin add viral-app@viral-app

Or interactively: /plugins in the Codex TUI. Start a new session afterwards, then authenticate with codex mcp login viral_app.

Requires Codex CLI 0.147 or newer. Older versions fail the OAuth login with an "Authorization server response missing required issuer" error (a Codex bug fixed in 0.147.0); update with npm install -g @openai/codex@latest and retry.

If you only want the MCP server without the plugin:

codex mcp add viral_app --url https://viral.app/api/mcp
codex mcp login viral_app

GitHub Copilot CLI

Shortened. The full README is on GitHub.