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.
  • Read-only. Every tool is annotated readOnlyHint: true and idempotentHint: true. None of them changes your account.
  • 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.
  • Errors. A refused or failed call returns isError: true with a stable error code. See Errors.

​
Untrusted content

Store names, product titles, and ad copy 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.