Docs — Connect Ecom Magic AI to your AI

Generate ads, landings, logos, mockups, research, ad spy and financial analysis from Claude, ChatGPT, Codex, Cursor or any MCP-compatible client.

MCP server URL (paste it in your AI client)

https://ecom-magic.ai/mcp/v1

Clients validated with this URL: Claude.ai, Claude Desktop, Claude Code and Codex (Cursor and ChatGPT are compatible, not validated yet). In Claude or ChatGPT: Settings → Connectors → Add custom connector → paste the URL → sign in to Ecom Magic and authorize. In Claude Code: claude mcp add --transport http ecom-magic <URL>. In Codex: codex mcp add ecom-magic --url <URL> then codex mcp login ecom-magic. In Cursor: add the server with the URL and click Authenticate. Then ask your AI to generate ads, landings, etc.

How it works

Key concepts: connection, async jobs, credits and images.

  • Async + polling Generate, translate, resize and research return a job_id. Call jobs_get every 3-5s until status='succeeded' (output has the URL/data) or 'failed'.
  • Credits Generate/translate/resize/edit costs 1 credit per piece. Product research 3-6 by model; sales angles and avatar 3-6. Spy: free with a monthly subscription, mentors and admin; prepaid and trial pay 1 per new search (paging is free). Bulk ads/landings: 1 per piece, up to the current cap (max 50). Keyword 1. Competitor 20 (on completion). Video: translate 1 credit per 10s PER language; transcribe 1. Financial analysis, research_generic_angle, reads (list/get/download) and translating the transcribed text are free.
  • Images: URL or base64 For each image field pass a public URL (*_url) or the image in base64 (*_base64 + *_mime_type: PNG/JPEG/WebP). If the user attaches an image, upload it with assets_upload and use the URL.
  • Reference vs product photo The REFERENCE image (reference_*) defines the style/design (catalog template or your own). The PRODUCT photo(s) (product_image_*) are the real product to integrate. Ad: 1 product; landing/logo/mockup: up to 3.
  • Marketing fields Optional but improve results: sales_angle, specific_problem, target_avatar, ideal_solution, additional_instructions. If omitted, the engine infers them.
  • Plan access MCP/CLI and REST API: Prepaid plan and from the Basic plan up (Basic, Pro, Business, Agency), mentors and admin. The free trial account cannot connect MCP or the API. All paid plans get access to every tool.
  • Ad generator Create, translate and resize ads (banners) with AI.
  • Landing generator Generate landing page sections, including offer and logistics.
  • Logo generator Create brand logos with AI.
  • Mockup generator Create and translate packaging mockups.
  • Product research AI research: product, sales angles and avatar.
  • Keyword research Volume, CPC, competition, related keywords and trend for a search term.
  • Competitor research Analyzes a product's competition in a market and returns an opportunity verdict.
  • Videos: translate and transcribe Translate videos with dubbing + lip-sync and transcribe their script to text.
  • Ad spy Competitor ads on Meta, Google and TikTok Shop.
  • Financial analysis Sale price and KPIs calculator (COD and prepaid).
  • Products User product catalog.
  • Templates Reference template gallery.
  • Assets and images Upload images and list generated pieces.
  • Account and credits Profile, balance and credit usage.
  • Jobs Status of async operations.
  • Help Embedded usage manual.