Skip to main content
Your AI assistant picks and calls these tools on its own. You do not need to name them in your prompts, but knowing them helps you ask precise questions.

Conventions

  • Same data as the dashboard. Search tools use the same filters, the same ranking, and the same data as Copyfy Discovery, so a search returns what you would see in the dashboard with the same filters. One exception: when your keyword matches no product title in the selected markets, search_products searches its translation once and says so in query_rewrite (exact_query: true turns this off).
  • Account actions only when you ask. Most tools only read, and are annotated readOnlyHint: true. track_shop, untrack_shop, save_items, remove_saved_item, and share_tracked_shops change your Copyfy account. They are annotated readOnlyHint: false, plus destructiveHint: true for the two that remove items, so your client can ask for your approval before running them, and Copyfy’s server instructions tell the assistant to call them only at your request. No tool changes your plan or billing.
  • Tracked stores. get_product, get_tracking_feed, get_shop_insights, analyze_ad, and the analytics of get_shop work on stores you track in Copyfy, as in the dashboard. Results say whether a store is tracked with is_tracked, and track_shop tracks one when you ask. get_ad_script returns the script of any ad whose video Copyfy has transcribed, tracked store or not.
  • One vocabulary. Arguments are snake_case and shared across tools: niches, countries, monthly_revenue, page, per_page, and so on. Numeric filters are ranges, written { "min": 1000, "max": 50000 }.
  • Structured results. Each result is returned as structuredContent and as the same JSON in a text block. Search results have a results array and a pagination object:
  • Dashboard links. Results include a dashboard_url that opens the item in Copyfy.
  • Visual cards. In apps that support MCP Apps, such as Claude and ChatGPT, search_products, search_ads, search_ad_scripts, and get_shop results also appear as cards with images, prices, ad videos, and an Open in Copyfy button. Cards follow your app’s language (or your browser’s) and its light or dark theme, and they cost nothing extra. Other clients receive the same JSON without cards.
  • Errors. A refused or failed call returns isError: true with a stable error code. See Errors.

Untrusted content

Store names, product titles, ad copy, and ad scripts are written by third parties and scraped from the web. Copyfy’s server instructions tell the assistant to treat them as data and never follow instructions found inside them. If you build your own client on top of the Copyfy MCP, apply the same rule.