# Trends MCP

> Trends MCP gives AI assistants and code live trend data: 49 data sets from 26 platforms (Google, Google Images, Google News, Google Shopping, YouTube, Wikipedia, TikTok, Amazon, npm, PyPI, Steam, Google Play, App Store, GitHub, Google Trends, IMDb, Open Library, Reddit, Web, Spotify, Substack, X, Instagram, Bluesky, Hacker News, Polymarket), through 5 tools over MCP or a REST API. About five years of weekly history where the source has it. One free API key for both.

- MCP, sign in (Claude, ChatGPT): `https://www.trendsmcp.ai/mcp`. No key to paste.
- MCP, API key (Cursor, VS Code, Claude Code, other clients): `https://api.trendsmcp.ai/mcp`
- REST: `POST https://api.trendsmcp.ai/api` with a JSON body; `mode` picks the tool
- Auth: `Authorization: Bearer YOUR_API_KEY` (the bare key works too). Free key: https://www.trendsmcp.ai/account (email and an 8-digit code, no card)

## Tools

- `get_time_series`: Full history for one topic. About five years of weekly history for one keyword on one source, as a 0 to 100 index plus volume where the source has it. Cost: 1 request per call.
- `get_growth`: How fast something is rising. Point-to-point growth over one or more windows, on one source or several in the same call. Cost: 1 request per call, every window included.
- `get_top_trends`: What's moving right now. A live ranked board with no keyword: the current leaders, or the biggest climbers against an earlier snapshot. Cost: MCP: 1 request per 10 rows, at most 10 per call. REST: 1 request per call.
- `get_context`: What people are saying. What people are posting, reading and betting about a keyword right now: posts, videos, stories, comments and markets from each source, with engagement. Cost: MCP: 1 request per source, at most 5 per call. REST: one source per call, 1 request.
- `get_top_posts`: Top posts for one hashtag. Live top posts for one hashtag, fetched on every call. Business plan. Cost: 1 request per call.
- `get_usage`: Free. MCP only: your plan, requests used and left, reset date.

## Plans

| Plan | Monthly | Billed yearly | Requests a month | Keyword alerts | Top trends rows | Top Posts |
|---|---|---|---|---|---|---|
| Free | $0 | - | 100 | - | Top 10, 24h delay | - |
| Starter | $19/mo | $16/mo ($192 a year) | 1,000 | 10 | Top 25 | - |
| Pro | $49/mo | $39/mo ($468 a year) | 5,000 | 50 | Top 100 | - |
| Business | $199/mo | $159/mo ($1,910 a year) | 25,000 | 250 | Full board | yes |

## Docs

- [Everything in one file](https://www.trendsmcp.ai/llms-full.txt): setup per client, every tool, data set, plan and error
- [API reference](https://www.trendsmcp.ai/docs.md): tools, parameters, examples, responses, errors
- [Data catalog](https://www.trendsmcp.ai/data-catalog.md): every data set, keyword format, option and category
- [Pricing](https://www.trendsmcp.ai/pricing.md): plans, prices and what counts as a request
- [OpenAPI](https://www.trendsmcp.ai/openapi.json): the REST contract
- [Get a free API key](https://www.trendsmcp.ai/account)

## Optional

- [Homepage](https://www.trendsmcp.ai/): Connect your AI to live trend data
- [Docs](https://www.trendsmcp.ai/docs): MCP and API reference
- [Data catalog](https://www.trendsmcp.ai/data-catalog): Every data set, tool and option
- [Pricing](https://www.trendsmcp.ai/pricing): Free, Starter, Pro and Business
- [Use cases](https://www.trendsmcp.ai/use-cases): Market research, SEO, content, e-commerce and more
- [Trending](https://www.trendsmcp.ai/trending): Daily trend reports across all platforms
- [Category boards](https://www.trendsmcp.ai/trending-categories): Daily top 10 lists by category
- [Blog](https://www.trendsmcp.ai/blog): Trend analysis and AI workflows
- [Claude setup](https://www.trendsmcp.ai/mcp-server-for-claude): Claude.ai, Desktop and Claude Code
- [ChatGPT setup](https://www.trendsmcp.ai/mcp-server-for-chatgpt)
- [Cursor setup](https://www.trendsmcp.ai/mcp-server-for-cursor)
- [VS Code setup](https://www.trendsmcp.ai/mcp-server-for-vs-code)
- [Sitemap](https://www.trendsmcp.ai/sitemap): Every page and report
- [Terms](https://www.trendsmcp.ai/terms)
- [Privacy](https://www.trendsmcp.ai/privacy)