trending-research_search MCP tool: Reels and TikTok trends, $0.10
The hosted MCP tool trending-research_search finds trending Instagram Reels and TikTok videos for a niche at about $0.10 per search. YouTube is not supported.
trending-research_search is a hosted Sume MCP tool that searches trending Instagram Reels and TikTok videos for a niche. It posts to /v1/trending-research and costs about $0.10 per accepted search. It is discovery only: it returns metadata, with no CDN download, and YouTube is not supported (MCP tools and gates).
What you pass
The tool is a paid write call, so a client may ask the user to confirm it first. It does not need a generation runtime, because it reads public social content.
| Payload field | Use |
|---|---|
query | What the user typed. It wins when it is present. |
category | The niche from Brand DNA, used when there is no query. |
brand_position | The fallback when there is neither. |
limit | 1 to 24 results. |
Where it fits in a trend-reaction workflow
For a long-running trend watch, put the search inside the instructions of a scheduled agent, and let the schedule's spend cap bound the number of searches.
- Run it from an Agent that is asked what is trending in a niche today.
- Pick one result, and give its URL to a Format run as
input. - Do not use it to download the video. Fetch media only from sources you may use.
- If it answers that social discovery is not configured, stop and report it. Do not fall back to a text-only scan.
Search versus a trending-videos call
The trending-videos API is the direct REST call. The MCP tool wraps research for an agent and adds the Brand DNA defaults above. Pick the REST call for code you own, and the MCP tool for a client that already speaks MCP.
Sources
Related posts
More in Agents
- Trim pauses from ten clips: inspect segments, then one timeline render
Rough-cut apps trim pauses in their own editor. For a batch by API, inspect each clip for sentence segments, keep the speech, and render one timeline.
- Weekly video: Agent Completion, Format or schedule on Sume?
A weekly video fits a Format or a schedule, not a fresh Agent Completion each time. How to choose among the three Sume surfaces for a recurring job.
- Run the Sume video agent from your backend with Agent Completions
POST /v1/agent/completions runs the same agent as the Sume Agents chat, with tools and media generation, and returns an async run receipt you poll or webhook.
- Safe automation for AI agents that call paid APIs
Keep agents read-only by default, keep secrets out of logs, and on hosted MCP send an idempotency_key, preview with dry_run, and cap with max_spend_usd.
Written by Sume