🌟Best practices
Origin Insights MCP answers business questions in natural language about content strategy, distribution, and market analysis. You ask for the outcome you want; the assistant selects the right domain tool and action behind the scenes. These are effective ways to query it.
Sample queries
"Which titles have high demand but low availability in this market?"
Titles ranked by demand with the catalog presence gap — an editorial/licensing opportunity.
"How do platforms in Brazil compare on catalog and pricing?"
Side-by-side comparison: catalog size, content mix, prices, and tiers.
"Where is this title available and under which business model?"
Country-by-country breakdown: platform, model (SVOD/TVOD/AVOD), and price.
"What are the top sci-fi shows on Netflix in 2024?"
Catalog exploration filtered by genre, platform, and year, with metadata.
"What moved in the market this week?"
A market radar: demand risers/fallers, catalog entries/exits, and plan repricings.
"Should we renew the license for this title in Brazil?"
A keep-or-drop verdict with confidence and supporting demand + reach evidence.
By role
Content buyer: "What should I acquire for Latin America — high-demand titles my market can't stream?" · "Which titles are leaving Netflix US soon, and where else do they stream?" · "Which upcoming releases have the strongest pre-release buzz?"
Pricing analyst: "Compare subscription plans and prices across services in Argentina." · "How has the rent/buy price of this title changed over time?" · "Which services run free trials or promos in Mexico right now?"
Market researcher: "Compare the catalogs of Netflix and Max in Spain — how much overlaps?" · "Which genres are trending in Brazil, and which titles drive that demand?"
Recommendations
Narrow the context: specify country, platform, and time window where they apply — the answers are more precise and faster.
Ask a business question, not a query: ask for the outcome you want ("where should we launch X?"), not for tables or columns.
Ask for reports: for a full visual report on a title use
generate_title_report;add_executive_insightsenriches any report with executive analysis. Market-wide reports (radar, trends, calendar, plans, promos) live under thereports_markettool.Lean on playbooks for decisions:
compare_titles,evaluate_license_renewal,build_acquisition_brief, andcalculate_platform_valuerun several lookups and return one decision-ready answer.SQL as a last resort:
execute_sql/query_raw_dataexist for bespoke exploration, but the domain tools cover most cases.
Example agent session
Goal: decide whether a title is worth licensing in a market — check its demand, see where it already streams, and produce a shareable report.
Each step is a single tool call with one action. You never chain actions inside a call — pick one action per call, feed the result (usually a uid) into the next.
Errors, retries & safety
Read-only: all tools read from the catalog; nothing writes back. Any
get_*/find_*/search_*/measure_*action is safe to retry.Title resolution first: most title-level actions need a
uid. Usetitles → find_title(or passtitle_search) to resolve it. If several catalog entries match, the tool returns a numbered candidate list instead of data — pick one, then call again with thatuid.Ambiguous matches: when a title or platform name is ambiguous, the response lists options rather than guessing. Confirm the choice and re-issue the call.
Misses are explicit: if something isn't in the catalog, the answer says so verbatim ("Not available in the Origin Insights catalog") rather than inventing data.
Validate before advanced queries: for
raw_data → execute_sql, uselist_tables/get_table_schemafirst, and prefer the domain tools whenever one fits.
Governance & data
Catalog-scoped: every answer is grounded in the Origin Insights catalog for the turn — no external sources.
Freshness: ask "when was this data last updated?" (
data_guide → check_data_freshness) to see per-domain refresh timestamps before relying on a number.Methodology: ask "how is the demand score built?" (
data_guide → explain_demand_scores) or any how-it-works question (data_guide → ask_knowledge_base).Reports render in English regardless of the query language.
See also
Getting started — data domains and the full tool catalog.
MCP access — connection methods.
We hope you found this article helpful. If you have a question this article doesn't address, reach out on the Service Desk.
Last updated

