GoViral MCP docs

GoViral is a connector that gives an AI agent market research, audience pain points, funny short-form scripts, characters and render plans.

What it is

GoViral MCP is a remote MCP server at https://goviralmcp.com/mcp. You describe a product in a brief. GoViral then sizes the market and ranks the audiences (built on Stratico Audience Intelligence, with DatosIA public data for Central American markets), finds the pain points each audience actually has, writes short funny scripts aimed at one pain point, designs recurring characters, and plans renders with a cost estimate first.

Two example products, DatosIA and AI Mail, are seeded as briefs that every account can read and use. Scores GoViral gives scripts are model-simulated and uncalibrated: the head-to-head order is more reliable than the absolute numbers.

Connect

Claude (claude.ai)

Open Settings > Connectors > Add custom connector.
Enter the URL https://goviralmcp.com/mcp and add it.
Sign in when asked (see below), then press Allow.

Claude Code

claude mcp add --transport http goviral https://goviralmcp.com/mcp

Then run /mcp in Claude Code and choose GoViral to sign in.

Other MCP clients, or scripts

Send an API key as Authorization: Bearer gvk_... or x-api-key. Keys are created on the API keys page of the console and shown once.

The OAuth sign-in, step by step

GoViral is an OAuth 2.1 server: dynamic client registration and client ID metadata documents, public clients with S256 PKCE. You never copy a key.

Your app opens the GoViral sign-in page in your browser.
Enter your email. GoViral sends a 6 digit code to it. The code expires in 10 minutes.
Enter the code. You land on the Connect screen, which names the app and where the access code will be sent.
Choose the account to connect (only accounts you own are listed) and press Allow. Press Deny to stop.
Your app receives a token that acts as that account only, with the same powers as an API key for it. Access tokens last 1 hour and refresh automatically for up to 30 days.

Each connection is emailed to the signing-in owner. You can disconnect an app at any time under Connected apps in the console.

Prerequisites

An account. GoViral accounts are set up by the operator today: there is no public sign-up page. To ask for access, email hello@goviralmcp.com.
An MCP client that supports remote servers, such as Claude on the web, Claude Desktop or Claude Code. Claude plan requirements for custom connectors depend on Claude, not on GoViral.
Pricing. GoViral has no published price list. Usage is limited by the daily budget below. Rendering that costs money is off by default and operator-only.

Tools

This table is generated from the tool list the server advertises. Read tools never change anything. Write tools save data to your account or call a model or audience service. "Destructive" means a call can overwrite data that already exists.

Tool	Title	Access	Destructive	Description
`create_product_brief`	Create or update a product brief	Write	Yes	Record what a product is, who it is for, its proof points, voice and the claims it must never make. Upserts by slug within your own account. The seeded DatosIA and AI Mail briefs belong to the operator: you can read and use them, not overwrite them, and their slugs are reserved.
`get_product_brief`	Get a product brief	Read	No	Return a product brief by slug, or list the product slugs you can use (yours and the seeded ones) when no slug is given.
`size_market`	Size the market	Write	No	Start or reuse the Stratico audience study for a product (the only tool that starts one; refresh is allowed once the study is 24 hours old) and return its audiences with low/mid/high size, confidence and a TAM/SAM/SOM view derived from the brief. A new study takes 2 to 6 minutes: if it is not ready, the answer reports progress; call again.
`get_audience`	Get an audience profile	Write	No	One audience from the product's Stratico study: the full profile plus a humor profile (what is funny to them, taboo, shared pains, in-jokes, language) and ranked pain points (situation, frustration, intensity, frequency, product fit, script angle), each derived once and cached. The first call for an audience calls the model and counts against the account's daily budget.
`rank_audiences`	Rank audiences	Read	No	Rank a product's audiences by size, fit to the brief, share intent and reachability. Formula: 0.35 size + 0.30 fit + 0.20 share intent + 0.15 reach, each 0-100; components are returned for every audience.
`analyze_pain_points`	Analyze audience pain points	Write	No	Pain point analysis for a product's audiences: per audience, 5 to 8 ranked pains (situation, frustration in their words, intensity 1-5, frequency, workaround, cost, how the product relieves it, proof, a comic script angle). Defaults to the top 3 ranked audiences. Derived once and cached; the first call (or refresh) calls the model and counts against the account's daily budget. Needs a ready study (run size_market first).
`run_analysis`	Run the GoViral analysis	Write	No	Start the GoViral analyst for a product: market sizing (TAM/SAM/SOM), audience ranking, humor profiles and pain points for the top 4 audiences, a cross-audience pain map and an executive summary. It runs in the background on the server (a few minutes; a new Stratico study takes 2 to 6). It calls the model and Stratico and counts against the account's daily budget. One active run per product: starting again returns the running one. Poll with analysis_status.
`analysis_status`	Analysis status and report	Read	No	Status, current step and (when done) the full report of a product's latest analysis run, or of a specific run_id.
`generate_scripts`	Generate scripts	Write	No	Write n short-form comedy scripts for a product and one audience. The playbook picks a humor theory, devices and format per script. Each script has a hook, timed beats with dialogue per character, on-screen text, es/en captions, props, shots, the product moment and a call to action, plus a guardrail check. Rejected scripts are stored but not returned as usable. Calls the model: each call counts against the account's daily budget.
`score_script`	Score scripts	Write	No	Score one to six scripts (rejected scripts are refused): Stratico virality score and audience response, plus the GoViral humor rubric (judged by the model). combined = 0.5 x Stratico rankScore + 0.5 x humor (0-100). With 2+ scripts, the top N are re-ranked head to head: two passes in opposite orders, combined by Borda count, because comparisons hold up and absolute scores do not. Scores are model-simulated and uncalibrated.
`punch_up`	Punch up a script	Write	No	Rewrite the weakest beats of a script to land harder with its audience. Saves the result as a new script linked to the original. Targets the beats named in beat_indexes, else the weakest beat from the last score, else the model picks.
`list_scripts`	List scripts	Read	No	List saved scripts for a product, best ranked first. Rejected scripts are hidden unless status is "rejected".
`get_script`	Get a script	Read	No	One saved script in full, with its guardrail check and scores. A rejected script is withheld (only its violations are shown) unless include_rejected is true.
`list_character_sources`	List character and media sources	Read	No	Search the researched catalogue of character, avatar, image, stock and voice sources (licence, price, API, fit). Filter by category, commercialUse (yes, with-attribution, paid-plan, no) and whether an API exists.
`design_character`	Design a character bible	Write	No	Create a character bible with the model: name, role, personality, comedic function, look, a consistency prompt reused verbatim in every image prompt, a reference sheet (3 views, 6 expressions, 4 mouth shapes), a voice description, catchphrases, never_says and a source strategy. Checked against the playbook guardrails; saved to your account. Start from the seeded cast (Pip, Maya, Datito, Doña Chepa) when it fits.
`get_character`	Get a character bible	Read	No	Return a character bible by id or slug (yours or a seeded one).
`list_characters`	List characters	Read	No	List your characters and the seeded starter cast (Pip, Maya for AI Mail; Datito, Doña Chepa for DatosIA), optionally for one product.
`plan_render`	Plan a render	Write	No	Turn a script and its characters into a render plan: one scene per beat (poses, expressions, props placement, background, camera), consistent image prompts, TTS lines per character with the voice, sfx cues, a caption track, the lip-flap method and a cost estimate. Never spends money and never calls a model. dry_run (default true) returns the plan without saving; dry_run false saves it and returns a plan_id for render_storyboard.
`render_storyboard`	Render a storyboard	Write	No	Make a self-contained HTML storyboard (scenes, dialogue, props, timings, prompts, cost estimate; placeholder art until stills exist) and return its private link, GET /storyboards/<token>. Give plan_id, or the same arguments as plan_render to plan and save in one step. No network or model needed.

Typical order: get_product_brief, size_market (a new study takes 2 to 6 minutes; call again until it is ready), rank_audiences, analyze_pain_points, generate_scripts, score_script.

Limits and safety

Rate limit: 60 requests per minute per key or connected app.
Daily budget: 300 cost units per account per UTC day. A model call costs 1, a virality score or test 2, a new audience study 10. Past the budget, tools answer budget_exceeded until 00:00 UTC.
Account limits: 20 product briefs, 30 characters and 200 render plans per account.
Nothing is sent to people. No tool sends email, SMS or posts anywhere. GoViral writes scripts; you decide what to do with them.
No media generation, no spending. This server plans renders and makes storyboards, which are free and need no model. The tools that would generate images, voice or video are switched off here and are not offered.
Guardrails. Each script is checked against rules about claims the product must never make and topics that are off limits. Rejected scripts are stored but withheld.
Your data is yours alone. A token or key can reach only its own account, plus the shared seeded example briefs, which are read only.
Storyboard links are private but unauthenticated: anyone holding the link can view that storyboard.

Support and privacy

Questions, access requests and problems: hello@goviralmcp.com. Read the privacy policy.