trends-agent-windsurf

Live trend data inside Windsurf. Connect Cascade to Trends MCP and your agent can pull search, social, ecommerce, news, and developer trend data without leaving the IDE.

Live trend data for AI agents. One connection. Every platform. Powered by trendsmcp.ai

Get your free API key

1. Go to trendsmcp.ai
2. Enter your email, key sent instantly
3. 100 free requests per month, no credit card

Get your free key

Connect Windsurf in 30 seconds

In Windsurf, open Settings → Advanced Settings → Cascade → Add custom server +, then paste:

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

Config file location:

• Mac / Linux: ~/.codeium/windsurf/mcp_config.json
• Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Or use the Command Palette: Windsurf: Configure MCP Servers.

You can also use the Add to Windsurf button on trendsmcp.ai when present, which opens the MCP install prompt directly inside Windsurf.

Restart Windsurf after saving the config.

What you can ask Cascade

Once connected, talk to Cascade in plain English. Include the phrase "using TrendsMCP" or "via TrendsMCP" so the agent routes to the MCP instead of doing a web search.

• "Using TrendsMCP, fetch the Google Search trend for tailwind over 1 year and write a markdown report in docs/."
• "Via TrendsMCP, get the GitHub Trending Repos for today and turn them into a JSON fixture for tests."
• "Using TrendsMCP, compare YouTube and TikTok trend history for Stanley cup and draft a content brief."
• "Via TrendsMCP, what are the App Store Top Free apps right now? Generate a typed enum for them."
• "Using TrendsMCP, fetch news sentiment for Tesla over 90 days and write a Python script that flags days below a threshold."
• "Via TrendsMCP, pull npm weekly downloads for react and vue, then plot them in a notebook."

Three tools your AI gets

• get_trends, historical time series for any keyword on any source (5 years weekly, 30 days daily where supported).
• get_growth, percentage change over any period (7D, 1M, 3M, 6M, 1Y, YTD, custom dates).
• get_top_trends, what is trending right now across live platform feeds.

All data sources in one connection

One API key gives Cascade every keyword source and every live feed below.

Keyword sources (Get Trends and Get Growth)

source	What it measures	Keyword format
google search	Google search volume	Any keyword or phrase
google images	Google image search volume	Any keyword or phrase
google news	Google News search volume	Any keyword or phrase
google shopping	Google Shopping search volume	Any keyword or phrase
youtube	YouTube search volume	Any keyword or phrase
tiktok	TikTok hashtag volume	Hashtag or topic
reddit	Subreddit subscribers	Subreddit name only, no r/ prefix
amazon	Amazon product search volume	Product name or category
wikipedia	Wikipedia page views	Article title or topic
news volume	News article mention volume	Any keyword or phrase
news sentiment	News sentiment score (positive / negative)	Any keyword or phrase
app downloads	Mobile app download estimates (Android)	Package id or app identifier
npm	npm package weekly downloads	Exact package name e.g. react
steam	Steam concurrent players (monthly)	Game display name e.g. Elden Ring

All values are normalized to a 0 to 100 scale where the pipeline supports it, so you can compare different sources directly.

Live leaderboards (Get Top Trends)

Google Trends, Google News Top News, TikTok Trending Hashtags, YouTube Trending, X (Twitter) Trending, Reddit Hot Posts, Reddit World News, Wikipedia Trending, Amazon Best Sellers Top Rated, Amazon Best Sellers by Category, App Store Top Free, App Store Top Paid, Google Play, Top Websites, Spotify Top Podcasts, Steam Most Played, GitHub Trending Repos, IMDb MOVIEmeter, Trending Books.

The source list evolves over time. Authoritative reference at trendsmcp.ai/docs.

Use cases inside Windsurf

• Code plus data tasks. Pull a real time series and have Cascade scaffold the loader, schema, and tests in one flow.
• Trend dashboards. Fetch the data, generate the chart component, and wire it into your existing app.
• Content automation. Pull GitHub Trending or npm growth and have the agent draft release notes or blog posts.
• Test fixtures from real data. Snapshot a real series for reproducible test cases.
• AI coding agents. Use trend data as live context when generating product code, marketing copy, or analytics SQL.

Pricing

Free forever for 100 requests per month. Paid plans available. See trendsmcp.ai/pricing.

Resources

• Get a free API key
• Documentation and full reference
• Pricing
• All TrendsMCP repositories

Security

Never commit your API key to a public repository. Use environment variables or your OS secret store. Keys can be rotated at any time from your TrendsMCP dashboard. The YOUR_API_KEY placeholder above is a literal string to replace with your own key after you copy the snippet locally.

License

MIT. See LICENSE.