TrendsFast MCP
TrendsFast is a trend intelligence API for AI agents that indexes public posts and search signals from social channels and search engines. It allows agents to query global trends, niche-specific trends, and discover rising topics with source evidence, dates, and coverage metrics. The server provides tools for discovering trends, querying global indexes, analyzing niche contexts, asking bounded questions, and reading saved results or credit balances.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
Create a free accountClaim the free credits it offers before you create a key: a verified account receives 100 credits onceCreate an API keyKeep it in TRENDSFAST_API_KEY in your client’s environment
MCP endpoint (Streamable HTTP)
https://trendsfast.com/api/mcp/v3What you can do with it
- Query global trending topics across social and search channels
- Analyze trends specific to a user's niche or brand
- Ask bounded questions about market signals and evidence
- Retrieve saved trend results and check credit balance
Source and maintenance
Vendor evidenceRegistry 3.0.0
Protocol and capabilities
- Server
- trendsfast trends-api-v3
- MCP protocol
- 2025-06-18
- Tools
- 7 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
7 advertised
trendsfast_global_trends — Global trends
Advertised destructive
Query the shared saved trend index without Product DNA. Maximum 1 credit(s); zero provider calls. Results rank explicit popularity or measured growth first, then US, UK, Canada and Australia, then Europe, alternating sources. data.brief groups the items into trending now, audience conversations, creative references, search demand and references, and names coverage gaps and next steps. Each item's evidence_class, uses and caution give what it supports and what it does not establish. Saves a result and debits credits when charged. The same request_id returns that saved result without a second charge; a new request_id is a new billable query.
trendsfast_global_trends input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"max_credits",
"input"
],
"properties": {
"input": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"region": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"signals": {
"type": "array",
"items": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1
},
"language": {
"type": "string",
"pattern": "^[a-z]{2}(?:-[A-Z]{2})?$"
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1
},
"categories": {
"type": "array",
"items": {
"enum": [
"COFFEE_BREWING",
"CONTENT_CREATION",
"CUSTOMER_DISCOVERY",
"SOFTWARE_DEVELOPMENT",
"PRODUCTIVITY",
"FITNESS",
"GARDENING",
"COOKING",
"SKINCARE",
"TRAVEL",
"AI",
"ECOMMERCE",
"FINANCE",
"EDUCATION",
"ENTERTAINMENT",
"SUSTAINABILITY",
"MARKETING",
"SALES",
"HEALTHCARE",
"HEALTH_WELLNESS",
"HOME_SERVICES",
"REAL_ESTATE",
"FASHION",
"BEAUTY",
"PETS",
"GAMING",
"PARENTING",
"AUTOMOTIVE",
"LEGAL",
"RESTAURANTS",
"SPORTS",
"CRYPTO",
"CAREERS",
"HOME_DECOR",
"WEDDINGS",
"OUTDOORS",
"PHOTOGRAPHY",
"CRAFTS_DIY",
"CYBERSECURITY",
"NONPROFIT",
"MUSIC_CREATION",
"DRINKS",
"GENERAL"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1
},
"compare_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"history_days": {
"type": "integer",
"maximum": 90,
"minimum": 1
},
"content_types": {
"type": "array",
"items": {
"enum": [
"VIDEO",
"CONVERSATION",
"SEARCH",
"ARTICLE"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"lookback_hours": {
"type": "integer",
"default": 72,
"maximum": 720,
"minimum": 1
},
"observed_market": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"evidence_quality": {
"type": "array",
"items": {
"enum": [
"ATTRIBUTED_METADATA",
"PERMITTED_TEXT",
"INSPECTED_MEDIA"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"x-mcp-header": "request-id"
},
"max_credits": {
"type": "integer",
"maximum": 1000,
"minimum": 0
}
},
"additionalProperties": false
}trendsfast_global_trends output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"version",
"result_id",
"request_id",
"operation",
"generated_at",
"read_at",
"new_research",
"usage",
"next_cursor",
"context",
"window",
"brief",
"items",
"excluded_count",
"truncated",
"coverage",
"communities",
"ai_answers",
"answer",
"limitations"
],
"properties": {
"brief": {
"anyOf": [
{
"type": "object",
"required": [
"headline",
"sections",
"coverage_gaps",
"next_steps"
],
"properties": {
"headline": {
"type": "string",
"maxLength": 600
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"status",
"count",
"item_ids",
"note"
],
"properties": {
"key": {
"enum": [
"TRENDING_NOW",
"AUDIENCE_CONVERSATIONS",
"CREATIVE_REFERENCES",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCES"
],
"type": "string"
},
"note": {
"type": "string",
"maxLength": 300
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"AVAILABLE",
"EMPTY",
"NOT_COLLECTED",
"NEEDS_CONTEXT"
],
"type": "string"
},
"item_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
},
"maxItems": 6
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 5
},
"coverage_gaps": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"note"
],
"properties": {
"note": {
"type": "string",
"maxLength": 200
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"ring",
"signal",
"measured_growth",
"freshness",
"platform",
"source",
"url",
"creator",
"title",
"excerpt",
"published_at",
"observed_at",
"metrics",
"community",
"question",
"problem",
"hook",
"format",
"relevance",
"evidence_class",
"uses",
"caution",
"topic_history"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hook": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"uses": {
"type": "array",
"items": {
"enum": [
"POST_TOPIC",
"DISCUSSION_TO_READ",
"CUSTOMER_PROBLEM",
"FEATURE_INPUT",
"VIDEO_TOPIC",
"TITLE_REFERENCE",
"FORMAT_REFERENCE",
"HOOK_REFERENCE",
"SEARCH_KEYWORD",
"COMPETITOR_WATCH",
"BACKGROUND_ONLY"
],
"type": "string"
},
"maxItems": 3
},
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"format": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"signal": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"source": {
"type": "string",
"maxLength": 120
},
"caution": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"creator": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"metrics": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"problem": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"question": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"community": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"freshness": {
"enum": [
"CURRENT_DATED_REFERENCE",
"BACKGROUND_REFERENCE",
"UNDATED_REFERENCE",
"MODELED_PERIOD_NOT_CURRENT_MOMENTUM"
],
"type": "string"
},
"relevance": {
"type": "object",
"required": [
"score",
"why"
],
"properties": {
"why": {
"type": "string",
"maxLength": 100
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"topic_history": {
"anyOf": [
{
"type": "object",
"required": [
"state",
"since",
"peak_day",
"channels",
"velocity"
],
"properties": {
"since": {
"type": "string"
},
"state": {
"enum": [
"EMERGING",
"RISING",
"PEAKING",
"DECLINING",
"EVERGREEN"
],
"type": "string"
},
"channels": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"peak_day": {
"type": "string"
},
"velocity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"evidence_class": {
"anyOf": [
{
"enum": [
"TREND_SIGNAL",
"AUDIENCE_EVIDENCE",
"CREATIVE_EXAMPLE",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCE_ONLY"
],
"type": "string"
},
{
"type": "null"
}
]
},
"measured_growth": {
"enum": [
"INCREASING_OBSERVED",
"DECREASING_OBSERVED",
"UNCHANGED_OBSERVED",
"NOT_COMPARABLE"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"usage": {
"type": "object",
"required": [
"credits_charged",
"this_request_credits",
"replayed"
],
"properties": {
"replayed": {
"type": "boolean"
},
"credits_charged": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"this_request_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"answer": {
"anyOf": [
{
"type": "object",
"required": [
"question",
"answer_status",
"answer",
"findings",
"missing_inputs",
"next_steps"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 1500
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"item_id",
"title",
"statement",
"platform",
"source",
"url",
"metrics",
"published_at",
"ring"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 2048
},
{
"type": "null"
}
]
},
"kind": {
"enum": [
"TREND",
"CUSTOMER_PROBLEM",
"FEATURE_REQUEST",
"QUESTION_ASKED",
"HOOK_OBSERVED",
"FORMAT_OBSERVED",
"TITLE_OBSERVED",
"SEARCH_DEMAND",
"COMPETITOR_POST",
"COMPETITOR_MENTION",
"RELATED_DISCUSSION",
"REFERENCE"
],
"type": "string"
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"title": {
"type": "string",
"maxLength": 240
},
"source": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"item_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{2,95}$"
},
"metrics": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"statement": {
"type": "string",
"maxLength": 400
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 20
},
"question": {
"type": "string",
"maxLength": 1000
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
},
"answer_status": {
"anyOf": [
{
"enum": [
"ANSWERED",
"PARTIAL",
"INSUFFICIENT_EVIDENCE",
"NEEDS_CONTEXT",
"NOT_COLLECTED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"window": {
"type": "object",
"required": [
"lookback_hours",
"observed_from",
"observed_to"
],
"properties": {
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"lookback_hours": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"context_id",
"revision"
],
"properties": {
"kind": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"context_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"read_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"version": {
"type": "string",
"const": "trends-mcp-compact-v3"
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"platform",
"status",
"observation_count",
"last_observed_at"
],
"properties": {
"source": {
"type": "string",
"maxLength": 200
},
"status": {
"type": "string"
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"last_observed_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"observation_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 40
},
"operation": {
"enum": [
"global",
"niche",
"ask",
"discover"
],
"type": "string"
},
"result_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"truncated": {
"type": "boolean"
},
"ai_answers": {
"anyOf": [
{
"type": "object",
"required": [
"asked",
"answers"
],
"properties": {
"asked": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"model",
"mentions_you",
"competitors_named",
"names",
"cited_domains",
"excerpt"
],
"properties": {
"model": {
"type": "string",
"maxLength": 100
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 10
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 400
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"CHATGPT",
"PERPLEXITY",
"GEMINI",
"CLAUDE"
],
"type": "string"
},
"mentions_you": {
"type": "boolean"
},
"cited_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253
},
"maxItems": 8
},
"competitors_named": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 8
}
},
"additionalProperties": false
},
"maxItems": 12
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"communities": {
"type": "array",
"items": {
"type": "object",
"required": [
"community",
"url",
"status",
"weekly_active_users",
"self_promotion",
"links",
"ai_content",
"promotion_venue",
"rules",
"formats",
"median_score",
"median_comments",
"winning_format",
"hook_pattern",
"avoid",
"pinned",
"play"
],
"properties": {
"url": {
"type": "string"
},
"play": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 4
},
"avoid": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"links": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"rules": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"maxItems": 10
},
"pinned": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string",
"maxLength": 160
}
},
"additionalProperties": false
},
"maxItems": 3
},
"status": {
"enum": [
"PROFILED",
"NOT_FOUND",
"UNAVAILABLE"
],
"type": "string"
},
"formats": {
"type": "array",
"items": {
"type": "object",
"required": [
"format",
"share"
],
"properties": {
"share": {
"type": "number"
},
"format": {
"enum": [
"QUESTION",
"STORY",
"SHOWCASE",
"GUIDE",
"DISCUSSION",
"LINK",
"MEDIA"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 3
},
"community": {
"type": "string"
},
"ai_content": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"hook_pattern": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"median_score": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"self_promotion": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"winning_format": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"median_comments": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"promotion_venue": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
]
},
"weekly_active_users": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 5
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"new_research": {
"type": "boolean"
},
"excluded_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"error": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
}trendsfast_global_trends annotations
{
"title": "Global trends",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}trendsfast_niche_trends — Niche trends
Advertised destructiveOpen-world
Rank evidence against confirmed project context or explicit temporary niche. Without product: maximum 3 credits and no new source research. A product needs the confirmed context_id: it first collects the brand's own sources fresh, then ranks through that product's lens: customers (Customers) 10 credits, niche (Trending) 25 credits, competitors (Competitors) 30 credits, formats (Formats) 20 credits, search (Search) 35 credits. A product on a typed niche is refused with PRODUCT_REQUIRES_CONTEXT and charges nothing; a typed niche is read without a product. Formats also reads the top TikTok and YouTube videos' transcripts, so each item's hook is its opening line. Search also asks ChatGPT, Claude, Gemini and Perplexity the category's buyer question (no brand is sent) and returns data.ai_answers: who each answer names, whether that includes the brand or its competitors, and the domains cited. A Customers or Trending call, or a read without product, also returns data.communities when the brand's confirmed communities have been read: each one's rules on self-promotion, links and AI-written posts (citing rule numbers), the formats it favours, what wins there over all time (winning_format, hook_pattern and avoid, read by Claude from its top posts), the moderators' pinned posts (pinned), and a play for taking part without breaking them. A Trending call may also give each item a topic_history: where its topic is in its life across days and channels (state, since, first_seen, peak_day, channels, 7-day velocity, as_of), or null until the topic has a lifecycle state; it is the only basis for saying when a topic started rising. new_research says whether the call collected or asked. CORE means a specific topic, problem, keyword or exact competitor-account match; sharing only a broad family such as AI is ADJACENT. A temporary niche may add communities, competitor_handles, competitor_domains and keywords for exact matching. data.brief and each item's evidence_class, uses and caution describe what the evidence supports. Saves a result and may debit credits.
trendsfast_niche_trends input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"max_credits",
"input"
],
"properties": {
"input": {
"type": "object",
"properties": {
"niche": {
"type": "object",
"required": [
"description"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"jobs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"market": {
"type": "string",
"maxLength": 100
},
"topics": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"industry": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
},
"language": {
"type": "string",
"maxLength": 20
},
"problems": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"audiences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"default": [],
"maxItems": 11
},
"exclusions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"communities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 10
},
"competitors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"competitor_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
},
"competitor_handles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 40
},
"customer_interests": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"product_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"adjacent_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
},
"filters": {
"type": "object",
"default": {
"limit": 20,
"lookback_hours": 72
},
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"region": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"signals": {
"type": "array",
"items": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1
},
"language": {
"type": "string",
"pattern": "^[a-z]{2}(?:-[A-Z]{2})?$"
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1
},
"categories": {
"type": "array",
"items": {
"enum": [
"COFFEE_BREWING",
"CONTENT_CREATION",
"CUSTOMER_DISCOVERY",
"SOFTWARE_DEVELOPMENT",
"PRODUCTIVITY",
"FITNESS",
"GARDENING",
"COOKING",
"SKINCARE",
"TRAVEL",
"AI",
"ECOMMERCE",
"FINANCE",
"EDUCATION",
"ENTERTAINMENT",
"SUSTAINABILITY",
"MARKETING",
"SALES",
"HEALTHCARE",
"HEALTH_WELLNESS",
"HOME_SERVICES",
"REAL_ESTATE",
"FASHION",
"BEAUTY",
"PETS",
"GAMING",
"PARENTING",
"AUTOMOTIVE",
"LEGAL",
"RESTAURANTS",
"SPORTS",
"CRYPTO",
"CAREERS",
"HOME_DECOR",
"WEDDINGS",
"OUTDOORS",
"PHOTOGRAPHY",
"CRAFTS_DIY",
"CYBERSECURITY",
"NONPROFIT",
"MUSIC_CREATION",
"DRINKS",
"GENERAL"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1
},
"compare_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"history_days": {
"type": "integer",
"maximum": 90,
"minimum": 1
},
"content_types": {
"type": "array",
"items": {
"enum": [
"VIDEO",
"CONVERSATION",
"SEARCH",
"ARTICLE"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"lookback_hours": {
"type": "integer",
"default": 72,
"maximum": 720,
"minimum": 1
},
"observed_market": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"evidence_quality": {
"type": "array",
"items": {
"enum": [
"ATTRIBUTED_METADATA",
"PERMITTED_TEXT",
"INSPECTED_MEDIA"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
}
},
"additionalProperties": false
},
"product": {
"enum": [
"customers",
"niche",
"competitors",
"formats",
"search"
],
"type": "string"
},
"context_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"include_global": {
"type": "boolean",
"default": true
},
"include_adjacent": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"x-mcp-header": "request-id"
},
"max_credits": {
"type": "integer",
"maximum": 1000,
"minimum": 0
}
},
"additionalProperties": false
}trendsfast_niche_trends output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"version",
"result_id",
"request_id",
"operation",
"generated_at",
"read_at",
"new_research",
"usage",
"next_cursor",
"context",
"window",
"brief",
"items",
"excluded_count",
"truncated",
"coverage",
"communities",
"ai_answers",
"answer",
"limitations"
],
"properties": {
"brief": {
"anyOf": [
{
"type": "object",
"required": [
"headline",
"sections",
"coverage_gaps",
"next_steps"
],
"properties": {
"headline": {
"type": "string",
"maxLength": 600
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"status",
"count",
"item_ids",
"note"
],
"properties": {
"key": {
"enum": [
"TRENDING_NOW",
"AUDIENCE_CONVERSATIONS",
"CREATIVE_REFERENCES",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCES"
],
"type": "string"
},
"note": {
"type": "string",
"maxLength": 300
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"AVAILABLE",
"EMPTY",
"NOT_COLLECTED",
"NEEDS_CONTEXT"
],
"type": "string"
},
"item_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
},
"maxItems": 6
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 5
},
"coverage_gaps": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"note"
],
"properties": {
"note": {
"type": "string",
"maxLength": 200
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"ring",
"signal",
"measured_growth",
"freshness",
"platform",
"source",
"url",
"creator",
"title",
"excerpt",
"published_at",
"observed_at",
"metrics",
"community",
"question",
"problem",
"hook",
"format",
"relevance",
"evidence_class",
"uses",
"caution",
"topic_history"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hook": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"uses": {
"type": "array",
"items": {
"enum": [
"POST_TOPIC",
"DISCUSSION_TO_READ",
"CUSTOMER_PROBLEM",
"FEATURE_INPUT",
"VIDEO_TOPIC",
"TITLE_REFERENCE",
"FORMAT_REFERENCE",
"HOOK_REFERENCE",
"SEARCH_KEYWORD",
"COMPETITOR_WATCH",
"BACKGROUND_ONLY"
],
"type": "string"
},
"maxItems": 3
},
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"format": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"signal": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"source": {
"type": "string",
"maxLength": 120
},
"caution": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"creator": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"metrics": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"problem": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"question": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"community": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"freshness": {
"enum": [
"CURRENT_DATED_REFERENCE",
"BACKGROUND_REFERENCE",
"UNDATED_REFERENCE",
"MODELED_PERIOD_NOT_CURRENT_MOMENTUM"
],
"type": "string"
},
"relevance": {
"type": "object",
"required": [
"score",
"why"
],
"properties": {
"why": {
"type": "string",
"maxLength": 100
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"topic_history": {
"anyOf": [
{
"type": "object",
"required": [
"state",
"since",
"peak_day",
"channels",
"velocity"
],
"properties": {
"since": {
"type": "string"
},
"state": {
"enum": [
"EMERGING",
"RISING",
"PEAKING",
"DECLINING",
"EVERGREEN"
],
"type": "string"
},
"channels": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"peak_day": {
"type": "string"
},
"velocity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"evidence_class": {
"anyOf": [
{
"enum": [
"TREND_SIGNAL",
"AUDIENCE_EVIDENCE",
"CREATIVE_EXAMPLE",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCE_ONLY"
],
"type": "string"
},
{
"type": "null"
}
]
},
"measured_growth": {
"enum": [
"INCREASING_OBSERVED",
"DECREASING_OBSERVED",
"UNCHANGED_OBSERVED",
"NOT_COMPARABLE"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"usage": {
"type": "object",
"required": [
"credits_charged",
"this_request_credits",
"replayed"
],
"properties": {
"replayed": {
"type": "boolean"
},
"credits_charged": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"this_request_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"answer": {
"anyOf": [
{
"type": "object",
"required": [
"question",
"answer_status",
"answer",
"findings",
"missing_inputs",
"next_steps"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 1500
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"item_id",
"title",
"statement",
"platform",
"source",
"url",
"metrics",
"published_at",
"ring"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 2048
},
{
"type": "null"
}
]
},
"kind": {
"enum": [
"TREND",
"CUSTOMER_PROBLEM",
"FEATURE_REQUEST",
"QUESTION_ASKED",
"HOOK_OBSERVED",
"FORMAT_OBSERVED",
"TITLE_OBSERVED",
"SEARCH_DEMAND",
"COMPETITOR_POST",
"COMPETITOR_MENTION",
"RELATED_DISCUSSION",
"REFERENCE"
],
"type": "string"
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"title": {
"type": "string",
"maxLength": 240
},
"source": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"item_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{2,95}$"
},
"metrics": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"statement": {
"type": "string",
"maxLength": 400
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 20
},
"question": {
"type": "string",
"maxLength": 1000
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
},
"answer_status": {
"anyOf": [
{
"enum": [
"ANSWERED",
"PARTIAL",
"INSUFFICIENT_EVIDENCE",
"NEEDS_CONTEXT",
"NOT_COLLECTED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"window": {
"type": "object",
"required": [
"lookback_hours",
"observed_from",
"observed_to"
],
"properties": {
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"lookback_hours": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"context_id",
"revision"
],
"properties": {
"kind": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"context_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"read_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"version": {
"type": "string",
"const": "trends-mcp-compact-v3"
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"platform",
"status",
"observation_count",
"last_observed_at"
],
"properties": {
"source": {
"type": "string",
"maxLength": 200
},
"status": {
"type": "string"
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"last_observed_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"observation_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 40
},
"operation": {
"enum": [
"global",
"niche",
"ask",
"discover"
],
"type": "string"
},
"result_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"truncated": {
"type": "boolean"
},
"ai_answers": {
"anyOf": [
{
"type": "object",
"required": [
"asked",
"answers"
],
"properties": {
"asked": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"model",
"mentions_you",
"competitors_named",
"names",
"cited_domains",
"excerpt"
],
"properties": {
"model": {
"type": "string",
"maxLength": 100
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 10
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 400
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"CHATGPT",
"PERPLEXITY",
"GEMINI",
"CLAUDE"
],
"type": "string"
},
"mentions_you": {
"type": "boolean"
},
"cited_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253
},
"maxItems": 8
},
"competitors_named": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 8
}
},
"additionalProperties": false
},
"maxItems": 12
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"communities": {
"type": "array",
"items": {
"type": "object",
"required": [
"community",
"url",
"status",
"weekly_active_users",
"self_promotion",
"links",
"ai_content",
"promotion_venue",
"rules",
"formats",
"median_score",
"median_comments",
"winning_format",
"hook_pattern",
"avoid",
"pinned",
"play"
],
"properties": {
"url": {
"type": "string"
},
"play": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 4
},
"avoid": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"links": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"rules": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"maxItems": 10
},
"pinned": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string",
"maxLength": 160
}
},
"additionalProperties": false
},
"maxItems": 3
},
"status": {
"enum": [
"PROFILED",
"NOT_FOUND",
"UNAVAILABLE"
],
"type": "string"
},
"formats": {
"type": "array",
"items": {
"type": "object",
"required": [
"format",
"share"
],
"properties": {
"share": {
"type": "number"
},
"format": {
"enum": [
"QUESTION",
"STORY",
"SHOWCASE",
"GUIDE",
"DISCUSSION",
"LINK",
"MEDIA"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 3
},
"community": {
"type": "string"
},
"ai_content": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"hook_pattern": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"median_score": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"self_promotion": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"winning_format": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"median_comments": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"promotion_venue": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
]
},
"weekly_active_users": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 5
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"new_research": {
"type": "boolean"
},
"excluded_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"error": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
}trendsfast_niche_trends annotations
{
"title": "Niche trends",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}trendsfast_discover_trends — Discover trends
Advertised destructive
Answer one question across global, core and adjacent scope and every source channel in a single call. Maximum 5 credits; zero provider calls. Global scope needs no Product DNA. A channel with no permitted observation is reported UNAVAILABLE rather than empty. Saves a result and may debit credits. No new source research.
trendsfast_discover_trends input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"max_credits",
"input"
],
"properties": {
"input": {
"type": "object",
"properties": {
"niche": {
"type": "object",
"required": [
"description"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"jobs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"market": {
"type": "string",
"maxLength": 100
},
"topics": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"industry": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
},
"language": {
"type": "string",
"maxLength": 20
},
"problems": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"audiences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"default": [],
"maxItems": 11
},
"exclusions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"communities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 10
},
"competitors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"competitor_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
},
"competitor_handles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 40
},
"customer_interests": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"product_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"adjacent_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
},
"scope": {
"type": "array",
"items": {
"enum": [
"global",
"core",
"adjacent"
],
"type": "string"
},
"default": [
"global",
"core",
"adjacent"
],
"maxItems": 3,
"minItems": 1
},
"filters": {
"type": "object",
"default": {
"limit": 20,
"lookback_hours": 72
},
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"region": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"signals": {
"type": "array",
"items": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1
},
"language": {
"type": "string",
"pattern": "^[a-z]{2}(?:-[A-Z]{2})?$"
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1
},
"categories": {
"type": "array",
"items": {
"enum": [
"COFFEE_BREWING",
"CONTENT_CREATION",
"CUSTOMER_DISCOVERY",
"SOFTWARE_DEVELOPMENT",
"PRODUCTIVITY",
"FITNESS",
"GARDENING",
"COOKING",
"SKINCARE",
"TRAVEL",
"AI",
"ECOMMERCE",
"FINANCE",
"EDUCATION",
"ENTERTAINMENT",
"SUSTAINABILITY",
"MARKETING",
"SALES",
"HEALTHCARE",
"HEALTH_WELLNESS",
"HOME_SERVICES",
"REAL_ESTATE",
"FASHION",
"BEAUTY",
"PETS",
"GAMING",
"PARENTING",
"AUTOMOTIVE",
"LEGAL",
"RESTAURANTS",
"SPORTS",
"CRYPTO",
"CAREERS",
"HOME_DECOR",
"WEDDINGS",
"OUTDOORS",
"PHOTOGRAPHY",
"CRAFTS_DIY",
"CYBERSECURITY",
"NONPROFIT",
"MUSIC_CREATION",
"DRINKS",
"GENERAL"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1
},
"compare_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"history_days": {
"type": "integer",
"maximum": 90,
"minimum": 1
},
"content_types": {
"type": "array",
"items": {
"enum": [
"VIDEO",
"CONVERSATION",
"SEARCH",
"ARTICLE"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"lookback_hours": {
"type": "integer",
"default": 72,
"maximum": 720,
"minimum": 1
},
"observed_market": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"evidence_quality": {
"type": "array",
"items": {
"enum": [
"ATTRIBUTED_METADATA",
"PERMITTED_TEXT",
"INSPECTED_MEDIA"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
}
},
"additionalProperties": false
},
"product": {
"enum": [
"customers",
"niche",
"competitors",
"formats",
"search"
],
"type": "string"
},
"channels": {
"type": "array",
"items": {
"enum": [
"search",
"ai_search",
"conversations",
"video"
],
"type": "string"
},
"default": [
"search",
"ai_search",
"conversations",
"video"
],
"maxItems": 4,
"minItems": 1
},
"question": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"context_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"include_global": {
"type": "boolean",
"default": true
},
"include_adjacent": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"x-mcp-header": "request-id"
},
"max_credits": {
"type": "integer",
"maximum": 1000,
"minimum": 0
}
},
"additionalProperties": false
}trendsfast_discover_trends output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"version",
"result_id",
"request_id",
"operation",
"generated_at",
"read_at",
"new_research",
"usage",
"next_cursor",
"context",
"window",
"brief",
"items",
"excluded_count",
"truncated",
"coverage",
"communities",
"ai_answers",
"answer",
"limitations"
],
"properties": {
"brief": {
"anyOf": [
{
"type": "object",
"required": [
"headline",
"sections",
"coverage_gaps",
"next_steps"
],
"properties": {
"headline": {
"type": "string",
"maxLength": 600
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"status",
"count",
"item_ids",
"note"
],
"properties": {
"key": {
"enum": [
"TRENDING_NOW",
"AUDIENCE_CONVERSATIONS",
"CREATIVE_REFERENCES",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCES"
],
"type": "string"
},
"note": {
"type": "string",
"maxLength": 300
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"AVAILABLE",
"EMPTY",
"NOT_COLLECTED",
"NEEDS_CONTEXT"
],
"type": "string"
},
"item_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
},
"maxItems": 6
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 5
},
"coverage_gaps": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"note"
],
"properties": {
"note": {
"type": "string",
"maxLength": 200
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"ring",
"signal",
"measured_growth",
"freshness",
"platform",
"source",
"url",
"creator",
"title",
"excerpt",
"published_at",
"observed_at",
"metrics",
"community",
"question",
"problem",
"hook",
"format",
"relevance",
"evidence_class",
"uses",
"caution",
"topic_history"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hook": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"uses": {
"type": "array",
"items": {
"enum": [
"POST_TOPIC",
"DISCUSSION_TO_READ",
"CUSTOMER_PROBLEM",
"FEATURE_INPUT",
"VIDEO_TOPIC",
"TITLE_REFERENCE",
"FORMAT_REFERENCE",
"HOOK_REFERENCE",
"SEARCH_KEYWORD",
"COMPETITOR_WATCH",
"BACKGROUND_ONLY"
],
"type": "string"
},
"maxItems": 3
},
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"format": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"signal": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"source": {
"type": "string",
"maxLength": 120
},
"caution": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"creator": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"metrics": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"problem": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"question": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"community": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"freshness": {
"enum": [
"CURRENT_DATED_REFERENCE",
"BACKGROUND_REFERENCE",
"UNDATED_REFERENCE",
"MODELED_PERIOD_NOT_CURRENT_MOMENTUM"
],
"type": "string"
},
"relevance": {
"type": "object",
"required": [
"score",
"why"
],
"properties": {
"why": {
"type": "string",
"maxLength": 100
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"topic_history": {
"anyOf": [
{
"type": "object",
"required": [
"state",
"since",
"peak_day",
"channels",
"velocity"
],
"properties": {
"since": {
"type": "string"
},
"state": {
"enum": [
"EMERGING",
"RISING",
"PEAKING",
"DECLINING",
"EVERGREEN"
],
"type": "string"
},
"channels": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"peak_day": {
"type": "string"
},
"velocity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"evidence_class": {
"anyOf": [
{
"enum": [
"TREND_SIGNAL",
"AUDIENCE_EVIDENCE",
"CREATIVE_EXAMPLE",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCE_ONLY"
],
"type": "string"
},
{
"type": "null"
}
]
},
"measured_growth": {
"enum": [
"INCREASING_OBSERVED",
"DECREASING_OBSERVED",
"UNCHANGED_OBSERVED",
"NOT_COMPARABLE"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"usage": {
"type": "object",
"required": [
"credits_charged",
"this_request_credits",
"replayed"
],
"properties": {
"replayed": {
"type": "boolean"
},
"credits_charged": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"this_request_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"answer": {
"anyOf": [
{
"type": "object",
"required": [
"question",
"answer_status",
"answer",
"findings",
"missing_inputs",
"next_steps"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 1500
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"item_id",
"title",
"statement",
"platform",
"source",
"url",
"metrics",
"published_at",
"ring"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 2048
},
{
"type": "null"
}
]
},
"kind": {
"enum": [
"TREND",
"CUSTOMER_PROBLEM",
"FEATURE_REQUEST",
"QUESTION_ASKED",
"HOOK_OBSERVED",
"FORMAT_OBSERVED",
"TITLE_OBSERVED",
"SEARCH_DEMAND",
"COMPETITOR_POST",
"COMPETITOR_MENTION",
"RELATED_DISCUSSION",
"REFERENCE"
],
"type": "string"
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"title": {
"type": "string",
"maxLength": 240
},
"source": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"item_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{2,95}$"
},
"metrics": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"statement": {
"type": "string",
"maxLength": 400
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 20
},
"question": {
"type": "string",
"maxLength": 1000
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
},
"answer_status": {
"anyOf": [
{
"enum": [
"ANSWERED",
"PARTIAL",
"INSUFFICIENT_EVIDENCE",
"NEEDS_CONTEXT",
"NOT_COLLECTED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"window": {
"type": "object",
"required": [
"lookback_hours",
"observed_from",
"observed_to"
],
"properties": {
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"lookback_hours": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"context_id",
"revision"
],
"properties": {
"kind": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"context_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"read_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"version": {
"type": "string",
"const": "trends-mcp-compact-v3"
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"platform",
"status",
"observation_count",
"last_observed_at"
],
"properties": {
"source": {
"type": "string",
"maxLength": 200
},
"status": {
"type": "string"
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"last_observed_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"observation_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 40
},
"operation": {
"enum": [
"global",
"niche",
"ask",
"discover"
],
"type": "string"
},
"result_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"truncated": {
"type": "boolean"
},
"ai_answers": {
"anyOf": [
{
"type": "object",
"required": [
"asked",
"answers"
],
"properties": {
"asked": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"model",
"mentions_you",
"competitors_named",
"names",
"cited_domains",
"excerpt"
],
"properties": {
"model": {
"type": "string",
"maxLength": 100
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 10
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 400
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"CHATGPT",
"PERPLEXITY",
"GEMINI",
"CLAUDE"
],
"type": "string"
},
"mentions_you": {
"type": "boolean"
},
"cited_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253
},
"maxItems": 8
},
"competitors_named": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 8
}
},
"additionalProperties": false
},
"maxItems": 12
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"communities": {
"type": "array",
"items": {
"type": "object",
"required": [
"community",
"url",
"status",
"weekly_active_users",
"self_promotion",
"links",
"ai_content",
"promotion_venue",
"rules",
"formats",
"median_score",
"median_comments",
"winning_format",
"hook_pattern",
"avoid",
"pinned",
"play"
],
"properties": {
"url": {
"type": "string"
},
"play": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 4
},
"avoid": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"links": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"rules": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"maxItems": 10
},
"pinned": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string",
"maxLength": 160
}
},
"additionalProperties": false
},
"maxItems": 3
},
"status": {
"enum": [
"PROFILED",
"NOT_FOUND",
"UNAVAILABLE"
],
"type": "string"
},
"formats": {
"type": "array",
"items": {
"type": "object",
"required": [
"format",
"share"
],
"properties": {
"share": {
"type": "number"
},
"format": {
"enum": [
"QUESTION",
"STORY",
"SHOWCASE",
"GUIDE",
"DISCUSSION",
"LINK",
"MEDIA"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 3
},
"community": {
"type": "string"
},
"ai_content": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"hook_pattern": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"median_score": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"self_promotion": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"winning_format": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"median_comments": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"promotion_venue": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
]
},
"weekly_active_users": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 5
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"new_research": {
"type": "boolean"
},
"excluded_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"error": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
}trendsfast_discover_trends annotations
{
"title": "Discover trends",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}trendsfast_ask_trends — Ask about trends
Advertised destructive
Answer a bounded question using saved intelligence. Maximum 5 credits. Questions about competitors, customer complaints, feature requests, hooks and formats, or search keywords each need their own evidence: answer_status says ANSWERED, PARTIAL, INSUFFICIENT_EVIDENCE, NEEDS_CONTEXT or NOT_COLLECTED, findings cite each item with its kind, and missing_inputs and next_steps say what would complete the answer. An answer with no findings costs nothing. Saves a result and may debit credits. No provider or model calls, invented growth or hidden fresh research.
trendsfast_ask_trends input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"max_credits",
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"question"
],
"properties": {
"niche": {
"type": "object",
"required": [
"description"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"jobs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"market": {
"type": "string",
"maxLength": 100
},
"topics": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"industry": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
},
"language": {
"type": "string",
"maxLength": 20
},
"problems": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"audiences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"default": [],
"maxItems": 11
},
"exclusions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"communities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 10
},
"competitors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"capabilities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"competitor_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
},
"competitor_handles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 40
},
"customer_interests": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"product_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"adjacent_categories": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"default": [],
"maxItems": 20
}
},
"additionalProperties": false
},
"filters": {
"type": "object",
"default": {
"limit": 20,
"lookback_hours": 72
},
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1
},
"region": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"signals": {
"type": "array",
"items": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1
},
"language": {
"type": "string",
"pattern": "^[a-z]{2}(?:-[A-Z]{2})?$"
},
"platforms": {
"type": "array",
"items": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"maxItems": 11,
"minItems": 1
},
"categories": {
"type": "array",
"items": {
"enum": [
"COFFEE_BREWING",
"CONTENT_CREATION",
"CUSTOMER_DISCOVERY",
"SOFTWARE_DEVELOPMENT",
"PRODUCTIVITY",
"FITNESS",
"GARDENING",
"COOKING",
"SKINCARE",
"TRAVEL",
"AI",
"ECOMMERCE",
"FINANCE",
"EDUCATION",
"ENTERTAINMENT",
"SUSTAINABILITY",
"MARKETING",
"SALES",
"HEALTHCARE",
"HEALTH_WELLNESS",
"HOME_SERVICES",
"REAL_ESTATE",
"FASHION",
"BEAUTY",
"PETS",
"GAMING",
"PARENTING",
"AUTOMOTIVE",
"LEGAL",
"RESTAURANTS",
"SPORTS",
"CRYPTO",
"CAREERS",
"HOME_DECOR",
"WEDDINGS",
"OUTDOORS",
"PHOTOGRAPHY",
"CRAFTS_DIY",
"CYBERSECURITY",
"NONPROFIT",
"MUSIC_CREATION",
"DRINKS",
"GENERAL"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1
},
"compare_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"history_days": {
"type": "integer",
"maximum": 90,
"minimum": 1
},
"content_types": {
"type": "array",
"items": {
"enum": [
"VIDEO",
"CONVERSATION",
"SEARCH",
"ARTICLE"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"lookback_hours": {
"type": "integer",
"default": 72,
"maximum": 720,
"minimum": 1
},
"observed_market": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"evidence_quality": {
"type": "array",
"items": {
"enum": [
"ATTRIBUTED_METADATA",
"PERMITTED_TEXT",
"INSPECTED_MEDIA"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
}
},
"additionalProperties": false
},
"product": {
"enum": [
"customers",
"niche",
"competitors",
"formats",
"search"
],
"type": "string"
},
"question": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"context_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"include_global": {
"type": "boolean",
"default": true
},
"include_adjacent": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"x-mcp-header": "request-id"
},
"max_credits": {
"type": "integer",
"maximum": 1000,
"minimum": 0
}
},
"additionalProperties": false
}trendsfast_ask_trends output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"version",
"result_id",
"request_id",
"operation",
"generated_at",
"read_at",
"new_research",
"usage",
"next_cursor",
"context",
"window",
"brief",
"items",
"excluded_count",
"truncated",
"coverage",
"communities",
"ai_answers",
"answer",
"limitations"
],
"properties": {
"brief": {
"anyOf": [
{
"type": "object",
"required": [
"headline",
"sections",
"coverage_gaps",
"next_steps"
],
"properties": {
"headline": {
"type": "string",
"maxLength": 600
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"status",
"count",
"item_ids",
"note"
],
"properties": {
"key": {
"enum": [
"TRENDING_NOW",
"AUDIENCE_CONVERSATIONS",
"CREATIVE_REFERENCES",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCES"
],
"type": "string"
},
"note": {
"type": "string",
"maxLength": 300
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"AVAILABLE",
"EMPTY",
"NOT_COLLECTED",
"NEEDS_CONTEXT"
],
"type": "string"
},
"item_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
},
"maxItems": 6
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 5
},
"coverage_gaps": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"note"
],
"properties": {
"note": {
"type": "string",
"maxLength": 200
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"ring",
"signal",
"measured_growth",
"freshness",
"platform",
"source",
"url",
"creator",
"title",
"excerpt",
"published_at",
"observed_at",
"metrics",
"community",
"question",
"problem",
"hook",
"format",
"relevance",
"evidence_class",
"uses",
"caution",
"topic_history"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hook": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"uses": {
"type": "array",
"items": {
"enum": [
"POST_TOPIC",
"DISCUSSION_TO_READ",
"CUSTOMER_PROBLEM",
"FEATURE_INPUT",
"VIDEO_TOPIC",
"TITLE_REFERENCE",
"FORMAT_REFERENCE",
"HOOK_REFERENCE",
"SEARCH_KEYWORD",
"COMPETITOR_WATCH",
"BACKGROUND_ONLY"
],
"type": "string"
},
"maxItems": 3
},
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"format": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"signal": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"source": {
"type": "string",
"maxLength": 120
},
"caution": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"creator": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"metrics": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"problem": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"question": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"community": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"freshness": {
"enum": [
"CURRENT_DATED_REFERENCE",
"BACKGROUND_REFERENCE",
"UNDATED_REFERENCE",
"MODELED_PERIOD_NOT_CURRENT_MOMENTUM"
],
"type": "string"
},
"relevance": {
"type": "object",
"required": [
"score",
"why"
],
"properties": {
"why": {
"type": "string",
"maxLength": 100
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"topic_history": {
"anyOf": [
{
"type": "object",
"required": [
"state",
"since",
"peak_day",
"channels",
"velocity"
],
"properties": {
"since": {
"type": "string"
},
"state": {
"enum": [
"EMERGING",
"RISING",
"PEAKING",
"DECLINING",
"EVERGREEN"
],
"type": "string"
},
"channels": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"peak_day": {
"type": "string"
},
"velocity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"evidence_class": {
"anyOf": [
{
"enum": [
"TREND_SIGNAL",
"AUDIENCE_EVIDENCE",
"CREATIVE_EXAMPLE",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCE_ONLY"
],
"type": "string"
},
{
"type": "null"
}
]
},
"measured_growth": {
"enum": [
"INCREASING_OBSERVED",
"DECREASING_OBSERVED",
"UNCHANGED_OBSERVED",
"NOT_COMPARABLE"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"usage": {
"type": "object",
"required": [
"credits_charged",
"this_request_credits",
"replayed"
],
"properties": {
"replayed": {
"type": "boolean"
},
"credits_charged": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"this_request_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"answer": {
"anyOf": [
{
"type": "object",
"required": [
"question",
"answer_status",
"answer",
"findings",
"missing_inputs",
"next_steps"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 1500
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"item_id",
"title",
"statement",
"platform",
"source",
"url",
"metrics",
"published_at",
"ring"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 2048
},
{
"type": "null"
}
]
},
"kind": {
"enum": [
"TREND",
"CUSTOMER_PROBLEM",
"FEATURE_REQUEST",
"QUESTION_ASKED",
"HOOK_OBSERVED",
"FORMAT_OBSERVED",
"TITLE_OBSERVED",
"SEARCH_DEMAND",
"COMPETITOR_POST",
"COMPETITOR_MENTION",
"RELATED_DISCUSSION",
"REFERENCE"
],
"type": "string"
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"title": {
"type": "string",
"maxLength": 240
},
"source": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"item_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{2,95}$"
},
"metrics": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"statement": {
"type": "string",
"maxLength": 400
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 20
},
"question": {
"type": "string",
"maxLength": 1000
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
},
"answer_status": {
"anyOf": [
{
"enum": [
"ANSWERED",
"PARTIAL",
"INSUFFICIENT_EVIDENCE",
"NEEDS_CONTEXT",
"NOT_COLLECTED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"window": {
"type": "object",
"required": [
"lookback_hours",
"observed_from",
"observed_to"
],
"properties": {
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"lookback_hours": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"context_id",
"revision"
],
"properties": {
"kind": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"context_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"read_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"version": {
"type": "string",
"const": "trends-mcp-compact-v3"
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"platform",
"status",
"observation_count",
"last_observed_at"
],
"properties": {
"source": {
"type": "string",
"maxLength": 200
},
"status": {
"type": "string"
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"last_observed_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"observation_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 40
},
"operation": {
"enum": [
"global",
"niche",
"ask",
"discover"
],
"type": "string"
},
"result_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"truncated": {
"type": "boolean"
},
"ai_answers": {
"anyOf": [
{
"type": "object",
"required": [
"asked",
"answers"
],
"properties": {
"asked": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"model",
"mentions_you",
"competitors_named",
"names",
"cited_domains",
"excerpt"
],
"properties": {
"model": {
"type": "string",
"maxLength": 100
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 10
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 400
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"CHATGPT",
"PERPLEXITY",
"GEMINI",
"CLAUDE"
],
"type": "string"
},
"mentions_you": {
"type": "boolean"
},
"cited_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253
},
"maxItems": 8
},
"competitors_named": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 8
}
},
"additionalProperties": false
},
"maxItems": 12
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"communities": {
"type": "array",
"items": {
"type": "object",
"required": [
"community",
"url",
"status",
"weekly_active_users",
"self_promotion",
"links",
"ai_content",
"promotion_venue",
"rules",
"formats",
"median_score",
"median_comments",
"winning_format",
"hook_pattern",
"avoid",
"pinned",
"play"
],
"properties": {
"url": {
"type": "string"
},
"play": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 4
},
"avoid": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"links": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"rules": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"maxItems": 10
},
"pinned": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string",
"maxLength": 160
}
},
"additionalProperties": false
},
"maxItems": 3
},
"status": {
"enum": [
"PROFILED",
"NOT_FOUND",
"UNAVAILABLE"
],
"type": "string"
},
"formats": {
"type": "array",
"items": {
"type": "object",
"required": [
"format",
"share"
],
"properties": {
"share": {
"type": "number"
},
"format": {
"enum": [
"QUESTION",
"STORY",
"SHOWCASE",
"GUIDE",
"DISCUSSION",
"LINK",
"MEDIA"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 3
},
"community": {
"type": "string"
},
"ai_content": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"hook_pattern": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"median_score": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"self_promotion": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"winning_format": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"median_comments": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"promotion_venue": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
]
},
"weekly_active_users": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 5
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"new_research": {
"type": "boolean"
},
"excluded_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"error": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
}trendsfast_ask_trends annotations
{
"title": "Ask about trends",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}trendsfast_read_result — Read a saved result
Advertised read-only
Read a saved result, page it on next_cursor, or recover an exact accepted request ID. No credit debit or research. Source permissions, retention and context are rechecked.
trendsfast_read_result input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"cursor": {
"type": "string",
"maxLength": 512
},
"result_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"x-mcp-header": "request-id"
}
},
"additionalProperties": false
}trendsfast_read_result output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"version",
"result_id",
"request_id",
"operation",
"generated_at",
"read_at",
"new_research",
"usage",
"next_cursor",
"context",
"window",
"brief",
"items",
"excluded_count",
"truncated",
"coverage",
"communities",
"ai_answers",
"answer",
"limitations"
],
"properties": {
"brief": {
"anyOf": [
{
"type": "object",
"required": [
"headline",
"sections",
"coverage_gaps",
"next_steps"
],
"properties": {
"headline": {
"type": "string",
"maxLength": 600
},
"sections": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"status",
"count",
"item_ids",
"note"
],
"properties": {
"key": {
"enum": [
"TRENDING_NOW",
"AUDIENCE_CONVERSATIONS",
"CREATIVE_REFERENCES",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCES"
],
"type": "string"
},
"note": {
"type": "string",
"maxLength": 300
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"status": {
"enum": [
"AVAILABLE",
"EMPTY",
"NOT_COLLECTED",
"NEEDS_CONTEXT"
],
"type": "string"
},
"item_ids": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20
}
},
"additionalProperties": false
},
"maxItems": 6
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 5
},
"coverage_gaps": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"note"
],
"properties": {
"note": {
"type": "string",
"maxLength": 200
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 10
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"ring",
"signal",
"measured_growth",
"freshness",
"platform",
"source",
"url",
"creator",
"title",
"excerpt",
"published_at",
"observed_at",
"metrics",
"community",
"question",
"problem",
"hook",
"format",
"relevance",
"evidence_class",
"uses",
"caution",
"topic_history"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hook": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"uses": {
"type": "array",
"items": {
"enum": [
"POST_TOPIC",
"DISCUSSION_TO_READ",
"CUSTOMER_PROBLEM",
"FEATURE_INPUT",
"VIDEO_TOPIC",
"TITLE_REFERENCE",
"FORMAT_REFERENCE",
"HOOK_REFERENCE",
"SEARCH_KEYWORD",
"COMPETITOR_WATCH",
"BACKGROUND_ONLY"
],
"type": "string"
},
"maxItems": 3
},
"title": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"format": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"signal": {
"enum": [
"POPULAR_NOW",
"RISING",
"EMERGING",
"RECURRING_PROBLEM",
"SEARCH_INTEREST",
"CREATIVE_PATTERN",
"NEW_DEVELOPMENT",
"INSUFFICIENT_EVIDENCE"
],
"type": "string"
},
"source": {
"type": "string",
"maxLength": 120
},
"caution": {
"anyOf": [
{
"type": "string",
"maxLength": 100
},
{
"type": "null"
}
]
},
"creator": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"metrics": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "number"
}
},
"problem": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"question": {
"anyOf": [
{
"type": "string",
"maxLength": 160
},
{
"type": "null"
}
]
},
"community": {
"anyOf": [
{
"type": "string",
"maxLength": 180
},
{
"type": "null"
}
]
},
"freshness": {
"enum": [
"CURRENT_DATED_REFERENCE",
"BACKGROUND_REFERENCE",
"UNDATED_REFERENCE",
"MODELED_PERIOD_NOT_CURRENT_MOMENTUM"
],
"type": "string"
},
"relevance": {
"type": "object",
"required": [
"score",
"why"
],
"properties": {
"why": {
"type": "string",
"maxLength": 100
},
"score": {
"type": "number",
"maximum": 1,
"minimum": 0
}
},
"additionalProperties": false
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"topic_history": {
"anyOf": [
{
"type": "object",
"required": [
"state",
"since",
"peak_day",
"channels",
"velocity"
],
"properties": {
"since": {
"type": "string"
},
"state": {
"enum": [
"EMERGING",
"RISING",
"PEAKING",
"DECLINING",
"EVERGREEN"
],
"type": "string"
},
"channels": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"peak_day": {
"type": "string"
},
"velocity": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"evidence_class": {
"anyOf": [
{
"enum": [
"TREND_SIGNAL",
"AUDIENCE_EVIDENCE",
"CREATIVE_EXAMPLE",
"SEARCH_DEMAND",
"COMPETITOR_ACTIVITY",
"REFERENCE_ONLY"
],
"type": "string"
},
{
"type": "null"
}
]
},
"measured_growth": {
"enum": [
"INCREASING_OBSERVED",
"DECREASING_OBSERVED",
"UNCHANGED_OBSERVED",
"NOT_COMPARABLE"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 100
},
"usage": {
"type": "object",
"required": [
"credits_charged",
"this_request_credits",
"replayed"
],
"properties": {
"replayed": {
"type": "boolean"
},
"credits_charged": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"this_request_credits": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"answer": {
"anyOf": [
{
"type": "object",
"required": [
"question",
"answer_status",
"answer",
"findings",
"missing_inputs",
"next_steps"
],
"properties": {
"answer": {
"type": "string",
"maxLength": 1500
},
"findings": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"item_id",
"title",
"statement",
"platform",
"source",
"url",
"metrics",
"published_at",
"ring"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"format": "uri",
"maxLength": 2048
},
{
"type": "null"
}
]
},
"kind": {
"enum": [
"TREND",
"CUSTOMER_PROBLEM",
"FEATURE_REQUEST",
"QUESTION_ASKED",
"HOOK_OBSERVED",
"FORMAT_OBSERVED",
"TITLE_OBSERVED",
"SEARCH_DEMAND",
"COMPETITOR_POST",
"COMPETITOR_MENTION",
"RELATED_DISCUSSION",
"REFERENCE"
],
"type": "string"
},
"ring": {
"enum": [
"CORE",
"ADJACENT",
"GLOBAL"
],
"type": "string"
},
"title": {
"type": "string",
"maxLength": 240
},
"source": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"item_id": {
"type": "string",
"pattern": "^[a-z][a-z0-9_-]{2,95}$"
},
"metrics": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"statement": {
"type": "string",
"maxLength": 400
},
"published_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 20
},
"question": {
"type": "string",
"maxLength": 1000
},
"next_steps": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
},
"answer_status": {
"anyOf": [
{
"enum": [
"ANSWERED",
"PARTIAL",
"INSUFFICIENT_EVIDENCE",
"NEEDS_CONTEXT",
"NOT_COLLECTED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"missing_inputs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 8
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"window": {
"type": "object",
"required": [
"lookback_hours",
"observed_from",
"observed_to"
],
"properties": {
"observed_to": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"observed_from": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"lookback_hours": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"context": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"context_id",
"revision"
],
"properties": {
"kind": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"context_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"read_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"version": {
"type": "string",
"const": "trends-mcp-compact-v3"
},
"coverage": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"platform",
"status",
"observation_count",
"last_observed_at"
],
"properties": {
"source": {
"type": "string",
"maxLength": 200
},
"status": {
"type": "string"
},
"platform": {
"enum": [
"TIKTOK",
"YOUTUBE",
"INSTAGRAM",
"FACEBOOK",
"X",
"REDDIT",
"GOOGLE",
"BING",
"AI_SEARCH",
"WEB",
"FORUM",
"GITHUB"
],
"type": "string"
},
"last_observed_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
{
"type": "null"
}
]
},
"observation_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 40
},
"operation": {
"enum": [
"global",
"niche",
"ask",
"discover"
],
"type": "string"
},
"result_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"truncated": {
"type": "boolean"
},
"ai_answers": {
"anyOf": [
{
"type": "object",
"required": [
"asked",
"answers"
],
"properties": {
"asked": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"model",
"mentions_you",
"competitors_named",
"names",
"cited_domains",
"excerpt"
],
"properties": {
"model": {
"type": "string",
"maxLength": 100
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 10
},
"excerpt": {
"anyOf": [
{
"type": "string",
"maxLength": 400
},
{
"type": "null"
}
]
},
"platform": {
"enum": [
"CHATGPT",
"PERPLEXITY",
"GEMINI",
"CLAUDE"
],
"type": "string"
},
"mentions_you": {
"type": "boolean"
},
"cited_domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253
},
"maxItems": 8
},
"competitors_named": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 8
}
},
"additionalProperties": false
},
"maxItems": 12
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"request_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"communities": {
"type": "array",
"items": {
"type": "object",
"required": [
"community",
"url",
"status",
"weekly_active_users",
"self_promotion",
"links",
"ai_content",
"promotion_venue",
"rules",
"formats",
"median_score",
"median_comments",
"winning_format",
"hook_pattern",
"avoid",
"pinned",
"play"
],
"properties": {
"url": {
"type": "string"
},
"play": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300
},
"maxItems": 4
},
"avoid": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"links": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"rules": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 120
},
"number": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"maxItems": 10
},
"pinned": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url"
],
"properties": {
"url": {
"type": "string"
},
"title": {
"type": "string",
"maxLength": 160
}
},
"additionalProperties": false
},
"maxItems": 3
},
"status": {
"enum": [
"PROFILED",
"NOT_FOUND",
"UNAVAILABLE"
],
"type": "string"
},
"formats": {
"type": "array",
"items": {
"type": "object",
"required": [
"format",
"share"
],
"properties": {
"share": {
"type": "number"
},
"format": {
"enum": [
"QUESTION",
"STORY",
"SHOWCASE",
"GUIDE",
"DISCUSSION",
"LINK",
"MEDIA"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 3
},
"community": {
"type": "string"
},
"ai_content": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"hook_pattern": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"median_score": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
]
},
"self_promotion": {
"type": "object",
"required": [
"policy",
"rules"
],
"properties": {
"rules": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"maxItems": 10
},
"policy": {
"enum": [
"ALLOWED",
"RESTRICTED",
"NOT_ALLOWED",
"UNKNOWN"
],
"type": "string"
}
},
"additionalProperties": false
},
"winning_format": {
"anyOf": [
{
"type": "string",
"maxLength": 300
},
{
"type": "null"
}
]
},
"median_comments": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"promotion_venue": {
"anyOf": [
{
"type": "string",
"maxLength": 120
},
{
"type": "null"
}
]
},
"weekly_active_users": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"maxItems": 5
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
},
"maxItems": 3
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 512
},
{
"type": "null"
}
]
},
"generated_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
},
"new_research": {
"type": "boolean"
},
"excluded_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"error": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
}trendsfast_read_result annotations
{
"title": "Read a saved result",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}trendsfast_project_context — Project context
Advertised read-only
Read the connected project name, ID and current confirmed niche context, or an explicit missing-context state. Returns the context_id that niche and Ask queries accept. No credit debit, context mutation or new research.
trendsfast_project_context input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}trendsfast_project_context output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"project_id",
"project_name",
"context",
"limitations"
],
"properties": {
"context": {
"anyOf": [
{
"type": "object",
"required": [
"kind",
"context_id",
"revision",
"fields"
],
"properties": {
"kind": {
"enum": [
"CONFIRMED_CONTEXT",
"TEMPORARY_INPUT"
],
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"value",
"basis",
"evidence_ids"
],
"properties": {
"basis": {
"enum": [
"OWNER_CONFIRMED",
"WEBSITE_OBSERVED",
"USER_ASSERTED",
"INFERRED"
],
"type": "string"
},
"field": {
"enum": [
"description",
"topic",
"problem",
"audience",
"exclusion",
"capability",
"job",
"industry",
"product_category",
"customer_interest",
"competitor",
"adjacent_category",
"market",
"language",
"platform",
"community",
"competitor_handle",
"competitor_domain",
"keyword"
],
"type": "string"
},
"value": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"evidence_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"maxItems": 20
}
},
"additionalProperties": false
},
"maxItems": 250,
"minItems": 1
},
"revision": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"context_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"project_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"limitations": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1000
},
"maxItems": 10
},
"project_name": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"error": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
}trendsfast_project_context annotations
{
"title": "Project context",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}trendsfast_credit_balance — Credit balance
Advertised read-only
Read the shared REST/MCP credit balance, monthly/prepaid split, reservations and pause state without spending credits.
trendsfast_credit_balance input schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
}trendsfast_credit_balance output schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean"
},
"data": {
"type": "object",
"required": [
"version",
"accountId",
"available",
"free",
"monthly",
"prepaid",
"reserved",
"consumed",
"debt",
"paused",
"lots"
],
"properties": {
"debt": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"free": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"lots": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"total",
"consumed",
"reserved",
"revoked",
"available",
"expiresAt"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"kind": {
"enum": [
"FREE",
"MONTHLY",
"PREPAID"
],
"type": "string"
},
"total": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"revoked": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"consumed": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"reserved": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"available": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"expiresAt": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"paused": {
"type": "boolean"
},
"monthly": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"prepaid": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"version": {
"type": "string",
"const": "credit-wallet-v3"
},
"consumed": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"reserved": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"accountId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"available": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"error": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
},
"additionalProperties": false
}trendsfast_credit_balance annotations
{
"title": "Credit balance",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 4280 ms
- 95th percentile latency
- 4280 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 4280 ms · metadata changed · 7 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http trendsfast-mcp https://trendsfast.com/api/mcp/v3Codex
Codex configuration
codex mcp add trendsfast-mcp --url https://trendsfast.com/api/mcp/v3Cursor
Cursor configuration
{
"mcpServers": {
"trendsfast-mcp": {
"url": "https://trendsfast.com/api/mcp/v3"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"trendsfast-mcp": {
"type": "streamableHttp",
"url": "https://trendsfast.com/api/mcp/v3",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"trendsfast-mcp": {
"type": "http",
"url": "https://trendsfast.com/api/mcp/v3"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http trendsfast-mcp https://trendsfast.com/api/mcp/v3Claude Desktop
Claude Desktop configuration
{
"mcpServers": {
"trendsfast-mcp": {
"url": "https://trendsfast.com/api/mcp/v3"
}
}
}Windsurf
Windsurf configuration
{
"mcpServers": {
"trendsfast-mcp": {
"serverUrl": "https://trendsfast.com/api/mcp/v3"
}
}
}Let your agent find its tools
Find servers like TrendsFast MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run TrendsFast MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.