trendsmcp-ai/Trends-MCP

Live trend data for AI agents. Google, TikTok, YouTube, Amazon, Reddit, and 30+ other sources. One MCP connection, one API key.
Get a free API key · Docs · Pricing · Data sources · PyPI · Glama
Three tools. Normalized 0–100 where the pipeline supports it. No per-platform keys. No scraping on your side.
Quick install
Same four clients as the site hero. Get a free key first (100 req/mo). Claude and ChatGPT sign you in with OAuth. Cursor and VS Code: click, then put your key from /account if the deeplink used a placeholder.
| Client | After you click |
|---|---|
| **Claude** | Connector name and URL are prefilled (https://www.trendsmcp.ai/mcp). Confirm, then authorize. |
| **Cursor** | Approve the MCP install. Replace YOUR_API_KEY if prompted. |
| **ChatGPT** | Enable Developer mode (Profile → Settings → Security). Name Trends MCP, URL https://www.trendsmcp.ai/mcp, then authorize. |
| **VS Code** | Sign in on the account page and use the **VS Code** button so the key is included. |
Then ask: Using TrendsMCP, what's trending on Google right now?
**Tools** · **Sources** · **Feeds** · **REST** · **Install in other clients**
---
What this is
Hosted MCP at https://api.trendsmcp.ai/mcp. Same Bearer key for POST https://api.trendsmcp.ai/api. This repo also has a stdio adapter for Glama and local hosts.
| Tool | Use when | Needs a keyword? |
|---|---|---|
| get_time_series | History for one keyword on one source | Yes |
| get_growth | Percent change over 7D–5Y (several windows in one call) | Yes |
| get_top_trends | What is ranking on a platform right now | No |
---
Install in other clients
Replace YOUR_API_KEY with the key from your account.
Claude Code
Cursor (manual)
~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json)
VS Code / Copilot (manual JSON)
.vscode/mcp.json or Command Palette → MCP: Add Server. Prefer the account-page VS Code button so the key is wired for you.
Windsurf
Uses serverUrl, not Cursor’s url + transport. File: ~/.codeium/windsurf/mcp_config.json.
Cline
Remote server, type **exactly** streamableHttp. See llms-install.md.
Claude Desktop (no native HTTP)
Claude.ai custom connector
Settings → Connectors → add https://www.trendsmcp.ai/mcp. This path uses OAuth on www.trendsmcp.ai. Do not put a Bearer key in that connector config.
Stdio (this repo / Glama)
Hosted HTTP is still the product default. This process lists tools with no key; paid calls need TRENDSMCP_API_KEY and bill the same quota.
Prompt tip
Say “using TrendsMCP” so the model picks these tools instead of web search. More clients: docs.
---
Tools
Always-current parameter lists: docs.
get_time_series
Weekly (or daily) history for **one** source + keyword. Same name on MCP and REST (mode: "get_time_series"). REST also accepts get_trends as an alias.
| Argument | Required | Notes |
|---|---|---|
| keyword | yes | Format depends on source (table below) |
| source | yes | One source per call. Lowercase catalog names |
| data_mode | no | REST only. weekly (default) or daily |
Index is 0–100 where the pipeline supports it (100 = peak in the returned window). volume is present when that source has an absolute series.
get_growth
Point-to-point percent change. Several windows in one call still count as **one** request for that source + keyword.
| Argument | Required | Notes |
|---|---|---|
| keyword | yes | Same formats as get_time_series |
| source | yes | One source, or a comma-separated list (google search, tiktok, amazon) |
| percent_growth | no | Default ["12M"]. Presets below, or { "recent", "baseline", "name" } date objects |