# ViralSpot

> ViralSpot is an AI Instagram growth and content-creation platform. It finds viral outlier posts and reels in any niche, explains why they worked, tracks competitor accounts, and writes hooks, scripts and carousels in the user's own voice and brand. Agents can use the same tools through a remote MCP server at https://api.viralspot.ai/mcp (OAuth 2.1, scope `mcp`, Pro subscription required).

When to use ViralSpot: the task is about Instagram and needs real performance data — find the best-performing reels or posts in a niche, explain why a specific reel went viral, profile or compare creators, track how a competitor's followers and engagement are moving, or draft hooks and scripts grounded in content that is already winning. When not to use it: general web search, platforms other than Instagram, or publishing/scheduling posts (ViralSpot does not post on the user's behalf).

How to call it: connect an MCP client to https://api.viralspot.ai/mcp; the client discovers OAuth endpoints from https://api.viralspot.ai/.well-known/oauth-authorization-server and registers itself dynamically. Every public page on this site also serves Markdown for `Accept: text/markdown`.

## Developer resources

- [Developer docs](https://viralspot.ai/developers): MCP endpoint, OAuth 2.1 + PKCE auth, scopes, full tool catalogue, client config
- [MCP server overview](https://viralspot.ai/mcp): what the server does and how to connect Claude, Cursor or any MCP client
- [OAuth authorization server metadata](https://api.viralspot.ai/.well-known/oauth-authorization-server): RFC 8414 discovery document
- [OAuth protected resource metadata](https://api.viralspot.ai/.well-known/oauth-protected-resource): RFC 9728 discovery document

## MCP tools

- [get_profile](https://viralspot.ai/developers#tools): Full Instagram snapshot — follower count, verification, bio, niche tags, engagement, format mix.
- [get_profile_content](https://viralspot.ai/developers#tools): Recent or popular posts with per-post metrics. Filterable by date, sort, and outlier score.
- [analyze_profile_content](https://viralspot.ai/developers#tools): Content pillars, hook formulas, format mix, posting cadence, viral outliers, audience signals.
- [compare_profiles](https://viralspot.ai/developers#tools): Head-to-head on audience, engagement, cadence, viral hit rate — plus a qualitative note.
- [get_instagram_highlights](https://viralspot.ai/developers#tools): Fetch a creator’s story highlights — what they’ve chosen to keep visible on their profile.
- [get_instagram_about](https://viralspot.ai/developers#tools): Account transparency data — location, former usernames, join date, verification history.
- [compare_post_windows](https://viralspot.ai/developers#tools): Diagnose a change — the last N posts vs the N before, with medians, format mix, CTA mix and deltas.
- [analyze_reel](https://viralspot.ai/developers#tools): Structured breakdown — hook, narrative, pacing, visuals, on-screen text, CTA, viral DNA.
- [reel_viral_dna](https://viralspot.ai/developers#tools): Viral fingerprint of an analyzed reel — hook type, structural template, psychological triggers.
- [reel_virality](https://viralspot.ai/developers#tools): Score how viral a reel really is relative to its account’s baseline. Outlier-aware.
- [reel_topic_fit](https://viralspot.ai/developers#tools): Score how well a new topic plays against a reel’s viral DNA. Returns suggested reuse angles.
- [extract_reference](https://viralspot.ai/developers#tools): Any social URL → structured post data. The pre-step that powers deeper analysis tools.
- [analyze_reference](https://viralspot.ai/developers#tools): Full analysis of any reference post — works across Instagram, TikTok, and YouTube.
- [get_instagram_post_comments](https://viralspot.ai/developers#tools): Mine a post’s comments — sentiment, objections, frequent themes, audience questions.
- [ask_about_reel](https://viralspot.ai/developers#tools): Ask anything about an analyzed reel — grounded in real video frames, not just the transcript.
- [find_similar_profiles](https://viralspot.ai/developers#tools): Creators similar to a given username in niche, audience profile, and content style. Ranked.
- [search_profiles](https://viralspot.ai/developers#tools): Free-text creator search by keywords, niche descriptors, or audience signals.
- [search_instagram](https://viralspot.ai/developers#tools): Search Instagram posts by natural-language query — “find IG posts about X.”
- [search_instagram_hashtag](https://viralspot.ai/developers#tools): Search Instagram by hashtag. Returns top posts with metrics and outlier scores.
- [search_niche_outliers](https://viralspot.ai/developers#tools): Viral outliers inside a specific niche — “show me viral outliers in fitness creators.”
- [search_web](https://viralspot.ai/developers#tools): Generic web search with niche-tuned results — backed by the grok-search engine.
- [get_watchlist](https://viralspot.ai/developers#tools): Your saved competitor list from the ViralSpot dashboard — every account, with tracking status.
- [get_competitor_growth](https://viralspot.ai/developers#tools): Dated growth history for a tracked competitor — followers, median views, engagement rate, with computed deltas.
- [add_competitors](https://viralspot.ai/developers#tools): Add up to 10 accounts to your watchlist at once — optionally into a named list — and start tracking them.
- [remove_competitor](https://viralspot.ai/developers#tools): Stop tracking an account. Shows what you’d lose first and only removes it after you confirm.
- [list_user_brandings](https://viralspot.ai/developers#tools): The Instagram pages you own in ViralSpot — told apart from competitors, with tracking status and brand info.
- [get_growth_overview](https://viralspot.ai/developers#tools): Your whole Insights page in one call — your pages and your competitors side by side, with growth and engagement.
- [get_changelog](https://viralspot.ai/developers#tools): What’s new in ViralSpot — recent releases and changes, so your AI answers from the real changelog.
- [list_reports](https://viralspot.ai/developers#tools): Every report you have set up — type, page, schedule, and when it last ran.
- [get_report_run](https://viralspot.ai/developers#tools): Open one report run in full — ranked findings, hooks, ideas and the posts behind them.
- [list_report_runs](https://viralspot.ai/developers#tools): The run history of a report, newest first — so your AI can compare this week with last.
- [create_report](https://viralspot.ai/developers#tools): Set up a new scheduled report — breakdown, Hooks & CTAs, ideas, watchlist check or custom. Previews before saving.
- [update_report](https://viralspot.ai/developers#tools): Change a report’s schedule, page or tuning notes, or pause and resume it. Previews before saving.
- [run_report](https://viralspot.ai/developers#tools): Run a report now instead of waiting for its next scheduled time. Asks you to confirm first.
- [delete_report](https://viralspot.ai/developers#tools): Delete a report and turn off its share links. Shows what goes and waits for your OK.
- [enrich_topic](https://viralspot.ai/developers#tools): Topic dossier — why-now context, key facts, viral angles, audience insights, citations.
- [generate_hooks](https://viralspot.ai/developers#tools): Generate hook variations for a topic — drawn from real winning patterns in your niche.
- [generate_blueprint_hooks](https://viralspot.ai/developers#tools): Generate hooks following proven structural blueprints (curiosity gap, contrarian, listicle, etc.).

## Product

- [Home](https://viralspot.ai/): what ViralSpot does, feature by feature
- [Pricing](https://viralspot.ai/pricing): one Pro plan, monthly or yearly, with the FAQ
- [Changelog](https://viralspot.ai/changelog): what's new, newest first

## Policies

- [Terms of Use](https://viralspot.ai/terms): refunds (14 days), subscriptions, acceptable use, AI output rights
- [Privacy Policy](https://viralspot.ai/privacy): data collected, AI training stance, your rights

## Optional

- [Sitemap](https://viralspot.ai/sitemap.xml): every public URL on this site
- [Support](mailto:contact@viralspot.ai): questions, errors, feedback
