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 on the Elite plan.
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 complete one-product Etsy ZIP — listing copy, seller hero, 4 framed mockups, and a free marketing/ pack (printables auto-add a Customer Pack: printable.png + 5 ratio JPGs at 300 DPI + Brand-Kit Welcome.pdf + License + Info-Cards under
customer/) — withmagic_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 the full Standard Pack pipeline 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 | ~14 (printables ~20) | FULL Standard Pack for ONE product, returned as a 7-day signed ZIP. Always: listing.json + listing.txt + seller/hero.png + 4 framed mockups + a free marketing/ pack (Pinterest / Instagram / TikTok / ad / launch-email copy). Printables auto-upgrade to a Customer Pack under customer/: printable.png (clean ~3000 px master, upscaled if needed) + 5 ratio JPGs tagged 300 DPI (2:3, 3:4, 4:5, 11:14, ISO A) + Brand-Kit-branded Welcome.pdf + License.txt + Info-Cards.txt. JPG-only — no extra buyer PDFs. Pass product_type ("printable" / "physical") to force the lane. Failed mockups auto-refund. |
magic_lister_bundle | ~14 (printables ~20) | FULL bundle pack — 2–10 products combined into ONE listing as a 7-day signed ZIP: bundle copy + bundle hero + 4 framed mockups + free marketing pack. Printable bundles also include the Customer Pack (printable.png + 5 ratio JPGs @ 300 DPI + Welcome.pdf + License + Info-Cards under customer/). |
magic_lister_bulk | ~14 / product (max 5) | FULL Standard Pack × up to 5 products in one master 7-day signed ZIP. Each product gets its own subfolder (listing copy + seller hero + 4 mockups + marketing pack, plus customer/ Customer Pack for printables). Failed products refund individually. |
ai_copywriter | 1 | Titles, taglines, captions, email subject lines. |
generate_image | 1 | Create image from text prompt (Gemini Flash Image). |
upscale_image | 3 | Sharper, print-ready version of an existing image. |
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. |
What's in every Magic Lister ZIP: listing.json + listing.txt + seller/hero.png + 4 framed lifestyle mockups + a free marketing/ pack. Printables auto-add a customer/ Customer Pack — printable.png + 5 ratio JPGs at 300 DPI + branded Welcome.pdf + License.txt + Info-Cards.txt. JPG-only, no buyer PDFs. Fixed contract — no toggles, no surprises.
magic_lister_single, magic_lister_bundle, magic_lister_bulk and generate_book_pdf require the Elite plan (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 paid plan that has credits.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.