# Trends Agents Docs Last updated: 2026-10-27 > Markdown mirror of [Docs](https://trendsagents.com/docs). HTML UI: [docs](https://trendsagents.com/docs) · [Connect](https://trendsagents.com/docs#connect) · [llms.txt](https://trendsagents.com/llms.txt) Two MCP hosts (not interchangeable): - `https://api.trendsmcp.ai/mcp` : Bearer API key - `https://trendsagents.com/mcp` : OAuth for Claude.ai Connectors only REST: `POST https://api.trendsmcp.ai/api` with `Authorization: Bearer ` ## MCP tools Human titles and wire names: | MCP tool name | Title | REST `mode` | What it returns | | --- | --- | --- | --- | | `get_time_series` | Get Time Series | `get_time_series` (aliases: `get_trends`, `trends`, `time_series`, `lookup`) | ~5 years weekly series for one source + keyword | | `get_growth` | Get Growth | `get_growth` (alias: `growth`) | % change over one or more periods | | `get_top_trends` | Get Top Trends | `get_top_trends` (alias: `top_trends`) | Live ranked feed (no keyword) | | `get_top_posts` | Get Top Posts | `get_top_posts` (alias: `top_posts`) | Live top posts for one hashtag on TikTok or Instagram. Business plan | | `get_usage` | Get Usage | MCP only | Your plan, requests used and left this month, reset date. Free | Canonical names match the MCP tools. Prefer `get_time_series` in examples on both REST and MCP. Tools are read-only. ## Get an API key 1. Open [Account](https://trendsagents.com/account). 2. Enter your email and submit. No credit card, no password. 3. Enter the 8-digit code we email you (subject "... is your Trends Agents sign-in code"). 4. Your key is then revealed on the page; it was also emailed to you (format `tmcp_live_…`). 5. Replace `YOUR_API_KEY` in the client configs below with that key. 6. Use it as `Authorization: Bearer ` for REST and for MCP on `api.trendsagents.com`. Claude.ai Connectors use OAuth against `www.trendsmcp.ai/mcp` — no API key in that connector config. ## Setup Primary UI (MCP + REST): [Docs → Connect](https://trendsagents.com/docs#connect) ### Claude (claude.ai — OAuth connector, recommended) Uses the **www** OAuth endpoint, not api. Claude.ai → Settings → Customize → Connectors → Add custom connector - Name: Trends Agents - Server URL: `https://trendsagents.com/mcp` (OAuth — intentional; different from api.) Claude handles OAuth automatically — no API key in the connector config. Deep link: `https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Trends%20Agents&connectorUrl=https%3A%2F%2Fwww.trendsmcp.ai%2Fmcp` - [MCP setup for Claude](https://trendsagents.com/mcp-server-for-claude): Desktop, claude.ai connector, and Claude Code ### Claude Desktop User → Settings → Developer → Edit Config — add inside `mcpServers` (Bearer on **api**) ```json "trends-mcp": { "command": "npx", "args": ["-y", "mcp-remote", "https://api.trendsagents.com/mcp", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer YOUR_API_KEY" } } ``` Mac: `~/Library/Application Support/Claude/claude_desktop_config.json` Windows: `%APPDATA%\Claude\claude_desktop_config.json` Fully quit and restart Claude Desktop after saving. ### Claude Code (CLI) ``` claude mcp add --transport http trends-mcp https://api.trendsagents.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` ### Cursor Cursor Settings → Tools & MCP → Add a Custom MCP Server (or use the Add to Cursor deep link on docs) ```json "trends-mcp": { "url": "https://api.trendsagents.com/mcp", "transport": "http", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } ``` Mac/Linux: `~/.cursor/mcp.json` — Windows: `%USERPROFILE%\.cursor\mcp.json` - [MCP setup for Cursor](https://trendsagents.com/mcp-server-for-cursor) ### Windsurf Cascade MCP panel → Configure / Add custom server (or Command Palette → `Windsurf: Configure MCP Servers`). Windsurf remote HTTP uses `serverUrl` (not Cursor’s `url` + `transport`). ```json "trends-mcp": { "serverUrl": "https://api.trendsagents.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } ``` Mac/Linux: `~/.codeium/windsurf/mcp_config.json` Windows: `%USERPROFILE%\.codeium\windsurf\mcp_config.json` - [MCP setup for Windsurf](https://trendsagents.com/mcp-server-for-windsurf) ### VS Code Use the Add to VS Code install button on docs, or paste into `.vscode/mcp.json` inside `servers` (Command Palette → `MCP: Add Server`): ```json "trends-mcp": { "type": "http", "url": "https://api.trendsagents.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } ``` - [MCP setup for VS Code](https://trendsagents.com/mcp-server-for-vs-code) ### Cline (VS Code extension) MCP Servers tab → Remote Server → paste URL and header ```json "trends-mcp": { "url": "https://api.trendsagents.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } ``` - [MCP setup for Cline](https://trendsagents.com/mcp-server-for-cline) ### GitHub Copilot VS Code Command Palette → MCP: Add Server → paste URL and header - [MCP setup for GitHub Copilot](https://trendsagents.com/mcp-server-for-github-copilot) ### Raycast Raycast Settings → Extensions → MCP → Add Server → HTTP → paste URL and header - [MCP setup for Raycast](https://trendsagents.com/mcp-server-for-raycast) ### ChatGPT (OpenAI) ChatGPT on the web → Plugins → + → Add custom MCP server → URL `https://trendsagents.com/mcp`, authentication OAuth → Create as a plugin → install and sign in. No Developer mode needed. - [MCP setup for ChatGPT](https://trendsagents.com/mcp-server-for-chatgpt) ### n8n HTTP Request node or MCP Community node → paste URL and Bearer token - [Trends Agents with n8n](https://trendsagents.com/n8n-trends-mcp) ### Make (Integromat) HTTP module → POST https://api.trendsagents.com/api → Authorization: Bearer YOUR_API_KEY - [Trends Agents with Make](https://trendsagents.com/make-com-trend-automation) ### Zapier Webhooks by Zapier → POST https://api.trendsagents.com/api → Authorization header - [Trends Agents with Zapier](https://trendsagents.com/zapier-trend-workflows) ### LangChain ```python from langchain_mcp_adapters.client import MultiServerMCPClient client = MultiServerMCPClient({"trends-mcp": {"url": "https://api.trendsagents.com/mcp", "transport": "streamable_http", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}) ``` - [Trends Agents with LangChain](https://trendsagents.com/langchain-trends-mcp) ## Authentication - REST + most MCP clients: `Authorization: Bearer ` against `api.trendsagents.com` (the `Bearer ` prefix is optional; the bare key works too) - Claude.ai Connectors: OAuth 2.0 against `www.trendsmcp.ai/mcp` (consent flow; no Bearer key in connector config) Never expose your API key in client-side code or public repositories. ## Pricing | Plan | Monthly requests | Price | | --- | --- | --- | | Free | 100 / month | $0 | | Starter | 1,000 / month | $19 / month | | Pro | 5,000 / month | $49 / month | | Business | 25,000 / month | $199 / month | Yearly billing: 2 months free. Same sources on every plan. Details: [Pricing](https://trendsagents.com/pricing) ## What counts as a request Only successful (2xx) calls count against the monthly quota; failed requests are free. - `get_time_series`: 1 source + keyword per call = 1 request - `get_growth`: 1 source + keyword per call = 1 request (all `percent_growth` periods in that call included) - `get_top_trends`: MCP costs 1 credit per 10 requested rows (max 10 credits per call); REST is 1 request per call - `get_top_posts`: 1 hashtag + source per call = 1 request (Business plan) - `get_usage` (MCP only): free. Shows your plan, requests used this month, requests left, and when it resets ## Data Sources ### Keyword sources — use with Get Trends & Get Growth Pass the source value alongside keyword. On REST, set mode to "get_time_series" (time series) or "get_growth" (period-over-period %). Scores use a 0–100 index where the pipeline supports it. | source | Returns | Keyword format | Options | |-----------------|------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------| | Google Search | Search interest as a 0–100 index, about 5 years | Any name or phrase | country, resolution | | Google Images | Image search interest as a 0–100 index, about 5 years | Any name or phrase | country, resolution | | Google News | News search interest as a 0–100 index, about 5 years | Any name or phrase | country, resolution | | Google Shopping | Shopping search interest as a 0–100 index, about 5 years | Any name or phrase | country, resolution | | YouTube | YouTube search interest as a 0–100 index, about 5 years | Any name or phrase | country, resolution | | Wikipedia | Article page views as a 0–100 index, plus raw views | Any name or phrase | language | | TikTok | Hashtag views as a 0–100 index, plus raw views | Any name or phrase | country | | Amazon | Product search volume as a 0–100 index, plus raw volume | Any name or phrase | - | | npm | Package downloads as a 0–100 index, plus raw downloads | Exact npmjs.com package name, case-sensitive. Right: 'react', '@babel/core'. Wrong: 'React', 'React.js'. | - | | Python | Package downloads as a 0–100 index, plus raw downloads | Exact PyPI project name. Right: 'pandas', 'requests'. Wrong: 'Pandas'. | - | | Steam | Concurrent players as a 0–100 index, plus raw players | Game display name in plain English, not a Steam App ID. Right: 'Elden Ring', 'CS2'. First Steam store search result wins, so use an unambiguous name. | - | | App Downloads | Android app downloads as a 0–100 index, plus raw downloads | Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. | - | | App Rankings | Android chart rank as a 0–100 index, plus raw rank | Android bundle ID only (the id= value on Google Play). Right: 'com.openai.chatgpt', 'com.whatsapp'. Wrong: 'ChatGPT', 'WhatsApp', an iOS App Store ID, or a bundle ID that is not Android. Find it at play.google.com/store/apps/details?id=THIS_PART. | - | ### Live feeds — use with Get Top Trends (no keyword needed) Pass the type value with mode: "get_top_trends". Returns the current ranked leaders on that platform. Feed labels are case-sensitive and must match exactly. | type | Returns | Options | |--------------------------------------|----------------------------------------------|-------------------| | Amazon Best Sellers Top Rated | Top-rated best sellers across all categories | - | | Amazon Best Sellers by Category | Best sellers per product category | category | | App Store Top Free | Top free iOS apps | - | | App Store Top Paid | Top paid iOS apps | - | | GitHub | Daily trending repositories | - | | Google News Top News | Top news stories | - | | Google Play | Top Android apps | - | | Google Trends | Trending searches right now | country | | Google Trends by Category | Trending searches per topic board | category, country | | IMDb MOVIEmeter | Most popular movies by user activity | - | | Open Library Trending Books | Daily trending books | - | | Reddit Hot Posts | Hottest posts on the front page | - | | Reddit World News | Top posts in r/worldnews | - | | Top Websites | Most-visited websites by traffic rank | category | | Spotify Top Podcasts | Top podcasts | - | | Steam Most Played | Games by concurrent live players | - | | Substack | Top newsletters overall | - | | Substack by Category | Top newsletters per category | category | | TikTok Trending Hashtags | Trending hashtags | country | | TikTok Trending Hashtags by Category | Trending hashtags per industry board | category, country | | TikTok Trending Searches | Trending search terms | - | | Wikipedia Trending | Most-viewed articles today | - | | X (Twitter) Trending | Trending topics | country | | YouTube Trending | Trending videos | country | ### Amazon Best Sellers by Category categories Pass `category` with this type. Official names: `Appliances`, `Apps Games`, `Arts Crafts Sewing`, `Automotive`, `Baby`, `Beauty Personal Care`, `Books`, `Camera Photo`, `Clothing Shoes Jewelry`, `Computers Accessories`, `Electronics`, `Grocery Gourmet Food`, `Handmade Products`, `Health Household`, `Home Kitchen`, `Industrial Scientific`, `Kitchen Dining`, `Musical Instruments`, `Office Products`, `Patio Lawn Garden`, `Pet Supplies`, `Software`, `Sports Outdoors`, `Tools Home Improvement`, `Toys Games`, `Video Games` ### Google Trends by Category categories Pass `category` with this type. Official names: `Autos and Vehicles`, `Beauty and Fashion`, `Business and Finance`, `Climate`, `Entertainment`, `Food and Drink`, `Games`, `Health`, `Hobbies and Leisure`, `Jobs and Education`, `Law and Government`, `Other`, `Pets and Animals`, `Politics`, `Science`, `Shopping`, `Sports`, `Technology`, `Travel and Transportation` ### Top Websites categories Pass `category` with this type. Official names: `adult`, `arts-and-entertainment`, `business-and-consumer-services`, `community-and-society`, `computers-electronics-and-technology`, `e-commerce-and-shopping`, `finance`, `food-and-drink`, `gambling`, `games`, `health`, `heavy-industry-and-engineering`, `hobbies-and-leisure`, `home-and-garden`, `jobs-and-career`, `law-and-government`, `lifestyle`, `news-and-media`, `pets-and-animals`, `reference-materials`, `science-and-education`, `sports`, `travel-and-tourism`, `vehicles` ### Substack by Category categories Pass `category` with this type. Official names: `Art & Illustration`, `Business`, `Climate & Environment`, `Comics`, `Crypto`, `Culture`, `Design`, `Education`, `Faith & Spirituality`, `Fashion & Beauty`, `Fiction`, `Film & TV`, `Finance`, `Food & Drink`, `Health & Wellness`, `Health Politics`, `History`, `Home & Garden`, `Humor`, `International`, `Literature`, `Music`, `News`, `Parenting`, `Philosophy`, `Science`, `Sports`, `Technology`, `Travel`, `U.S. Politics`, `World Politics` ### TikTok Trending Hashtags by Category categories Pass `category` with this type. Official names: `Academic Resources`, `Animation and Comics`, `Apparel and Accessories`, `Art`, `Automotive`, `Baby Care`, `Baby Kids and Maternity`, `Beauty`, `Beauty and Personal Care`, `Beauty Services`, `Business and Finance`, `Business Services`, `Card and Board Games`, `Career and Professional Growth`, `College`, `Comedy`, `Community Updates and Issues`, `Conventional and Mainstream Sports`, `Cooking`, `Crafting and Creations`, `Culture`, `Dance`, `Diary and Vlog`, `Drinks`, `Eating Experiences`, `Education`, `Entertainment and Sports News`, `Environment`, `Exercise and Fitness`, `Extreme and Adventure Sports`, `Family`, `Financial Services`, `Food`, `Food and Beverage`, `Food Recommendations`, `Gadgets and Innovation`, `Games`, `General Travel`, `Hair Care`, `Health`, `Health and Wellness`, `History and Literature`, `Home and Garden`, `Home Improvement`, `Household Products`, `Learning and Development`, `Leisure and Recreation Facilities`, `Life Services`, `Livestock and Farming`, `Miscellaneous Performances`, `Movies and TV`, `Music`, `News and Entertainment`, `Other Beauty`, `Other Fashion`, `Other Transportation`, `Outdoor Recreation`, `Outfits`, `Performing Arts`, `Personal Photography`, `Pet Care and Accessories`, `Pets`, `Photography`, `Productivity and Efficiency`, `Romance`, `Science`, `Sensory Experiences`, `Shows Festivals and Exhibitions`, `Software and Apps`, `Special Effects`, `Sports`, `Sports and Outdoor`, `Supernatural and Horror`, `Technology`, `Toys Collectibles and Memorabilia`, `Travel`, `Vehicle and Transportation`, `Video Games`, `Wildlife and Exotic Pets` ## API Reference All requests go to POST https://api.trendsagents.com/api. Pick the operation with the mode field in the JSON body: | mode | What it returns | Required fields | |--------------------|-----------------------------------------|--------------------------------------------------------------| | get_time_series | ~5 years of weekly points for a keyword | source, keyword | | get_growth | % change over one or more periods | source, keyword (percent_growth optional, defaults to ["12M"]) | | get_top_trends | Live ranked leaderboard for a feed | type (limit, category, sort, window, country optional) | Canonical mode names match the MCP tools. Aliases: get_trends, trends, time_series, and lookup all mean get_time_series; growth means get_growth; top_trends means get_top_trends. Prefer the canonical names everywhere. ### get_time_series (REST + MCP) Returns a full historical time series for a keyword from a single source. Approximately 5 years of weekly data. Specify one source per request. Request body: - mode (string, required): "get_time_series" (aliases: "get_trends", "trends", "time_series", "lookup") - source (string, required): one source per request - keyword (string, required) Response fields (array of data points): - date (string): ISO 8601 e.g. "2026-03-21" - value (number): trend score 0–100 - volume (number|null): absolute volume where available - keyword (string) - source (string) Example: ```json {"mode": "get_time_series", "source": "google search", "keyword": "bitcoin"} ``` ```json [{"date": "2026-03-21", "value": 47, "volume": 25853617, "keyword": "bitcoin", "source": "google search"}] ``` ### get_growth (MCP + REST) Calculates point-to-point percentage growth over one or more time windows. Supports window strings or, on REST only, exact custom date pairs. Pass one source or a comma-separated list (e.g. "amazon, tiktok, youtube"). One request per source + keyword regardless of how many periods are in percent_growth. Request body: - mode (string, required): "get_growth" (alias: "growth") - source (string, required): one source or comma-separated list - keyword (string, required) - percent_growth (array, optional): window strings or, on REST only, custom date objects; defaults to ["12M"]. window is accepted as a REST alias. Growth windows: any whole number plus a D, W, M, or Y suffix, up to 5 years (e.g. 7D, 17D, 45D, 3M, 18M, 2Y), plus MTD, QTD, and YTD. Common examples: 7D 14D 30D 1M 2M 3M 6M 9M 12M 1Y 18M 24M 2Y 36M 3Y 48M 60M 5Y MTD QTD YTD Custom date range object (REST only; MCP accepts the string windows): {"name": "optional label", "recent": "YYYY-MM-DD", "baseline": "YYYY-MM-DD"} Response fields: - search_term, data_source - results (array, one per period): period, growth (%), direction, recent_date, baseline_date, recent_value, baseline_value, volume_available, recent_volume, baseline_volume, volume_growth - metadata: total_data_points, calculations_completed, all_successful Example: ```json {"mode": "get_growth", "source": "google search", "keyword": "nike", "percent_growth": ["12M", "3M", "YTD"]} ``` ```json { "search_term": "nike", "data_source": "google search", "results": [{"period": "12M", "growth": -12.31, "direction": "decrease", "recent_date": "2026-03-21", "baseline_date": "2025-03-22", "recent_value": 57, "baseline_value": 65, "volume_available": true, "recent_volume": 24158298, "baseline_volume": 27548936, "volume_growth": -12.31}], "metadata": {"total_data_points": 261, "calculations_completed": 1, "all_successful": true} } ``` ### get_top_trends (MCP + REST) Returns ranked items from live platform feeds. type is required on both REST and MCP (one feed per call); omitting it returns a 400 missing_parameter error. Request body: - mode (string, required): "get_top_trends" (alias: "top_trends") - type (string, required): feed name — required on both REST and MCP - category (string): required for Amazon Best Sellers by Category, Google Trends by Category, Top Websites, Substack by Category, TikTok Trending Hashtags by Category (case-insensitive). Official names are on /data-catalog. - sort (string, optional): "rank" (default) returns the current board; "rank_change" returns the biggest climbers vs a baseline snapshot - window (string, optional, only with sort="rank_change"): "1d", "3d", "7d", "14d", or "30d" (default). Short windows only have baselines on daily feeds; slower feeds return a note pointing to a longer window - country (string, optional): ISO 3166-1 alpha-2 (US, GB, JP). Aliases like USA or United States resolve to US. Omit for the default US board. Only for Google Trends, Google Trends by Category, TikTok Trending Hashtags, TikTok Trending Hashtags by Category, X (Twitter) Trending, YouTube Trending. If that board is not in the database yet, the handler fetches it live. - limit (integer, default 25): max items per feed, up to 200. Free plan boards return the top 10 only. - offset (integer, default 0): pagination. Pinned to 0 on the Free plan; pagination is a paid feature. Example: ```json {"mode": "get_top_trends", "type": "Google Trends", "limit": 10} {"mode": "get_top_trends", "type": "Google Trends by Category", "category": "Games", "limit": 10} ``` ```json {"as_of_ts": "2026-03-26T22:22:25Z", "type": "Google Trends", "limit": 10, "count": 10, "data": [[1, "chuck norris"], [2, "project hail mary"], [3, "bachelorette cancelled"]]} ``` Example (biggest climbers this week in one Amazon category): ```json {"mode": "get_top_trends", "type": "Amazon Best Sellers by Category", "category": "Toys Games", "sort": "rank_change", "window": "7d", "limit": 10} ``` ```json {"as_of_ts": "2026-08-24T04:00:00Z", "baseline_ts": "2026-08-17T04:00:00Z", "type": "Amazon Best Sellers by Category", "category": "Toys Games", "sort": "rank_change", "window": "7d", "limit": 10, "count": 10, "data": [{"rank": 4, "keyword": "example toy", "prev_rank": 31, "rank_change": 27, "category_path": "Toys Games"}]} ``` With sort="rank_change", rows are objects with rank, keyword, prev_rank, and rank_change (positions climbed). If the feed has no baseline snapshot within tolerance of the requested window (e.g. monthly Top Websites with "7d"), or the board turned over completely versus the baseline, the response returns count 0 with a note explaining why and what to do next. ## MCP Prompts — Example AI queries Always include "using Trends Agents" or "via Trends Agents" so the AI routes to the MCP instead of a web search. Get Time Series: - "Using Trends Agents, show me the Google Search trend for nvidia over the past 5 years." - "Via Trends Agents, show me the download trend for Android app com.openai.chatgpt." - "Using Trends Agents, show me the YouTube and TikTok trend history for Stanley cup." - "Via Trends Agents, get the Wikipedia page view history for Bitcoin weekly." - "Using Trends Agents, show me the Amazon search trend for air fryer over 5 years." - "Via Trends Agents, pull the npm download trend for langchain weekly." - "Using Trends Agents, show me Steam concurrent player data for Elden Ring." - "Via Trends Agents, show Google News search interest for Tesla over the last year." - "Using Trends Agents, show daily Google search interest for wallstreetbets over the last 90 days." Get Growth: - "Using Trends Agents, how has Google Search interest in GLP-1 grown over the past 12 months?" - "Via Trends Agents, show me 3M, 6M, and 1Y growth for Anthropic on Google Search." - "Using Trends Agents, what's the YTD Google Search growth for Duolingo?" - "Via Trends Agents, compare 6-month growth for weight loss drugs across Google, TikTok, and Amazon." - "Using Trends Agents, how have Wikipedia page views for Meta Platforms changed over the past 6 months?" - "Via Trends Agents, show Google Search growth for AI agents from Jan 2025 to Jan 2026." - "Via Trends Agents, show me 12M Google Shopping growth for running shoes." Get Top Trends: - "Using Trends Agents, what's trending on Google right now?" - "Via Trends Agents, show me the top TikTok trending hashtags today." - "Using Trends Agents, what are the hottest Reddit posts right now?" - "Via Trends Agents, what are the top trending Wikipedia articles today?" - "Using Trends Agents, show me what's trending on X right now." - "Via Trends Agents, what apps are topping the App Store Free charts today?" - "Using Trends Agents, what are the top-rated Amazon best sellers right now?" - "Via Trends Agents, show Amazon best sellers for category Electronics." - "Using Trends Agents, what are the fastest-climbing Amazon best sellers in Toys Games this week?" - "Via Trends Agents, what's trending on YouTube right now?" ## Errors The REST transport always returns HTTP 200. The real outcome is in the payload envelope: {"statusCode": , "body": }. Check statusCode, then parse body. Error bodies carry one of these codes: | Error code | Meaning | |--------------------------|--------------------------------------------------------------------------| | missing_parameter | Required field missing from the request body (e.g. type on get_top_trends) | | invalid_source | Unrecognized source value | | invalid_mode | Unrecognized mode value | | invalid_request | Malformed body or invalid parameter combination | | no_data | No data matched this keyword/source | | source_unavailable | The upstream source could not be reached; retry later | | growth_calculation_failed | Growth could not be computed for the requested window | | internal_error | Unexpected server error; the body includes a request_id to quote when contacting support | On MCP, tool failures set isError=true on the tool result. Error envelope: {"statusCode": 400, "body": "{"error": "missing_parameter", "message": "The 'type' parameter is required"}"}