trendsagi.com

{
  "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.",
  "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
  },
  "page": "/"
}

{
  "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.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 20,
        "default": 10,
        "description": "Most reports to return, from 1 to 20."
      }
    },
    "additionalProperties": false
  },
  "page": "/"
}

{
  "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.",
  "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
  },
  "page": "/"
}

{
  "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.",
  "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
  },
  "page": "/"
}

{
  "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.",
  "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
  },
  "page": "/"
}

{
  "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.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/"
}

{
  "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.",
  "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
  },
  "page": "/"
}