create_store_from_product, import_product_to_shopify, generate_ad_image, or copy_video_ad.
Cost: free.
Arguments
| Argument | Type | Allowed values |
|---|---|---|
job_id | string | The job.id returned by the creation tool, for example img_mcp-6f1c2a9e0b7d4c3a8e5f1b2c3d4e5f60. |
Example
Tool call
{
"name": "get_job_status",
"arguments": { "job_id": "img_mcp-6f1c2a9e0b7d4c3a8e5f1b2c3d4e5f60" }
}
{
"job": {
"id": "img_mcp-6f1c2a9e0b7d4c3a8e5f1b2c3d4e5f60",
"kind": "ad_image",
"created_at": "2026-10-27T09:14:02.000Z",
"status": "succeeded",
"images": [
{ "index": 0, "image_url": "https://bucket.copyfy.io/ai-creations/0.png", "aspect_ratio": "4:5", "model": "google/gemini-3.1-flash-image" },
{ "index": 1, "image_url": "https://bucket.copyfy.io/ai-creations/1.png", "aspect_ratio": "4:5", "model": "google/gemini-3.1-flash-image" }
],
"dashboard_url": "https://app.copyfy.io/dashboard/creatives-ai",
"library_url": "https://app.copyfy.io/library"
}
}
{
"job": {
"id": "sto_k3v9x2m1q8w7",
"kind": "store_ai",
"project": { "id": "k3v9x2m1q8w7", "title": "Example Pet Store", "status": "setup" },
"status": "action_required",
"phase": "finish_setup",
"next_action": { "type": "open_dashboard", "reason": "finish_store_setup", "url": "https://app.copyfy.io/dashboard/store-ai/k3v9x2m1q8w7/setup" },
"dashboard_url": "https://app.copyfy.io/dashboard/store-ai/k3v9x2m1q8w7/setup"
}
}
Statuses
status | Meaning |
|---|---|
starting | The job was accepted and has not started yet. Call again after poll_after_seconds. |
running | Work is in progress. Call again after poll_after_seconds. |
action_required | A Store AI job waits for you in Copyfy: open next_action.url. |
succeeded | Done: images, videos, shopify_product, or dashboard_url holds the result. |
partially_succeeded | Some images came out and others failed: images lists the ones that exist, failed_count the others. The AI credits are kept, as in the dashboard. |
failed | The job stopped. For image, video and Shopify import jobs, error says why and the MCP credit is given back. A failed generation also has its AI credits refunded, except an image generation that timed out (generation_timeout), which keeps them as in the dashboard. |
unknown | Copyfy cannot confirm the outcome, and the MCP credit is kept. A Shopify import lost track of its outcome: check the products in your Shopify admin before importing again. Or a generation started but its results were deleted from your Copyfy library (results_unavailable). |
Results by kind
kind | Started by | Result when it succeeds | Poll every |
|---|---|---|---|
ad_image | generate_ad_image | images: index, image_url, aspect_ratio, model | 10 s |
video_ad | copy_video_ad | videos: index, video_url, aspect_ratio, model | 30 s |
shopify_import | import_product_to_shopify | shop_domain, shopify_product (id, handle, title, status, admin_url), created_without_images | 5 s |
store_ai | create_store_from_product | project, phase, next_action, dashboard_url | 10 s, 60 s while the store builds |
succeeded, partially_succeeded, failed, unknown, or action_required. A job id of another account, or an unknown id, returns not_found. Polls count toward the rate limit of 30 calls per minute.