[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_135":136},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":57,"_58":-5,"_59":51,"_60":61,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":77,"_78":79,"_80":81,"_82":-5,"_83":-5,"_84":-5,"_85":86,"_87":-5,"_88":45,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_99":100},"apiUrl","https://odel.app/api","creator","trendsmcp","moduleId","x-twitter","@trendsmcp/x-twitter","displayName","X (Twitter) Trends MCP","tagline","Twitter (X) trends over time, with growth for any keyword. Free key at trendsmcp.ai","iconKey","external/cfbf5c15eadc2685b70583c23e2f5f08bf5011e797b080cba30fc94332a0eada.svg","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://x-twitter.api.trendsmcp.ai/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","priceCredits",0,"creatorUserId","system:external-import","createdAt",1783311997000,"updatedAt",1790459768000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=ai.trendsmcp%2Fx-twitter","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",43,"upstreamUpdatedAt",1788020894000,"detectedTransport","streamable-http","detectedAuthType","bearer","probeStatus","ok","lastProbedAt",1790444937000,"githubRepoUrl","https://github.com/trendsmcp-ai/Trends-MCP","githubRepoFullName","trendsmcp-ai/Trends-MCP","releaseId","ext-trendsmcp-x-twitter","version","1.0.6","descriptionMarkdown","

\n\n\n\n $\"Trends$ \n\n# Trends MCP\n\nLive trend data for AI agents. Google, TikTok, YouTube, Amazon, Reddit, and 30+ other sources. One MCP connection, one API key.\n\n[![PyPI](https://img.shields.io/pypi/v/trends-mcp-server)](https://pypi.org/project/trends-mcp-server/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![CI](https://github.com/trendsmcp-ai/Trends-MCP/actions/workflows/ci.yml/badge.svg)](https://github.com/trendsmcp-ai/Trends-MCP/actions/workflows/ci.yml)\n[![MCP](https://img.shields.io/badge/MCP-remote%20%2B%20stdio-blue)](https://modelcontextprotocol.io)\n[![Free tier](https://img.shields.io/badge/Free-100%20req%2Fmo-orange)](https://www.trendsmcp.ai/pricing)\n[![Glama](https://glama.ai/mcp/servers/trendsmcp-ai/Trends-MCP/badges/score.svg)](https://glama.ai/mcp/servers/trendsmcp-ai/Trends-MCP)\n\n[Get a free API key](https://www.trendsmcp.ai/account) · [Docs](https://www.trendsmcp.ai/docs) · [Pricing](https://www.trendsmcp.ai/pricing) · [Data sources](https://www.trendsmcp.ai/data-sources) · [PyPI](https://pypi.org/project/trends-mcp-server/) · [Glama](https://glama.ai/mcp/servers/trendsmcp-ai/Trends-MCP)\n\n

\n\n```\nYou: Using TrendsMCP, compare 6-month growth for GLP-1 on Google, TikTok, and Amazon.\n\nAgent: Google Search +84%\n TikTok +212%\n Amazon +61%\n```\n\nThree tools. Normalized 0–100 where the pipeline supports it. No per-platform keys. No scraping on your side.\n\n## Quick install\n\nSame four clients as the site hero. [Get a free key](https://www.trendsmcp.ai/account) 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.\n\n

\n $\"Add$ \n $\"Add$ \n $\"Add$ \n $\"Add$ \n

\n\n| Client | After you click |\n|---|---|\n| **Claude** | Connector name and URL are prefilled (`https://www.trendsmcp.ai/mcp`). Confirm, then authorize. |\n| **Cursor** | Approve the MCP install. Replace `YOUR_API_KEY` if prompted. |\n| **ChatGPT** | Enable Developer mode (Profile → Settings → Security). Name `Trends MCP`, URL `https://www.trendsmcp.ai/mcp`, then authorize. |\n| **VS Code** | Sign in on the account page and use the **VS Code** button so the key is included. |\n\nThen ask: `Using TrendsMCP, what's trending on Google right now?`\n\n**[Tools](#tools)** · **[Sources](#keyword-sources)** · **[Feeds](#live-feeds)** · **[REST](#rest-api)** · **[Install in other clients](#install-in-other-clients)**\n\n---\n\n## What this is\n\nHosted 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.\n\n| Tool | Use when | Needs a keyword? |\n|---|---|---|\n| `get_time_series` | History for one keyword on one source | Yes |\n| `get_growth` | Percent change over 7D–5Y (several windows in one call) | Yes |\n| `get_top_trends` | What is ranking on a platform right now | No |\n\n---\n\n## Install in other clients\n\nReplace `YOUR_API_KEY` with the key from [your account](https://www.trendsmcp.ai/account).\n\n

Claude Code

\n\n```bash\nclaude mcp add --scope user --transport http trends-mcp https://api.trendsmcp.ai/mcp \\\n --header \"Authorization: Bearer YOUR_API_KEY\"\n```\n

\n\n

Cursor (manual)

\n\n`~/.cursor/mcp.json` (Windows: `%USERPROFILE%\\.cursor\\mcp.json`)\n\n```json\n{\n \"mcpServers\": {\n \"trends-mcp\": {\n \"url\": \"https://api.trendsmcp.ai/mcp\",\n \"transport\": \"http\",\n \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n }\n }\n}\n```\n

\n\n

VS Code / Copilot (manual JSON)

\n\n`.vscode/mcp.json` or Command Palette → MCP: Add Server. Prefer the account-page VS Code button so the key is wired for you.\n\n```json\n{\n \"servers\": {\n \"trends-mcp\": {\n \"type\": \"http\",\n \"url\": \"https://api.trendsmcp.ai/mcp\",\n \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n }\n }\n}\n```\n

\n\n

Windsurf

\n\nUses `serverUrl`, not Cursor’s `url` + `transport`. File: `~/.codeium/windsurf/mcp_config.json`.\n\n```json\n{\n \"mcpServers\": {\n \"trends-mcp\": {\n \"serverUrl\": \"https://api.trendsmcp.ai/mcp\",\n \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" }\n }\n }\n}\n```\n

\n\n

Cline

\n\nRemote server, type **exactly** `streamableHttp`. See [llms-install.md](https://github.com/trendsmcp-ai/Trends-MCP/blob/main/llms-install.md).\n\n```json\n{\n \"mcpServers\": {\n \"trends-mcp\": {\n \"type\": \"streamableHttp\",\n \"url\": \"https://api.trendsmcp.ai/mcp\",\n \"headers\": { \"Authorization\": \"Bearer YOUR_API_KEY\" },\n \"disabled\": false\n }\n }\n}\n```\n

\n\n

Claude Desktop (no native HTTP)

\n\n```json\n{\n \"mcpServers\": {\n \"trends-mcp\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\", \"mcp-remote\",\n \"https://api.trendsmcp.ai/mcp\",\n \"--header\", \"Authorization:${AUTH_HEADER}\"\n ],\n \"env\": { \"AUTH_HEADER\": \"Bearer YOUR_API_KEY\" }\n }\n }\n}\n```\n

\n\n

Claude.ai custom connector

\n\nSettings → 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.\n

\n\n

Stdio (this repo / Glama)

\n\nHosted HTTP is still the product default. This process lists tools with no key; paid calls need `TRENDSMCP_API_KEY` and bill the same quota.\n\n```bash\npip install -e .\npython -m trends_mcp_server\n```\n\n```json\n{\n \"mcpServers\": {\n \"trends-mcp\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"trends_mcp_server\"],\n \"env\": { \"TRENDSMCP_API_KEY\": \"YOUR_API_KEY\" }\n }\n }\n}\n```\n

\n\n

Prompt tip

\n\nSay “using TrendsMCP” so the model picks these tools instead of web search. More clients: [docs](https://www.trendsmcp.ai/docs).\n

\n\n---\n\n## Tools\n\nAlways-current parameter lists: [docs](https://www.trendsmcp.ai/docs).\n\n### `get_time_series`\n\nWeekly (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.\n\n| Argument | Required | Notes |\n|---|---|---|\n| `keyword` | yes | Format depends on source (table below) |\n| `source` | yes | One source per call. Lowercase catalog names |\n| `data_mode` | no | REST only. `weekly` (default) or `daily` |\n\nIndex is 0–100 where the pipeline supports it (100 = peak in the returned window). `volume` is present when that source has an absolute series.\n\n### `get_growth`\n\nPoint-to-point percent change. Several windows in one call still count as **one** request for that source + keyword.\n\n| Argument | Required | Notes |\n|---|---|---|\n| `keyword` | yes | Same formats as `get_time_series` |\n| `source` | yes | One source, or a comma-separated list (`google search, tiktok, amazon`) |\n| `percent_growth` | no | Default `[\"12M\"]`. Presets below, or `{ \"recent\", \"baseline\", \"name\" }` date objects |\n\nPresets: `7D` `14D` `30D` `1M` `2M` `3M` `6M` `9M` `12M` `1Y` `18M` `24M` `2Y` `36M` `3Y` `48M` `60M` `5Y` `MTD` `QTD` `YTD`.\n\n### `get_top_trends`\n\nLive ranked list. **No keyword.** On MCP, `type` is required and must match the feed name **exactly** (including capitals). On REST, omit `type` only if you intend to pull every feed (billed per feed).\n\n| Argument | Required on MCP | Notes |\n|---|---|---|\n| `type` | yes | See [live feeds](#live-feeds) |\n| `limit` | no | Default 25, max 200 |\n| `offset` | no | Pagination |\n| `category` | for some types | Amazon / Google Trends / Top Websites / Substack / TikTok hashtag category boards |\n| `sort` | no | `rank` (default) or `rank_change` |\n| `window` | no | With `sort=rank_change`: `1d` `3d` `7d` `14d` `30d` |\n\n---\n\n## Prompts that route correctly\n\n```\nUsing TrendsMCP, what's trending on Google right now?\nUsing TrendsMCP, what are the hottest Reddit posts right now?\nUsing TrendsMCP, compare 6-month growth for creatine gummies on Google, TikTok, and Amazon.\nUsing TrendsMCP, show Google Search history for protein soda.\nVia TrendsMCP, pull npm download history for langchain.\nUsing TrendsMCP, show Steam concurrent players for Elden Ring.\nVia TrendsMCP, Android downloads for com.openai.chatgpt.\nUsing TrendsMCP, fastest-climbing Amazon best sellers in Toys Games this week.\n```\n\n---\n\n## Keyword sources\n\n`source` on `get_time_series` / `get_growth`. Not the same strings as `type` on live feeds.\n\n| `source` | Signal | `keyword` |\n|---|---|---|\n| `google search` | Search volume | Any phrase |\n| `google images` | Image search volume | Any phrase |\n| `google news` | News-tab volume | Any phrase |\n| `google shopping` | Shopping-tab volume | Any phrase |\n| `youtube` | YouTube search volume | Any phrase |\n| `tiktok` | Hashtag volume | Hashtag or topic (`#` optional) |\n| `reddit` | Subreddit attention | Name only, no `r/` |\n| `amazon` | Product search volume | Product or category |\n| `wikipedia` | Page views | Article title or topic |\n| `news volume` | Mention volume | Any phrase |\n| `news sentiment` | News tone | Any phrase |\n| `app downloads` | Android downloads | Play bundle id, e.g. `com.openai.chatgpt` |\n| `app rankings` | Android chart position | Bundle id |\n| `npm` | Weekly downloads | Exact package name (`react`, `@babel/core`) |\n| `steam` | Monthly concurrent players | Game display name (`Elden Ring`) |\n\n`source: \"Google Trends\"` is invalid. Use `google search` for history and `type: \"Google Trends\"` for the live board.\n\n---\n\n## Live feeds\n\n`type` on `get_top_trends`. Copy the name exactly.\n\n| `type` | Board |\n|---|---|\n| `Google Trends` | Google searches now |\n| `Google Trends by Category` | Needs `category` (e.g. `Games`) |\n| `Google News Top News` | Google News stories |\n| `TikTok Trending Hashtags` | Hashtags |\n| `TikTok Trending Hashtags by Category` | Needs `category` |\n| `TikTok Trending Searches` | In-app searches |\n| `YouTube Trending` | Videos |\n| `X (Twitter) Trending` | Topics on X |\n| `Reddit Hot Posts` | Front page |\n| `Reddit World News` | r/worldnews |\n| `Wikipedia Trending` | Most-viewed articles |\n| `Amazon Best Sellers Top Rated` | Top-rated sellers |\n| `Amazon Best Sellers by Category` | Needs `category` (e.g. `Toys Games`) |\n| `App Store Top Free` / `App Store Top Paid` | iOS charts |\n| `Google Play` | Play chart |\n| `Top Websites` | Global traffic rank; optional `category` |\n| `Spotify Top Podcasts` | Podcasts |\n| `Steam Most Played` | Live players |\n| `Substack` / `Substack by Category` | Newsletters |\n| `GitHub` | Daily trending repos |\n| `IMDb MOVIEmeter` | Movie activity |\n| `Open Library Trending Books` | Books |\n\nCategory name lists: [docs](https://www.trendsmcp.ai/docs).\n\niOS charts, GitHub repos, Spotify, IMDb, Open Library, Substack, and Top Websites are **feeds**, not `source` values. There is no `source: \"web traffic\"`.\n\n---\n\n## REST API\n\n```bash\ncurl -sS -X POST https://api.trendsmcp.ai/api \\\n -H \"Authorization: Bearer $TRENDSMCP_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"mode\":\"get_top_trends\",\"type\":\"Google Trends\",\"limit\":5}'\n```\n\n```python\nimport os, requests\n\nr = requests.post(\n \"https://api.trendsmcp.ai/api\",\n headers={\"Authorization\": f\"Bearer {os.environ['TRENDSMCP_API_KEY']}\"},\n json={\"mode\": \"get_growth\", \"source\": \"google search\", \"keyword\": \"bitcoin\", \"percent_growth\": [\"3M\", \"12M\"]},\n)\nprint(r.json())\n```\n\nPython client: [`pip install trendsmcp`](https://pypi.org/project/trendsmcp/).\n\n---\n\n## Limits and errors\n\n| Plan | Requests / month | Price |\n|---|---|---|\n| Free | 100 | $0 |\n| Starter | 1,000 | $19 |\n| Pro | 5,000 | $49 |\n| Business | 25,000 | $199 |\n\nAnnual billing is 20% less. Same source catalog on every plan. Free history and “top N” caps are on [pricing](https://www.trendsmcp.ai/pricing). Failed calls are not billed. Over quota returns `429` / `rate_limited` (no surprise overages).\n\nOne billed request:\n\n- `get_time_series`: one source + keyword\n- `get_growth`: one source + keyword (all windows in that call included)\n- `get_top_trends`: per `type` (and pagination as documented)\n\n| Status | Meaning |\n|---|---|\n| 400 | Bad or missing `source` / `type` / field |\n| 401 | Missing or invalid key |\n| 404 | No series for that keyword + source |\n| 429 | Monthly cap |\n| 500 | Upstream or internal error |\n\nDo not commit keys. Claude.ai connectors use OAuth; other clients use `Authorization: Bearer …`.\n\n---\n\n## What this does not do\n\n- Region / geo breakdown, related queries, or related topics\n- Hourly series\n- `get_time_series` across several sources in one call (use `get_growth` with a comma-separated `source` list, or several `get_time_series` calls)\n- Inventing feed names: MCP `type` must match the table\n\n---\n\n## Develop this repo\n\n```bash\npip install -e .\npython -m trends_mcp_server\n```\n\nCI: [`.github/workflows/ci.yml`](https://github.com/trendsmcp-ai/Trends-MCP/blob/main/.github/workflows/ci.yml). Security: [SECURITY.md](https://github.com/trendsmcp-ai/Trends-MCP/blob/main/SECURITY.md). Issues: [github.com/trendsmcp-ai/Trends-MCP/issues](https://github.com/trendsmcp-ai/Trends-MCP/issues).\n\n---\n\n## Links\n\n- [Account / key](https://www.trendsmcp.ai/account)\n- [Docs](https://www.trendsmcp.ai/docs)\n- [Pricing](https://www.trendsmcp.ai/pricing)\n- [llms.txt](https://www.trendsmcp.ai/llms.txt)\n- [TrendWatch](https://github.com/trendsmcp/TrendWatch) (alerts in your own GitHub repo)\n\nMIT © [Trends MCP](https://www.trendsmcp.ai)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt",1787067295000,"priceCents","trialDays","iconType","svg","upstream",{"_118":119,"_120":121,"_122":123,"_124":125,"_126":127,"_128":129},"requiredSecrets",[],"tags",[103,104,105,106,107,108,109,110,111,112,113,114,115,116,117],"assets",[],"stats",{"_101":45,"_102":45},"ratingAvg","reviewCount","ai-agent","ai-assistant","app-downloads","chatgpt","claude","cursor","github-copilot","google-trends","python","real-time-data","reddit","tiktok","trend-data","trends","typescript","topics",[103,104,105,106,107,108,109,110,130,131,132,111,112,113,114,115,116,117,133,134],"license","MIT","language","Python","registryName","ai.trendsmcp/x-twitter","homepage","https://trendsmcp.ai","packages",[],"mcp","mcp-server","model-context-protocol","web-traffic","youtube","ENV",{"_137":138,"_139":140,"_141":142,"_143":-7},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272","SENTRY_ENABLE_LOCAL"]