Skip to content

trendsmcp/reddit-trends-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

reddit-trends-mcp

Reddit Trends MCP Works with Claude Works with 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

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


Get started in 2 steps

Step 1: Get your free API key at 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 / Windsurf / Cline   (~/.cursor/mcp.json or equivalent)

{
  "mcpServers": {
    "trends-mcp": {
      "url": "https://api.trendsmcp.ai/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code / GitHub Copilot   (.vscode/mcp.json)

{
  "servers": {
    "trends-mcp": {
      "type": "http",
      "url": "https://api.trendsmcp.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop   (claude_desktop_config.json) User → Settings → Developer → Edit Config — add inside mcpServers

{
  "mcpServers": {
    "trends-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.trendsmcp.ai/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude.ai (browser)   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


Also works as a Python client

Same API key works directly in Python - no MCP host needed.

pip install reddit-trends-mcp
import os
from reddit_trends_mcp import TrendsMcpClient, SOURCE

client = TrendsMcpClient(api_key=os.environ["TRENDSMCP_API_KEY"])

series  = client.get_trends(source=SOURCE, keyword="your keyword")
growth  = client.get_growth(source=SOURCE, keyword="your keyword", percent_growth=["1M", "3M", "12M"])
top     = client.get_top_trends(type="Reddit", limit=10)

Full Python docs: trendsmcp.ai/docs

License

MIT © Trends MCP

Packages

 
 
 

Contributors

Languages