Spotify Trends MCP

Trends MCP

Live trend data for AI agents: 53 data sets from 27 platforms, including Google, TikTok, YouTube, Amazon, Reddit, Pinterest, Instagram and X. One MCP connection, one API key.

Get a free API key · Docs · Pricing · Data catalog · PyPI · Glama

You: Using TrendsMCP, compare 6-month growth for GLP-1 on Google, TikTok, and Amazon.

Agent: Google Search +84% TikTok +212% Amazon +61%

5 tools plus a free usage check. History, growth, live boards, and what people are saying right now. Normalized 0–100 where the source 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.

Then ask: Using TrendsMCP, what's trending on Google right now?

[Tools](#tools) · [Sources](#keyword-sources) · [Boards](#live-boards) · [REST](#rest-api) · [Install in other clients](#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.

get_top_posts is on the Business plan. Every other tool works on every plan, Free included.

---

Install in other clients

Replace YOUR_API_KEY with the key from your account.

Claude Code

claude mcp add --scope user --transport http trends-mcp https://api.trendsmcp.ai/mcp \

--header "Authorization: Bearer YOUR_API_KEY"

</details>

Cursor (manual)

~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json)

{

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

</details>

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.

{

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

</details>

Windsurf

Uses serverUrl, not Cursor’s url + transport. File: ~/.codeium/windsurf/mcp_config.json.

{

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

</details>

Cline

Remote server, type exactly streamableHttp. See llms-install.md.

{

"mcpServers": { "trends-mcp": { "type": "streamableHttp", "url": "https://api.trendsmcp.ai/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" }, "disabled": false } } }

</details>

Claude Desktop (no native HTTP)

{

"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" } } } }

</details>

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 the product default and has every tool. This stdio adapter exposes get_time_series, get_growth and get_top_trends; use the hosted server for get_context, get_top_posts and get_usage. It lists tools with no key; calls need TRENDSMCP_API_KEY and bill the same quota.

pip install -e .

python -m trends_mcp_server

{

"mcpServers": { "trends-mcp": { "command": "python", "args": ["-m", "trends_mcp_server"], "env": { "TRENDSMCP_API_KEY": "YOUR_API_KEY" } } } }

</details>

Prompt tip

Say “using TrendsMCP” so the model picks these tools instead of web search. More clients: docs.

---

Tools

Always-current parameter lists: docs and data catalog. Same names on MCP and REST ("mode": " ").

get_time_series

About five years of weekly history for one source + keyword, as a 0–100 index plus volume where the source has it.

get_growth

Point-to-point percent change. Several windows in one call still count as one request.

Any number with D, W, M or Y up to 5 years, plus MTD QTD YTD. Common: 7D 1W 14D 2W 30D 1M 2M 3M 6M 9M 12M 1Y 18M 24M 2Y 36M 3Y 48M 4Y 60M 5Y MTD QTD YTD.

get_top_trends

Live ranked board. No keyword. type must match the board name exactly (including capitals).

MCP bills 1 request per 10 rows (at most 10 per call). REST bills 1 request per call. Free plan: top 10, about 24 hours behind.

get_context

What people are posting, reading and betting about a keyword right now: posts, videos, stories, comments and markets, with engagement.

Sources: News, YouTube, TikTok, Instagram, X, Reddit, Bluesky, Hacker News, Polymarket, GitHub. MCP bills 1 request per source.

get_top_posts

Live top posts for one hashtag, fetched on every call. Business plan. 1 request per call.

get_usage

Free, MCP only. Your plan, requests used and left this month, and the reset date.

---

Prompts that route correctly

Using TrendsMCP, what's trending on Google right now?

Using TrendsMCP, why is Clayface trending? Show me the posts and stories behind it. Using TrendsMCP, compare 6-month growth for creatine gummies on Google, TikTok, and Amazon. Using TrendsMCP, show Google Search history