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
- ★ Photo → Mockups in seconds. "Here's my watercolor moon-phase artwork — give me 4 framed lifestyle mockups." Drop the image into Claude/Cursor/ChatGPT and EverAlice's
generate_mockupstool returns 4 polished, framed-on-wall scenes built from that exact image (no redrawing, no recoloring). 2 credits each, available on every paid plan. - Same tool, physical products:
product_type: "product"places your product photo into styled lifestyle scenes (no Elite gate, no upload to a separate site). - Ask Claude/Cursor: "Use EverAlice to generate an Etsy listing for my watercolor moon-phase printable set."
- Deliver a Basic one-product Etsy ZIP — platform listing copy, hero, small mockup set, Welcome.pdf, License.txt, Info Cards, and 2 social overlays (printables also get a verified 300 PPI print-ready JPG + PDF at the largest size the real pixels support) — with
magic_lister_single. Force the lane withproduct_type: "printable"or"physical"if auto-detect guesses wrong. - Combine 2–10 products into one bundle listing with hero + mockups + ZIP via
magic_lister_bundle. - Run bulk listings for up to 5 products in one master ZIP with
magic_lister_bulk. - Have an n8n workflow auto-create listings whenever you drop a new product photo into Drive.
- Generate, upscale, and background-remove images inline in an AI chat.
- Draft KDP cover copy, planner outlines, book outlines, greeting card copy, ad copy — all from any MCP-aware assistant.
Step 1 — Generate your API key
- Open Settings and scroll to MCP / API Access.
- Click Generate key, give it a label (e.g. "Claude Desktop"), copy the key immediately.
- The key is shown once. If you lose it, revoke and create a new one.
Step 2 — Add EverAlice to your AI client
Claude Desktop
Edit your Claude config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"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:
- "Here's my artwork — make me 4 framed wall-art mockups." (Attach the image, EverAlice's
generate_mockupsreturns 4 signed-URL PNGs.) - "Give me 6 lifestyle mockups of this t-shirt design — product_type product, square."
- "Generate 3 mockups of this poster using my own scenes: cozy reading nook, sunlit kitchen, modern entryway."
- "Use EverAlice to generate a Shopify listing for my vintage botanical printable bundle."
- "Bundle these 4 planner products into one Etsy bundle listing."
- "I have 8 sticker designs — generate KDP listings for each."
- "Upscale this image for a 16x20 poster, then remove the background."
Tools & credit costs
| Tool | Credits | What it does |
|---|---|---|
generate_mockups ★ | 2 / mockup | Photo → 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_single | In-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_bundle | 20 | Complete 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_pack | Dynamic, capped at 22 | Finished digital planner ZIP. AI cover, print-ready planner PDF, optional hyperlinked navigation, listing/marketing assets, Welcome.pdf, License.txt, and outline JSON. |
ai_copywriter | 1 | Titles, taglines, captions, email subject lines. |
generate_image | 1 | Create 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_image | 3 | Sharper, print-ready version of an existing image through the Lovable AI Gateway image-edit path. |
remove_background | 1 | Transparent PNG cutout. |
generate_greeting_card | 5 | Greeting card copy + 3 design directions. |
generate_kdp_cover_copy | 5 | KDP title, subtitle, blurb, BISAC categories. |
generate_planner_outline | 5 | Digital planner page list + sections. |
generate_printable_idea | 3 | Printable concept + variants. |
generate_book_outline | 5 | Low-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_concept | 1 | Mockup scene brief for product photos. |
generate_ad_copy | 1 | Ad / 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.
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
- Lovable docs checked 2026-07-05: Gemini 3 Flash Preview is the default chat/assistant model for AI features, and GPT Image 2 is the default image model.
- EverAlice runtime uses
google/gemini-3-flash-previewfor chat/agent text calls, plusgoogle/gemini-3.1-flash-image-previeworgoogle/gemini-3-pro-image-previewfor image generation.
Security & billing
- Keys are hashed at rest — we cannot read them after creation.
- Revoke any time from Settings; active AI clients lose access immediately.
- Every call deducts EverAlice credits exactly like using the tool in the app.
- Banned or suspended accounts are blocked at the server level.
- Never paste your API key into shared chats or screenshots.
Troubleshooting
- 401 Unauthorized: the key is invalid or revoked. Generate a fresh one in Settings.
- 403 Account suspended: contact support.
- Tool returns "insufficient credits": top up at Pricing.
- Client doesn't see EverAlice tools: fully quit and reopen the client after editing the config file.
- Need to confirm the server is up: GET the endpoint in a browser — it returns the server info and tool list.
For the full public docs visit everalice.studio/developers.