> ## Documentation Index
> Fetch the complete documentation index at: https://docs.copyfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools overview

> The tools the Copyfy MCP server exposes, what they cost, and the conventions they share.

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.

| Tool                                                | What it does                                                 | Cost     |
| --------------------------------------------------- | ------------------------------------------------------------ | -------- |
| [`search_products`](/tools/search-products)         | Search winning products from Shopify stores                  | 1 credit |
| [`search_shops`](/tools/search-shops)               | Search Shopify stores                                        | 1 credit |
| [`search_ads`](/tools/search-ads)                   | Search Meta ads run by Shopify stores                        | 1 credit |
| [`get_shop`](/tools/get-shop)                       | Get one store with its best products and ads                 | 1 credit |
| [`get_product`](/tools/get-product)                 | Get the details of one product                               | 1 credit |
| [`list_filter_options`](/tools/list-filter-options) | List valid filter values (niches, countries, apps, and more) | Free     |
| [`get_usage`](/tools/get-usage)                     | Show your plan, credits used, and reset date                 | Free     |

## 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:

  ```json theme={null}
  { "page": 1, "per_page": 10, "total": 1284, "has_more": true }
  ```

* **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](/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.