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_creditsto cap what one call may spend: a call that would cost more fails withcost_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_usageshows your AI credit balance and, inai_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 andresets_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 thequota_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 returnrate_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_optionsfirst. 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.