Skip to main content

Plans

MCP credits are separate from your dashboard research quota: using the MCP does not reduce your dashboard allowance, and the other way around. Upgrade from the Plans page.

What costs a credit

A successful call to a search, detail, or analysis tool costs 1 credit, whatever the number of results it returns, including the tools that combine several lookups in one call. A search that returns no results is free. The tools that list or change your own tracked stores and saved items, and the helper tools, are free. Calls that fail are free: invalid arguments, unknown items, search outages, rate limits, and plan or quota refusals never cost a credit. The one exception is a creation tool that answers service_unavailable with a job_id: Copyfy could not confirm that the job started, so the credit stays set aside until the job ends, and comes back if the job did not run. A search that returns no results is free too, including a page after the last result, and every successful search response states its cost in credits_used. A search still needs one credit left to start, even if it turns out empty. Each page of results is a separate call, so fetching page 2 costs another credit when it returns results.

AI credits

generate_ad_image and copy_video_ad also spend AI credits, the balance that Copyfy’s AI features share in the dashboard. MCP credits and AI credits are separate: these tools need one MCP credit and enough AI credits.
  • Copyfy checks your balance before starting. If it is too low, the call fails with insufficient_credits, which gives the cost, your balance, and a link to buy credits. Nothing is charged.
  • Pass max_ai_credits to cap what one call may spend: a call that would cost more fails with cost_limit_exceeded, and nothing is charged.
  • The MCP credit is set aside when the call starts and given back if the generation fails. If no image or video comes out, the AI credits are refunded too, except for an image generation that times out, which keeps them as in the dashboard.
  • get_usage shows your AI credit balance and, in ai_credits.spent_via_mcp, what these tools spent this period.

Monthly reset

Credits are monthly, including on yearly and quarterly subscriptions. They reset on your monthly credit renewal date, the same date your dashboard research quota resets. If Copyfy has no renewal date on file, the allowance covers the last 30 days on a rolling basis and resets_at is null. Unused credits do not roll over. To see your balance, ask your assistant “How many Copyfy credits do I have left?” (it calls the free get_usage tool), or open the Integrations page. Both show credits used, credits remaining, and the reset date.

When you run out

Search and detail tools return the quota_exceeded error with your usage and the reset date. list_filter_options and get_usage keep working. You can:
  • Wait for the reset date shown in the error.
  • Upgrade from Growth to Pro for 3,000 credits per month. The new allowance applies within a minute.

Rate limit

Each Copyfy account can make 30 tool calls per minute, across all connected clients and API keys. Above that, calls return rate_limited with a retry_after_seconds value. Rate-limited calls are free.

Result limits

These limits keep responses fast and readable for AI assistants.

Save credits

  • Let the assistant call list_filter_options first. It is free and avoids failed searches with unknown filter values.
  • Use precise filters (niche, country, revenue range) instead of paging through broad results.
  • Search products with the words stores use in their titles: English for most stores, the store language when you filter on French, German, or other non-English markets.
  • Ask for the number of results you need, for example “the top 10”, so the assistant requests one page.