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 · Sources · Boards · REST · Install in other clients

Related MCP server: npm-trends-mcp

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 mcp add --scope user --transport http trends-mcp https://api.trendsmcp.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

~/.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" }
    }
  }
}

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

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

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

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

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.

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

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": "<tool>").

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 for protein soda.
Via TrendsMCP, pull npm download history for langchain.
Using TrendsMCP, what are people saying about the Nintendo Switch 2 on Reddit and YouTube?
Via TrendsMCP, Android downloads for com.openai.chatgpt.
Using TrendsMCP, fastest-climbing Amazon best sellers in Toys Games this week.

Keyword sources

source on get_time_series and get_growth (14).

source: "Google Trends" is invalid. Use Google Search for history and type: "Google Trends" for the live board.

Live boards

type on get_top_trends (27). Copy the name exactly.

• Amazon: Amazon Best Sellers Top Rated, Amazon Best Sellers by Category

• App Store: App Store Top Free, App Store Top Paid

• GitHub: GitHub

• Google News: Google News Top News

• Google Play: Google Play

• Google Trends: Google Trends, Google Trends by Category

• IMDb: IMDb MOVIEmeter

• Open Library: Open Library Trending Books

• Pinterest: Pinterest Trending, Pinterest Trending by Category

• Polymarket: Polymarket Top Markets

• Reddit: Reddit Hot Posts, Reddit World News

• Web: Top Websites

• Spotify: Spotify Top Podcasts

• Steam: Steam Most Played

• Substack: Substack, Substack by Category

• TikTok: TikTok Trending Hashtags, TikTok Trending Hashtags by Category, TikTok Trending Searches

• Wikipedia: Wikipedia Trending

• X: X (Twitter) Trending

• YouTube: YouTube Trending

Category names per board: data catalog.

REST API

curl -sS -X POST https://api.trendsmcp.ai/api \
  -H "Authorization: Bearer $TRENDSMCP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode":"get_top_trends","type":"Google Trends","limit":5}'

import os, requests

r = requests.post(
    "https://api.trendsmcp.ai/api",
    headers={"Authorization": f"Bearer {os.environ['TRENDSMCP_API_KEY']}"},
    json={"mode": "get_growth", "source": "google search", "keyword": "bitcoin", "percent_growth": ["3M", "12M"]},
)
print(r.json())

Python client: pip install trendsmcp.

Limits and errors

Yearly billing: Starter $16/mo, Pro $39/mo, Business $159/mo. Every plan reads every data set; Top Posts is on Business. Failed calls are free.

Pay as you go: one-time credit packs, no subscription ($15 for 600, $49 for 2,500, $199 for 12,000 credits). 1 credit = 1 request. Credits never expire and are used after a plan's monthly requests run out. Pricing.

What one request is:

• get_time_series: one source + keyword

• get_growth: one keyword, every window in the call included

• get_top_trends: MCP 1 per 10 rows (max 10 per call); REST 1 per call

• get_context: MCP 1 per source (max 5 per call); REST one source per call

• get_top_posts: 1 per call

• get_usage: free

When the monthly requests are used up and no credits are left, calls are refused with monthly_limit_reached and a link to buy credits or upgrade. Over MCP, get_usage shows what is left.

Full error codes: docs. Do not commit keys. Claude.ai and ChatGPT connectors use OAuth; other clients use Authorization: Bearer ….

What this does not do

• Related queries or related topics

• Hourly series (Google and YouTube go down to daily for the last 90 days)

• get_time_series across several sources in one call (use get_growth with a comma-separated source list, or several get_time_series calls)

• Inventing board names: type must match the table

Develop this repo

pip install -e .
python -m trends_mcp_server

CI: .github/workflows/ci.yml. Security: SECURITY.md. Issues: github.com/trendsmcp-ai/Trends-MCP/issues.

Links

• Account / key

• Docs

• Pricing

• llms.txt

• TrendWatch (alerts in your own GitHub repo)

MIT © Trends MCP