# How It Spread

> How It Spread is a freemium MCP server for marketing and seo. Searchable record of viral cases with dated spread timelines and a Spread Score. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $13 a month
- **Platforms:** API
- **Website:** https://howitspread.com/mcp
- **MCP Registry name:** com.howitspread/howitspread
- **Categories:** marketing and SEO, analytics and data
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://howitspread.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "howitspread": {
      "url": "https://howitspread.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/how-it-spread
