Skip to content
MCP server

How It Spread

Searchable record of viral cases with dated spread timelines and a Spread Score

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.2.2
Listing updated
2 days ago

About How It Spread

How It Spread is a freemium MCP server for marketing and seo. It runs as a hosted remote server, so there is nothing to install locally.

The catalogue holds 2,778 viral cases, each with a score, numbers, hooks, mechanics and platform history. Answers cite the case they come from, so an agent can ask for examples, such as what went viral from TikTok first, and quote the precedent. The site shows examples like a 2023 chocolate bar with a score of 66.

The server is read-only with three tools: search_cases, get_case and list_mechanics. Anyone gets search, scores, summaries and the first events of every case, plus 21 open cases in full. A free account opens full dated timelines and why a case worked, and Pro adds what to do, every sourced number and the sources.

It connects over Streamable HTTP at https://howitspread.com/api/mcp with no sign-in for the public tier, and a separate account endpoint is used for full timelines. A REST API returns the same data as JSON.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://howitspread.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "howitspread": {
      "url": "https://howitspread.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "howitspread": {
      "type": "http",
      "url": "https://howitspread.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "howitspread": {
      "serverUrl": "https://howitspread.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "howitspread": {
      "type": "http",
      "url": "https://howitspread.com/api/mcp"
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

search_cases
Search viral cases.
get_case
Get one case in detail.
list_mechanics
List spread mechanics.

What it does

Cited answers
Each result points to the case it comes from.
Spread Score
Scores each case, with hooks and mechanics.
Three read-only tools
search_cases, get_case and list_mechanics.
Tiered depth
Public summaries, free-account timelines, Pro sources.
REST API
The same cases are available as JSON, filtered by kind, mechanic or platform.

Good for

  • Find precedents for a campaign idea
  • Compare how similar trends spread across platforms
  • Cite a dated case in a report
  • Browse cases by mechanic

Pricing

Freemium, from $13 a month

Free tier; Pro $156/year ($13/mo billed yearly); Team $720/year for 3 seats

Prices change. Check howitspread.com before you buy.

How It Spread FAQ

Is sign-in needed?

Not for the public tier; full timelines use an account endpoint.

What do Pro users get?

What to do, every sourced number and the sources, plus API and MCP access to the full record.

What does Pro cost?

$156 a year after a launch discount, described as $13 a month paid yearly.

Which tools exist?

search_cases, get_case and list_mechanics.

Is How It Spread free?

How It Spread has a free plan, with paid plans for more usage or features. Paid plans start at $13 a month.

How do I add How It Spread to Claude Code?

Run this command in your terminal: claude mcp add --transport http howitspread https://howitspread.com/api/mcp

What are the best alternatives to How It Spread?

The closest alternatives to How It Spread are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and Calven.

Alternatives to How It Spread

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data