Metadata-Version: 2.4
Name: reddit-trends-mcp
Version: 1.0.0
Summary: Reddit mention volume as an MCP tool. Plug into Claude, Cursor, or any MCP-compatible AI host. Weekly series, growth percentages, and live Reddit trending posts. Powered by trendsmcp.ai
Project-URL: Homepage, https://trendsmcp.ai
Project-URL: Documentation, https://trendsmcp.ai/docs
Project-URL: Repository, https://github.com/trendsmcp/reddit-trends-mcp
Project-URL: Get API Key, https://trendsmcp.ai
Author-email: Trends MCP <hello@trendsmcp.ai>
License-Expression: MIT
License-File: LICENSE
Keywords: ai-tools,claude,cursor,mcp,model-context-protocol,reddit,reddit-mcp,reddit-trends,trend-data,trendsmcp
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Requires-Dist: trendsmcp>=1.0.0
Description-Content-Type: text/markdown

# reddit-trends-mcp

[![Reddit Trends](https://img.shields.io/badge/Reddit%20Trends-FF4500?style=flat-square)](https://trendsmcp.ai/reddit-trends)
[![MCP](https://img.shields.io/badge/MCP-compatible-blue?style=flat-square)](https://modelcontextprotocol.io)
[![Works with Claude](https://img.shields.io/badge/Claude-supported-orange?style=flat-square)](https://trendsmcp.ai/mcp-server-for-claude)
[![Works with Cursor](https://img.shields.io/badge/Cursor-supported-purple?style=flat-square)](https://trendsmcp.ai/mcp-server-for-cursor)

> **Reddit discussion trend data for AI**
> Measure how much Reddit is talking about any topic. Community discussion volume, growing subreddit interest, and historical activity data - all queryable from your AI without hitting Reddit API limits.

**Full docs and live demo:** [https://trendsmcp.ai/reddit-trends](https://trendsmcp.ai/reddit-trends)

Part of **[Trends MCP](https://trendsmcp.ai)** -- the MCP server for live trend data across 12+ sources.
See the main repo: [https://github.com/trendsmcp/trends-mcp](https://github.com/trendsmcp/trends-mcp)

---

## Get started in 2 steps

**Step 1:** Get your free API key at **[trendsmcp.ai](https://trendsmcp.ai)**
100 requests/day, no credit card required.

**Step 2:** Add to your AI client (replace `YOUR_API_KEY`):

[**+ Add to Cursor (one click)**](cursor://anysphere.cursor-deeplink/mcp/install?name=trends-mcp&config=eyJ1cmwiOiAiaHR0cHM6Ly9hcGkudHJlbmRzbWNwLmFpL21jcCIsICJ0cmFuc3BvcnQiOiAiaHR0cCJ9)

**Cursor / Windsurf / Cline** &nbsp; (`~/.cursor/mcp.json` or equivalent)
```json
{
  "mcpServers": {
    "trends-mcp": {
      "url": "https://api.trendsmcp.ai/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**VS Code / GitHub Copilot** &nbsp; (`.vscode/mcp.json`)
```json
{
  "servers": {
    "trends-mcp": {
      "type": "http",
      "url": "https://api.trendsmcp.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**Claude Desktop** &nbsp; (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "trends-mcp": {
      "url": "https://api.trendsmcp.ai/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**Claude.ai** (browser) &nbsp; Settings -> Connectors -> Add custom connector:
```
https://api.trendsmcp.ai/mcp
```

---

## Example query

After connecting, ask your AI:
```
get_trends(keyword='electric vehicles', source='reddit', data_mode='weekly')
```

---

## Available tools

| Tool | What it does |
|------|-------------|
| `get_trends` | Time-series for a keyword on this source |
| `get_growth` | Growth % over 1W, 1M, 3M, 6M, 1Y periods |
| `get_top_trends` | What is trending right now on this source |
| `get_ranked_trends` | Top topics ranked by volume |

---

## FAQ

### What Reddit data does Trends MCP provide?

Reddit discussion volume trends - normalized interest in a topic across the platform over time, including growth rate and historical time series. Not raw post counts, but a normalized demand signal calibrated for trend comparison.

### Is this useful for tracking community sentiment around a brand?

For volume signals, yes. Trends MCP shows whether discussion around a brand is growing or shrinking. For sentiment, the News source gives sentiment scores; Reddit gives pure volume context.

### Can I track a specific subreddit?

The current signal is platform-wide Reddit discussion volume for a keyword. Subreddit-level filtering is on the roadmap.

### How does Reddit trend data complement Google Trends?

Reddit often reflects niche, enthusiast, and early-adopter communities before topics reach mainstream Google Search. Comparing both reveals whether interest is still underground or going mainstream.

---

## All data sources

Trends MCP covers 12+ sources in one connection:
Google Search, YouTube, TikTok, Reddit, Amazon, Wikipedia,
News Sentiment, Web Traffic, App Downloads, Steam, npm, and more.

Browse all: [https://trendsmcp.ai/data-sources](https://trendsmcp.ai/data-sources)

---

## License

MIT &copy; [Trends MCP](https://trendsmcp.ai)