Integrations
Cursor Agent calls get_context after Trends MCP is saved with url, transport http, and a Bearer key. The proving call is a conversation row, not a trending board.
Cursor Agent pulls posts, videos, stories, and repos through Trends MCP get_context after the Cursor object is saved at https://api.trendsmcp.ai/mcp with transport http and a Bearer key. Ask, using TrendsMCP, for a keyword plus one of News, YouTube, TikTok, Instagram, X, Reddit, Bluesky, Hacker News, Polymarket, or GitHub. Omit limit and YouTube still prints count 10 over window_days 7. Omit comments and only the first 2 videos carry a top_comments array. hashtag true is the documented replacement for get_top_posts. On 2026-11-11 that flag still billed 1 request when TikTok and Instagram printed items []. The live MCP list in this session names get_context and does not name get_top_posts.
Host setup lives on Trends MCP for Cursor. This page is the conversation-shaped call that host guide never names. Mac and Linux: ~/.cursor/mcp.json. Windows: %USERPROFILE%\.cursor\mcp.json. Under mcpServers:
"trends-mcp": {
"url": "https://api.trendsmcp.ai/mcp",
"transport": "http",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
Key from the account page, format tmcp_live_. Fully quit Cursor. A window reload is not enough on every build. Homepage copy-config fetched 2026-11-11 still omits transport and can look pasted-complete:
{"mcpServers": {"trends-mcp": {"url": "https://api.trendsmcp.ai/mcp","headers": {"Authorization": "Bearer YOUR_API_KEY"}}}}
llms-full.txt from the same morning prints that same Cursor block without transport. How to connect Cursor to live trend data includes it. Cursor wants url plus transport http. Windsurf wants serverUrl. VS Code wants type http under servers. Claude.ai wants https://www.trendsmcp.ai/mcp for OAuth and will 401 in this file.
Ask with "using TrendsMCP" so Agent routes to the server instead of a web search. The proving prompt is a context call, not a board call.
get_context(source="YouTube", keyword="nintendo switch 2", limit=5)
get_context(source="News,GitHub", keyword="nintendo switch 2", limit=2)
get_top_trends with type YouTube Trending still ranks a live chart. That is a different tool. Do not send a board type string into get_context. Do not send source google search into get_context. REST source google search on keyword nintendo switch 2 returned 400 invalid_source, message Unknown source 'google search'. Valid: News, YouTube, TikTok, Instagram, X, Reddit, Bluesky, Hacker News, Polymarket, GitHub.
Store reviews are a third tool. get_reviews in Cursor takes App Store, Google Play, and Amazon. Those names are invalid_source here.
A 2026-11-11 MCP get_context call that sent source YouTube and keyword nintendo switch 2 with no limit, days, or comments field printed window_days 7, count 10, and requests_charged 1. Rank 1 was YouTube id trMkpK0EwSo, title "Stellar Blade - Live Action Launch Trailer - Nintendo Switch 2", published 2026-11-05T14:59:38Z, 3,697,573 views, 87,408 likes, 7,816 comments. Channel name SHIFT UP Official Channel. REST with the same body printed the same defaults and the same rank-1 id.
limit 1 is a shorter list, not a different tool. REST mode context with limit 1 returned that same Stellar Blade row. Top-level count is the sum of items across sources, not the per-source cap.
The first two videos carried top_comments. Videos 3 through 10 carried []. Rank 1's first reply was from @TFDDoll with 19,393 likes, published 2026-11-05T16:30:46Z. Rank 2 was id yKP0KDquaQ4, title "Three most useful Nintendo Switch 2 accessories #amiibo #gadget #gaming #mariokart #zelda", 35,597 views, also with 3 replies. That split is the default comments 2 behavior, not a broken Cursor connect.
Do not ask Agent to page this list. offset was not part of this pull. Lower limit if a shorter list is needed. One YouTube call already billed.
The MCP schema says comments is "Top comments for the first N items of each source, 0 to 5. Default 2." The 2026-11-11 YouTube pulls matched that wording, not "N replies on every row."
Omit comments and videos 1 and 2 carried 3 top_comments objects each. MCP comments 0 with limit 1 left rank 1's array empty, including on id apol5iNqoZI. REST comments 6 with limit 6 filled ranks 1 through 5 and left rank 6 empty. Rank 4 in that window, id s8XMhVZM1ko, carried only 1 reply. The server clamped to 5 items. It did not 400. It also did not invent extra replies on a thin row.
OpenAPI 3.1 at https://www.trendsmcp.ai/openapi.json, fetched 2026-11-11, now has GetContextRequest. Properties on that schema are days, hashtag, keyword, limit, mode, and source. comments is missing. REST still accepted comments 6. A generated client that only emits the OpenAPI oneOf will never send it. Cursor Agent that reads the live MCP tool list will.
News, GitHub, and Polymarket rows in the source all pull left top_comments empty. The schema limits comments to YouTube, TikTok, Instagram, X, Reddit, Bluesky, and Hacker News. Set comments 0 when the job is titles and engagement only.
llms.txt, docs.md, and data-catalog.md last updated 2026-11-11 all name the option. The OpenAPI request object still skips it.
hashtag true tells TikTok and Instagram to treat the keyword as one exact tag and return that platform's own top posts. Other sources still search the phrase. Default is false. llms-full.txt fetched 2026-11-11 documents the flag. The older get_context product page, lastmod 2026-10-26, never names it.
MCP get_context with source TikTok, keyword fitness, hashtag true, and limit 1 returned envelope statusCode 502, window_days 7, count 0, items [], and requests_charged 1. Source-level error was source unavailable. The note was TikTok's top videos for #fitness, in TikTok's order; days does not filter them. REST with Instagram booktok and TikTok booktok printed the same empty shape, same charge, same "days does not filter" note.
An empty items array is still an answer. Failed 400s are free. This 502 billed. Do not ask Agent to retry hashtag calls in a loop. One call already spent the request. Switch to a keyword search on YouTube or News, or stop.
REST still serves the dropped posts mode. POST https://api.trendsmcp.ai/api with mode get_top_posts, source tiktok, keyword fitness, and limit 1 returned HTTP 200, count 1, and https://www.tiktok.com/@acavallaro7/video/7704795647735614750, posted 2026-11-05, 1,400,000 plays, 151,500 likes. Cursor Agent that reads the live MCP list will not offer that call. The existing get-top-posts-in-cursor page still tells Agent to call it. HTML /docs still contains one leftover get_top_posts comment describing that posts array.
The MCP tool description says all equals 10 sources and costs 10. Valid names: News, YouTube, TikTok, Instagram, X, Reddit, Bluesky, Hacker News, Polymarket, GitHub. A 2026-11-11 REST call with source all, keyword nintendo switch 2, limit 1, and comments 0 printed ten sources objects, top-level count 5, and requests_charged 6.
YouTube, News, Bluesky, Hacker News, and GitHub each returned 1 item. Polymarket returned count 0, error null, and the note markets are not limited to the window; they are open events. That empty market object still counted toward the 6 charged. TikTok, Instagram, X, and Reddit returned source unavailable and were not billed.
News rank 1 was a CNET cluster, title "The Switch 2 Zelda: Ocarina of Time Is a Brilliant Remake", published 2026-11-04T11:00:02Z, outlet_count 8, article_count 9. GitHub rank 1 was zortos293/Lichii, 8,262 stars, 1,335 forks, language C++, kind repo. Bluesky rank 1 was https://bsky.app/profile/wario64.bsky.social/post/3mzwbygdbe22g, 326 likes. Hacker News rank 1 was id 50431971, title "Making a €40 USB-C hub work as a Nintendo Switch 2 dock", score 4.
A six-name comma list also succeeded. MCP source YouTube,TikTok,Reddit,News,GitHub,X with limit 1 returned HTTP 200, count 3, and requests_charged 3. YouTube, News, and GitHub answered. TikTok, Reddit, and X did not. The get_context page from 2026-10-26 still says six names return 400 too_many_sources. That error did not fire on this pull. docs.md error table fetched 2026-11-11 still omits too_many_sources. Treat five as a stale cap, not the live one.
Omit REST source and the message is source is required: one or more of News, YouTube, TikTok, Instagram, X, Reddit, Bluesky, Hacker News, Polymarket, GitHub (comma-separated). Omit keyword and the message is keyword is required: any name or phrase. Those 400s are free.
The MCP tool list in this session advertised get_time_series, get_growth, get_top_trends, get_context, get_reviews, and get_usage. Six tools. Five of them bill. get_usage is free. get_top_posts is absent.
A garbage REST mode getcontext returned envelope statusCode 400, error invalid_mode, and valid_modes get_context, get_growth, get_reviews, get_time_series, get_top_trends. The aliases object named aliases for get_time_series, get_growth, get_top_trends, and get_reviews. It omitted get_context, even though mode context had just returned the Stellar Blade row. OpenAPI maps GetContextRequest now. It still has no GetReviewsRequest, and the 200 example set still omits a reviews payload.
Nightly conversation tracking belongs on REST, not an Agent loop that only runs when Cursor is open. Connecting is free. Calling is not. get_usage at the start of this run printed Business 4,012 of 25,000 used, then 4,027, reset 2026-12-01. buy_credits_url on that payload still uses the apex account billing tab:
https://trendsmcp.ai/account?tab=billing
Site links on this page stay on www.
Free plan 100 requests a month. Starter $19 for 1,000. Pro $49 for 5,000. Business $199 for 25,000. source all billed 6 this morning because six data types answered. Looping hashtag retries against a 502 finishes the free plan before the ticket is written.
FAQ