MCP / Tools
Tools
Five tools cover video discovery, analysis, and automation filters. The connection is tied to your authorized workspace; global search looks across CreatorBerry’s video database.
Overview
| Tool | Purpose | Credits |
|---|---|---|
| filters | List automation filters in the selected workspace. | None |
| videos-watchlist | Find and rank videos from tracked channels in your workspace. | None |
| video-global | Search CreatorBerry’s global video database, beyond your watchlist. | None |
| analyze | Start analysis of a supported video or reuse completed analysis. | A successful new unlock costs one credit |
| analysis-result | Check an analysis or retrieve its completed result. | None |
filters
List automation filters in the selected workspace.
Inputs
| Parameter | Type | Use |
|---|---|---|
| status | Optional · all | active | inactive | Which filters to return. |
Result
Names, channel scope, thresholds, active status, daily analysis limit, and schedule. Read-only; edit filters in Setup > Automations.
videos-watchlist
Find and rank videos from tracked channels in your workspace.
Inputs
| Parameter | Type | Use |
|---|---|---|
| keyword, platform | Optional · string; youtube | tiktok | instagram | all | Search title or description and filter platform. |
| min_views, max_views; min_score, max_score; min_engagement, max_engagement | Optional · numbers | Set performance bounds. |
| posted_in_last_days, exclude_boosted, is_outlier | Optional · positive integer; booleans | Limit by age, exclude low-engagement videos, or prioritize outliers. |
| status_filter | Optional · Analyzed | Unanalyzed | All | Filter analysis status. |
| sort_by, sort_order | Optional · views | engagement_rate | outlier_score | publish_date; asc | desc | Rank and order results. |
| limit, offset | Optional · 1–50; number | Paginate results. |
Result
Tracked videos with creators, metrics, watch links, and the next analysis action.
video-global
Search CreatorBerry’s global video database, beyond your watchlist.
Inputs
| Parameter | Type | Use |
|---|---|---|
| query | Required · string | Natural-language topic. The old keyword input is an alias. |
| search_terms | Optional · up to 12 strings | Exact terms that also influence relevance. |
| platform; min_views, max_views; min_score, max_score; min_engagement, max_engagement | Optional · platform and numbers | Filter platform and performance. |
| posted_in_last_days, min_similarity | Optional · positive integer; -1 to 1 | Filter recency and semantic similarity. |
| sort_by, sort_order, limit | Optional · relevance | views | engagement_rate | outlier_score | publish_date; asc | desc; 1–50 | Order and limit results. |
Result
Video titles, creators, metrics, relevance, description previews, and watch links.
analyze
Start analysis of a supported video or reuse completed analysis.
Inputs
| Parameter | Type | Use |
|---|---|---|
| url | Exactly one of url or video_id · URL | YouTube, TikTok, or Instagram video URL. |
| video_id | Exactly one of url or video_id · UUID | Existing CreatorBerry video ID. |
Result
Video ID and analysis status. If processing, use analysis-result with that ID. Requires analysis permission.
Completed workspace analyses are reused. A successful new unlock can use one CreatorBerry credit.
analysis-result
Check an analysis or retrieve its completed result.
Inputs
| Parameter | Type | Use |
|---|---|---|
| video_id | Required · UUID | Video ID returned by analyze. |
Result
Current status or completed source metrics, transcript, and creative analysis.