{"ok":true,"site":{"host":"trendsagi.com","url":"https://trendsagi.com/","type":"live","desc":"TrendsAGI gives paid social and search teams live trend intelligence for reviewing audience and keyword updates across Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Microsoft Ads, Snapchat Ads,…","tools":[{"name":"search_trendsagi_docs","kind":"answer","impl":"imperative","description":"Search TrendsAGI's documentation, API reference, integration guides, pricing and FAQs. Returns the best-matching pages with a link and a short summary. Use for questions about what TrendsAGI does, what it costs or how to use its API, MCP server or SDK.","title":"Search TrendsAGI docs","annotations":{"readOnlyHint":true,"untrustedContentHint":false},"inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Words to look for, e.g. 'webhook signature' or 'Scale plan price'."},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5,"description":"Most results to return, from 1 to 10."}},"required":["query"],"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","description":"The pages that match, best first.","properties":{"query":{"type":"string","description":"The query as given."},"results":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri","description":"Link to the page, with its section anchor."},"section":{"type":"string","description":"Which part of the docs the page belongs to."},"summary":{"type":"string","description":"The page's opening text, up to 320 characters."}},"required":["title","url","summary"]}}},"required":["query","results"]},{"type":"object","description":"Returned instead when the call cannot be answered.","properties":{"error":{"type":"string","enum":["invalid_arguments","unavailable"],"description":"What went wrong."},"detail":{"type":"string","description":"Why, in a sentence."},"hint":{"type":"string","description":"What to do next."}},"required":["error","detail"]}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/webmcp","/tools/google-trends-to-search-volume","/tools/break-even-roas-calculator","/mcp","/subscription"]},{"name":"list_trend_reports","kind":"answer","impl":"imperative","description":"List the reports TrendsAGI published about topics rising now, fastest-rising first, each with its measured velocity in posts per hour and a link to the report. Public and free. For the full live trend feed with category and keyword filters, the user signs in to the TrendsAGI app.","title":"List trend reports","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":20,"default":10,"description":"Most reports to return, from 1 to 20."}},"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","description":"Published trend reports, fastest-rising first.","properties":{"reports":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"The report's headline, which names the trending topic."},"url":{"type":"string","format":"uri","description":"Link to the public report."},"velocity_posts_per_hour":{"type":["number","null"],"description":"Measured posts per hour about the topic, or null when not yet measured."},"velocity_measured_at":{"type":["string","null"],"description":"When the velocity was measured, as an ISO 8601 timestamp."},"sentiment":{"type":["string","null"],"description":"Overall sentiment of the conversation, e.g. positive, negative or mixed."},"published_at":{"type":["string","null"],"description":"When the report was published, as an ISO 8601 timestamp."}},"required":["title","url","velocity_posts_per_hour"]}}},"required":["reports"]},{"type":"object","description":"Returned instead when the call cannot be answered.","properties":{"error":{"type":"string","enum":["invalid_arguments","unavailable"],"description":"What went wrong."},"detail":{"type":"string","description":"Why, in a sentence."},"hint":{"type":"string","description":"What to do next."}},"required":["error","detail"]}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/webmcp","/tools/google-trends-to-search-volume","/tools/break-even-roas-calculator","/mcp","/subscription"]},{"name":"estimate_search_volume_from_google_trends","kind":"act","impl":"imperative","description":"Convert Google Trends interest scores (0-100) into estimated monthly searches, using one anchor keyword whose real monthly search volume is known. Every keyword, including the anchor, must come from the same Google Trends comparison so they share one scale. Each estimate comes with a low-high range from Trends' whole-number rounding.","title":"Estimate search volume from Google Trends","annotations":{"readOnlyHint":true,"untrustedContentHint":false},"inputSchema":{"type":"object","properties":{"anchor_monthly_searches":{"type":"number","exclusiveMinimum":0,"description":"The anchor keyword's real searches per month, e.g. from Google Keyword Planner."},"anchor_trends_score":{"type":"number","exclusiveMinimum":0,"maximum":100,"description":"The anchor keyword's average Google Trends score in the comparison, from 0 to 100."},"keywords":{"type":"array","minItems":1,"maxItems":25,"description":"The other keywords from the same comparison, 1 to 25 of them.","items":{"type":"object","properties":{"name":{"type":"string","description":"The keyword as typed into Google Trends."},"trends_score":{"type":"number","minimum":0,"maximum":100,"description":"The keyword's average Google Trends score, from 0 to 100."}},"required":["name","trends_score"],"additionalProperties":false}}},"required":["anchor_monthly_searches","anchor_trends_score","keywords"],"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","description":"Estimated monthly searches for each keyword.","properties":{"results":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"trends_score":{"type":["number","null"],"description":"The Google Trends score given, or null when it was not a number from 0 to 100."},"estimated_monthly_searches":{"type":["number","null"],"description":"Estimated searches per month, or null when the score was invalid."},"low":{"type":["number","null"],"description":"Lowest monthly searches the rounded score allows."},"high":{"type":["number","null"],"description":"Highest monthly searches the rounded score allows; null when unbounded."}},"required":["keyword","estimated_monthly_searches","low","high"]}},"low_precision_anchor":{"type":"boolean","description":"True when the anchor scores under 10, so the ranges are wide."},"note":{"type":"string","description":"How to read the estimates."},"tool_page":{"type":"string","format":"uri","description":"The matching free tool page on trendsagi.com."}},"required":["results","low_precision_anchor","note","tool_page"]},{"type":"object","description":"Returned instead when the call cannot be answered.","properties":{"error":{"type":"string","enum":["invalid_arguments","unavailable"],"description":"What went wrong."},"detail":{"type":"string","description":"Why, in a sentence."},"hint":{"type":"string","description":"What to do next."}},"required":["error","detail"]}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/webmcp","/tools/google-trends-to-search-volume","/tools/break-even-roas-calculator","/mcp","/subscription"]},{"name":"calculate_break_even_roas","kind":"act","impl":"imperative","description":"Work out the break-even ROAS and the most an order can pay for its ad click or acquisition (CPA ceiling), from the order's price and costs. Use before raising ad spend. Give every amount per order and in one currency; the results are in that currency.","title":"Calculate break-even ROAS","annotations":{"readOnlyHint":true,"untrustedContentHint":false},"inputSchema":{"type":"object","properties":{"price":{"type":"number","minimum":0,"description":"Revenue per order, e.g. 80 for an $80 order."},"cogs":{"type":"number","minimum":0,"default":0,"description":"Cost of goods per order."},"shipping":{"type":"number","minimum":0,"default":0,"description":"Shipping and fulfilment cost per order."},"fees":{"type":"number","minimum":0,"default":0,"description":"Payment and platform fees per order."},"other_costs":{"type":"number","minimum":0,"default":0,"description":"Any other variable cost per order, such as packaging or returns."}},"required":["price"],"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","description":"Break-even point for ad spend on one order.","properties":{"break_even_roas":{"type":["number","null"],"description":"Revenue per unit of ad spend needed to break even, e.g. 2 means 2:1. Null when no ad spend can break even."},"max_cpa":{"type":"number","description":"Most an order can spend on advertising before it loses money, in the input currency."},"contribution_margin_pct":{"type":"number","description":"Share of the price left after costs, in percent."},"total_costs":{"type":"number","description":"Sum of the costs per order, in the input currency."},"profitable_before_ads":{"type":"boolean","description":"False when costs meet or exceed the price."},"note":{"type":"string","description":"Present when no ad spend breaks even."},"tool_page":{"type":"string","format":"uri","description":"The matching free tool page on trendsagi.com."}},"required":["break_even_roas","max_cpa","contribution_margin_pct","total_costs","profitable_before_ads","tool_page"]},{"type":"object","description":"Returned instead when the call cannot be answered.","properties":{"error":{"type":"string","enum":["invalid_arguments","unavailable"],"description":"What went wrong."},"detail":{"type":"string","description":"Why, in a sentence."},"hint":{"type":"string","description":"What to do next."}},"required":["error","detail"]}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/webmcp","/tools/google-trends-to-search-volume","/tools/break-even-roas-calculator","/mcp","/subscription"]},{"name":"score_ad_fatigue","kind":"act","impl":"imperative","description":"Score how fresh an ad, email or landing-page angle still is, from 0 (worn out) to 100 (fresh), from its age and how its metrics moved against the previous period, with a refresh recommendation.","title":"Score ad fatigue","annotations":{"readOnlyHint":true,"untrustedContentHint":false},"inputSchema":{"type":"object","properties":{"days_since_refresh":{"type":"integer","minimum":0,"description":"Days since the creative or angle last changed."},"ctr_change_pct":{"type":"number","default":0,"description":"Click-through rate change in percent, e.g. -20 for a 20% drop."},"cpa_change_pct":{"type":"number","default":0,"description":"Cost per acquisition change in percent; positive means more expensive."},"conversion_rate_change_pct":{"type":"number","default":0,"description":"Conversion rate change in percent, e.g. -10 for a 10% drop."},"search_demand_change_pct":{"type":"number","default":0,"description":"Change in search demand for the topic, in percent."}},"required":["days_since_refresh"],"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","description":"Freshness score with a recommendation.","properties":{"score":{"type":"integer","minimum":0,"maximum":100,"description":"100 is fresh, 0 is worn out."},"status":{"type":"string","enum":["Healthy","Refresh soon","Refresh now","Relaunch"]},"recommendation":{"type":"string","description":"What to do next."},"penalties":{"type":"object","description":"Points each signal took off the score; a negative number added points back.","properties":{"age":{"type":"integer"},"ctr":{"type":"integer"},"cpa":{"type":"integer"},"conversion_rate":{"type":"integer"},"search_demand":{"type":"integer"}},"required":["age","ctr","cpa","conversion_rate","search_demand"]},"tool_page":{"type":"string","format":"uri","description":"The matching free tool page on trendsagi.com."}},"required":["score","status","recommendation","penalties","tool_page"]},{"type":"object","description":"Returned instead when the call cannot be answered.","properties":{"error":{"type":"string","enum":["invalid_arguments","unavailable"],"description":"What went wrong."},"detail":{"type":"string","description":"Why, in a sentence."},"hint":{"type":"string","description":"What to do next."}},"required":["error","detail"]}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/webmcp","/tools/google-trends-to-search-volume","/tools/break-even-roas-calculator","/mcp","/subscription"]},{"name":"get_trendsagi_plans","kind":"answer","impl":"imperative","description":"Get TrendsAGI's plans with their monthly and yearly prices in USD and GBP, and what each plan adds.","title":"Get TrendsAGI plans and prices","annotations":{"readOnlyHint":true,"untrustedContentHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","description":"Every plan.","properties":{"plans":{"type":"array","items":{"type":"object","properties":{"plan":{"type":"string","description":"Plan id, e.g. developer or scale."},"monthly":{"type":"object","description":"Price per month when billed monthly.","properties":{"usd":{"type":["number","string"]},"gbp":{"type":["number","string"]}},"required":["usd","gbp"]},"yearly":{"type":"object","description":"Price per year when billed yearly.","properties":{"usd":{"type":["number","string"]},"gbp":{"type":["number","string"]}},"required":["usd","gbp"]},"includes":{"type":"array","items":{"type":"string"},"description":"What the plan includes or adds."}},"required":["plan","monthly","yearly","includes"]}},"pricing_page":{"type":"string","format":"uri"}},"required":["plans","pricing_page"]},{"type":"object","description":"Returned instead when the call cannot be answered.","properties":{"error":{"type":"string","enum":["invalid_arguments","unavailable"],"description":"What went wrong."},"detail":{"type":"string","description":"Why, in a sentence."},"hint":{"type":"string","description":"What to do next."}},"required":["error","detail"]}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/webmcp","/tools/google-trends-to-search-volume","/tools/break-even-roas-calculator","/mcp","/subscription"]},{"name":"get_ai_assistant_setup","kind":"answer","impl":"imperative","description":"Get the steps to connect TrendsAGI's tools to an AI assistant or agent: Claude, Claude Code, ChatGPT, Cursor, Grok, Gemini CLI, the Python SDK, or a browser agent through WebMCP. Every connection reads the user's TrendsAGI account and is read-only.","title":"Get AI assistant setup steps","annotations":{"readOnlyHint":true,"untrustedContentHint":false},"inputSchema":{"type":"object","properties":{"client":{"type":"string","enum":["claude","claude_code","chatgpt","cursor","grok","gemini_cli","python_sdk","webmcp"],"description":"Where the user wants TrendsAGI's tools."}},"required":["client"],"additionalProperties":false},"outputSchema":{"anyOf":[{"type":"object","description":"Setup steps for one client.","properties":{"client":{"type":"string","enum":["claude","claude_code","chatgpt","cursor","grok","gemini_cli","python_sdk","webmcp"]},"steps":{"type":"array","items":{"type":"string"},"description":"The steps, in order."},"server_url":{"type":"string","format":"uri","description":"TrendsAGI's hosted MCP server."},"docs":{"type":"string","format":"uri","description":"The full setup guide."}},"required":["client","steps","server_url","docs"]},{"type":"object","description":"Returned instead when the call cannot be answered.","properties":{"error":{"type":"string","enum":["invalid_arguments","unavailable"],"description":"What went wrong."},"detail":{"type":"string","description":"Why, in a sentence."},"hint":{"type":"string","description":"What to do next."}},"required":["error","detail"]}]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/","pages":["/","/webmcp","/tools/google-trends-to-search-volume","/tools/break-even-roas-calculator","/mcp","/subscription"]}],"category":"AI & Agents","favicon":"/favicons/trendsagi.com.png","apiSurface":"spec","toolCount":7}}