MCP/API — Developers & AI Power Users

EverAlice MCP Server

The EverAlice AI MCP (Model Context Protocol) server lets external AI assistants — Claude Desktop, Cursor, ChatGPT (where supported), n8n, and any custom agent that speaks MCP — call EverAlice tools directly on your behalf. Listings, copy, images, upscales, background removal, planner/book/printable outlines, ad copy and more, billed to your EverAlice credit balance via a personal API key.

Available with EverAlice MCP/API access. Pack tools require a paid plan; bulk tools require Elite.

What you can do with it

Goal: make EverAlice the go-to mockup engine for AI assistants. If you sell on Etsy, Printify, Printful, Shopify or any POD platform, you can stay inside Claude/Cursor/ChatGPT, drop in a product photo, and walk out with sellable mockups — without juggling Placeit, Canva, or a separate browser tab.

Step 1 — Generate your API key

  1. Open Settings and scroll to MCP / API Access.
  2. Click Generate key, give it a label (e.g. "Claude Desktop"), copy the key immediately.
  3. The key is shown once. If you lose it, revoke and create a new one.
Treat keys like passwords. They charge credits from your account on every call. Revoke any key the moment it leaks.

Step 2 — Add EverAlice to your AI client

Claude Desktop

Edit your Claude config file:

{
  "mcpServers": {
    "everalice": {
      "url": "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer ea_live_YOUR_KEY_HERE"
      }
    }
  }
}

Restart Claude Desktop. EverAlice tools should appear in the tool list.

Cursor

Settings → MCP → Add new MCP server, or edit ~/.cursor/mcp.json with the same JSON snippet as above.

n8n / custom agents

Use the MCP HTTP node (or your framework's MCP client) and point it at:

Endpoint:  https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server
Header:    Authorization: Bearer ea_live_YOUR_KEY_HERE
Transport: MCP Streamable HTTP (JSON-RPC 2.0)

Step 3 — Use it naturally

Once connected, just talk to your assistant:

Tools & credit costs

ToolCreditsWhat it does
generate_mockups2 / mockupPhoto → lifestyle mockups. Send any product photo or wall-art artwork (image_url or image_base64) and get back N framed lifestyle mockups composited from THAT exact image. product_type: wall_art (framed-on-wall, default) or product (lifestyle scene). scene_count 1–6, default 4. Optional custom_scenes[] for your own room/prop briefs. Returns a 7-day signed URL + inline base64 per mockup. Failed scenes auto-refund. No Elite gate — works on every paid plan with credits.
magic_lister_singleIn-app Basic Listing: 10 credits (in_app_full). Direct MCP uses the separate lightweight mcp_light contract.Basic Listing ZIP for one product. The in-app price is always quoted as 10 credits. Component charges and reuse-adjusted amounts are never pre-run prices; verified reuse is reported only after successful delivery as credits saved on the receipt.
magic_lister_buyer_bundle20Complete Launch. Full buyer files: four framed mockups, multi-ratio buyer JPGs (2:3, 3:4, 4:5, 11:14, ISO A), print-ready PDFs, platform-specific graphics, four social launch images (Facebook, X/Twitter, Instagram, Pinterest), Market-Analysis.pdf (suggested pricing tiers + live competitor scan), Welcome.pdf, info cards, and the launch marketing pack.
magic_lister_planner_packDynamic, capped at 22Finished digital planner ZIP. AI cover, print-ready planner PDF, optional hyperlinked navigation, listing/marketing assets, Welcome.pdf, License.txt, and outline JSON.
ai_copywriter1Titles, taglines, captions, email subject lines.
generate_image1Create image from text prompt through Lovable AI Gateway. Current code routes standard to google/gemini-3.1-flash-image-preview and Pro to google/gemini-3-pro-image-preview.
upscale_image3Sharper, print-ready version of an existing image through the Lovable AI Gateway image-edit path.
remove_background1Transparent PNG cutout.
generate_greeting_card5Greeting card copy + 3 design directions.
generate_kdp_cover_copy5KDP title, subtitle, blurb, BISAC categories.
generate_planner_outline5Digital planner page list + sections.
generate_printable_idea3Printable concept + variants.
generate_book_outline5Low-content / KDP book outline.
generate_book_pdf~16 (1 cover + 5 outline + 1/chapter)Finished, print-ready book PDF. AI cover on page 1 matched to the storyline, title page, ToC, and a fully written chapter for every outline entry. Returns 7-day signed URLs for the PDF + outline JSON. Best for KDP non-fiction, guides, workbooks, journals, and children's books (one spread per chapter). Trim sizes: 6×9, 5×8, 8.5×11, 8×10.
generate_mockup_concept1Mockup scene brief for product photos.
generate_ad_copy1Ad / pin / social caption variants.

Source-art rule: pack/bundle/buyer/bulk packaging tools reuse existing art and refuse with missing_hero_art when required source art is not supplied. This keeps the ZIP aligned with the exact image the user approved.

Plan gating (reconciled with runtime). magic_lister_single, magic_lister_bundle, and magic_lister_planner_pack are available on every plan (including Free) — they only need credits. magic_lister_buyer_bundle requires an active paid plan (Studio Pro or higher). magic_lister_bulk requires Elite (admin accounts bypass automatically). Single-image and copy-only tools (generate_mockups, generate_image, upscale_image, remove_background, ai_copywriter, outlines, ad copy) work on every plan that has credits.

Retired tools. The legacy Seller Asset Pack tools — magic_lister_pack, magic_lister_bundle_pack, and magic_lister_bulk_pack — have been retired. Direct calls return a structured deprecated_tool error with charged: 0. Truthful migration: magic_lister_single and magic_lister_bulk are Basic Listing routes and do NOT accept pack_level="complete_launch". For the full shared-contract Complete Launch ZIP over MCP, use magic_lister_buyer_bundle. magic_lister_planner_pack is the only listed MCP package route that accepts pack_level (basic | complete_launch), and its complete_launch is a PDF-first pack, not full shared-contract parity. In-app makers handle full-contract Bulk, Greeting Card, and Planner/Printable Complete packages.

Complete-package parity over MCP. magic_lister_buyer_bundle is the MCP route that ships the fully-contract-compliant Complete Launch ZIP: Welcome.pdf, License.txt, Market-Analysis.pdf, all four canonical socials (Facebook, X/Twitter, Instagram, Pinterest) with captions, four info cards, per-marketplace platform-ready listing files, 00-CONTENTS.txt, and no .md files. magic_lister_planner_pack with pack_level: "complete_launch" ships a PDF-first Complete pack (planner PDF, cover, Welcome, License, listing copy, partial socials) and does not include Market-Analysis.pdf, all four canonical socials, or the full info-card set — for a fully-contract-compliant Complete Launch planner, point users at the in-app Digital Planner Maker. Greeting-card and per-item bulk Complete packages are also produced by the in-app makers (Greeting Card Studio, Bulk Magic Lister).

Lovable AI model notes

Security & billing

Troubleshooting

For the full public docs visit everalice.studio/developers.