com.meetsponsors/mcp

Poll the progress of a bulk import batch by its batchId. Returns total/queued/done/failed counts plus startedAt/finishedAt timestamps. Batches expire after 7 days.

Get detailed information about a specific sponsor by ID. Strips raw scrape data and llm internal analysis blobs.

Get the most active sponsors in a given period (week/month/year), optionally filtered by language. Returns compact format.

Get the most recent collaboration (one video per YouTuber) with a sponsor, sorted by publication date

Get the most recent sponsored videos from a sponsor, ordered by publication date

Search sponsors by name, description, industry tags, or filters. Returns compact results (id, name, tagline = what the brand sells in a few words, website, niches, industryTags, country, operations, medianSubscribers). Use sponsor_get for full detail on a specific sponsor.

Find sponsors similar to a given sponsor based on industry tags and niches. Returns compact format.

Get statistics for a sponsor: number of YouTubers, median subscribers, operations per week/month/year

Get YouTubers who have worked with a sponsor. Returns compact format.

Add a single YouTuber to the database and trigger the full enrichment pipeline (tags, niches, description, similarity, sponsor detection). Returns a batchId you can poll with import_status. Prefer passing a channel ID (UCxxxxxxxxxxxxxxxxxxxxxx, 24 chars) — handles ('@xxx') and URLs work too but cost an extra YouTube API quota point per call to resolve.

Add up to 50 YouTubers in one call and trigger enrichment for each. Returns a batchId you can poll with import_status. Strongly prefer channel IDs (UCxxxxxxxxxxxxxxxxxxxxxx, 24 chars) over handles/URLs — handles cost an extra YouTube API quota point each, which depletes the daily 10k budget faster.

Agent plan only. Run sponsor detection on the ENTIRE video history of a YouTuber already in the database (not just the latest videos like youtuber_refresh), and re-check older automatic rejections with the current detection pipeline — use it when youtuber_sponsors looks incomplete for a channel with a long sponsorship history. Costs 200 requests of your monthly MCP quota. Refused when the channel had a full analysis less than 30 days ago (check lastFullAnalysisAt from youtuber_get first). Runs in the background (from several minutes to an hour on big channels); when lastFullAnalysisAt in youtuber_get moves, youtuber_sponsors reflects the result. For a channel not in the database yet, use youtuber_add.

Get detailed information about a specific YouTuber by their YouTube channel ID. Includes llmDescription and llmSponsorProfile (LLM-friendly summaries), lastAnalyzedAt (when sponsors were last detected on the channel — every channel is re-scanned weekly; use youtuber_refresh if it is older than 7 days and you need fresher data), and lastFullAnalysisAt (last full-history analysis; null if never — see youtuber_fullAnalysis).

Get the biggest YouTubers who have been active recently (last 15 days) for a specific language. Returns compact format.

Get the most recent sponsored videos from a YouTuber, with one video per sponsor (sorted by publication date)

Re-run sponsor detection on a YouTuber already in the database (latest videos). Costs 50 requests of your monthly MCP quota. Refused when the channel was analyzed less than 7 days ago — every channel is re-scanned weekly, so check lastAnalyzedAt from youtuber_get first. Runs in the background (a few minutes); call youtuber_get / youtuber_sponsors afterwards. For a channel not in the database yet, use youtuber_add.

Search YouTubers with advanced filters: subscribers, language, niches, sponsors worked with, monthly frequency, etc. All filters combine with AND — including hasWorkedWith, which keeps only creators who worked with EVERY listed domain. For "worked with brand A OR brand B", run one search per brand (or use sponsor_youtubers). Returns compact results. Use youtuber_get for full detail.

Find YouTubers similar to a given YouTuber based on content, niches, and sponsors. Returns compact format.

Get sponsors a YouTuber has worked with, including video counts for each sponsor. Sorted by most recent sponsored video first (sortBy=lastVideo, default) or by first collaboration (sortBy=firstVideo). Paginated: use offset with limit (max 50 per page) and hasMore to walk big channels. Returns compact format.