EverAlice AI MCP

Remote MCP server for Etsy listing copy, mockups, delivery packs, social campaigns, and brand kits from EverAlice AI.

Documentation

MCP / API access

EverAlice MCP

The go-to mockup engine for AI assistants. Send any product photo or wall-art artwork from Claude Desktop, Cursor, ChatGPT, n8n or any MCP client — EverAlice returns framed lifestyle mockups composited from that exact image (no redrawing), plus full Etsy / Shopify / Gumroad / KDP / Creative Market / Payhip listings, books, and print-ready ZIPs. All billed to your EverAlice credits.

</.well-known/mcp.json>Setup playbookMCP 2025-06-18 · JSON-RPC 2.0

Quick start (60 seconds)

Generate an API key in Settings → MCP / API Access.
Paste the snippet for your client (Claude / Cursor / Codex / ChatGPT / n8n) below.
Restart the client. Ask: "Use EverAlice to write an Etsy listing for [your product]."

Which ZIP tool do I use? Three flat-priced tiers for a single product, plus bundle/bulk/planner variants:

magic_lister_single — Direct MCP: flat 3 credits (mcp_light). In-app via Alice or Magic Lister: 10-credit sticker (in_app_full), normally 9 credits with hero reuse and 7 / 5 credits when 1 or 2 supplied mockups are actually fetched AND byte-distinct (identical URLs or byte-identical duplicates count once). The mcp_light variant is a lightweight byte-copy ZIP with platform listing copy, per-platform source-image copies, Customer Files (Welcome.txt, License.txt, source artwork), and marketing captions, plus truthful delivered / omitted arrays. Because it omits Welcome.pdf, image info cards, branded/resized social overlay images, the starter 8×10 300 DPI JPG + PDF, and the canonical 01 - Listing Files / 02 - Customer Files / 03 - Marketing Files folder tree, no mockup-refund math applies — supplied mockups are still fetched and included when reachable, but broken or duplicate assets are skipped and never change the price.
magic_lister_buyer_bundle — Complete Launch · 20 credits. 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_bundle — 2–10 products in ONE listing.
magic_lister_bulk — Basic Listing pipeline for many products at 10 credits each.
magic_lister_planner_pack — finished digital planner ZIP with AI cover, print-ready PDF, optional hyperlinked navigation, listing/marketing assets. Dynamic cost capped at 22.
generate_book_pdf — print-ready book PDF with an AI cover, title page, ToC, and a fully written chapter per outline entry. Dynamic cost ~16 for a 10-chapter book.

Reuse existing art: pass the signed source_image_url (or source_image_base64) from the prior generate_image / generate_mockups / magic_lister_single result so the deliverables frame the SAME image the user just saw — never re-roll.

Plan gating: magic_lister_buyer_bundle requires any active paid plan. magic_lister_bulk requires Elite (admins bypass automatically). Copy and single-image tools (generate_mockups, generate_image, upscale_image, remove_background, ai_copywriter, outlines, ad copy) work on every paid plan with credits.

Migration: the legacy Seller Pack tools (magic_lister_pack, magic_lister_bundle_pack, magic_lister_bulk_pack) are retired. Direct calls fail with error: "deprecated_tool" and charged: 0. Truthful replacements: for a Basic Listing use magic_lister_single (or magic_lister_bulk for many products) — these are Basic-only routes and do NOT accept pack_level="complete_launch". For the full shared-contract Complete Launch ZIP over MCP, use magic_lister_buyer_bundle. Only magic_lister_planner_pack accepts pack_level (basic | complete_launch), and its complete_launch is a PDF-first pack that is not full shared-contract parity. Full-contract Bulk, Greeting Card, and Planner/Printable Complete packages are produced by the in-app makers.

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, four canonical socials with captions, four info cards, per-marketplace platform-ready listing files, 00-CONTENTS.txt, no .md files). magic_lister_planner_pack with pack_level="complete_launch" ships a PDF-first Complete pack 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, use the in-app Digital Planner Maker. Greeting-card and per-item bulk Complete packages are produced by the in-app Greeting Card Studio and Bulk Magic Lister makers.

Lovable AI model notes

Lovable docs checked 2026-07-05: Gemini 3 Flash Preview is the default chat/assistant model for AI features, with GPT Image 2 as the default image model.
EverAlice runtime: chat/agent text calls use google/gemini-3-flash-preview; image generation routes standard to google/gemini-3.1-flash-image-preview and Pro to google/gemini-3-pro-image-preview.

Step 1 — Generate your API key

In Settings → MCP / API Access, click Generate key. Copy the key immediately (it's shown only once).

Open Settings

Step 2 — Add EverAlice to your AI client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor

Settings → MCP → Add new MCP server, or edit ~/.cursor/mcp.json:

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

Windsurf

Cascade → MCP Servers → Add new, or edit ~/.codeium/windsurf/mcp_config.json:

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

Codex CLI (OpenAI)

Edit ~/.codex/config.toml:

[mcp_servers.everalice]
url = "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server"
headers = { Authorization = "Bearer ea_live_YOUR_KEY_HERE" }

ChatGPT (Developer Mode connectors)

Settings → Connectors → Add → MCP server. Paste the endpoint and the Authorization: Bearer … header.

URL:    https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server
Header: Authorization: Bearer ea_live_YOUR_KEY_HERE

n8n

Use the MCP Client node (Streamable HTTP). After connecting, also flip the workflow's Available in MCP toggle to expose it back to other agents.

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

Any other client

EverAlice speaks standard MCP Streamable HTTP. Point your client at this endpoint with the API key as a Bearer token:

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 — Try these prompts

Once connected, just ask your assistant naturally:

"Here's my watercolor moon-phase artwork — use EverAlice generate_mockups to make me 4 framed lifestyle wall-art mockups and return the signed URLs."
"Use EverAlice generate_mockups on this t-shirt design — product_type product, scene_count 6, square — give me the signed URLs."
"Use EverAlice generate_mockups on this poster with my own scenes: 'cozy reading nook with linen sofa', 'sunlit modern kitchen', 'neutral entryway bench'."
"Use EverAlice magic_lister_single to deliver the full Etsy ZIP for my watercolor moon-phase printable wall art set — return the signed URL."
"Use EverAlice generate_book_pdf to write a finished 10-chapter children's book about a tiny astronaut named Nova — illustrated watercolor cover, 8.5x11, warm storybook tone. Return the PDF link."
"Use EverAlice magic_lister_bundle to bundle these 4 planner products into one Etsy listing with a hero image and 4 mockups, all zipped."
"Use EverAlice magic_lister_bulk to spin up full listing packs for these 5 sticker designs and deliver one master ZIP."
"Use EverAlice to generate an Etsy listing for my watercolor moon-phase printable wall art set."
"I have 5 sticker designs — run EverAlice magic_lister_bulk and return the master ZIP."
"Generate an image of a celestial tarot card back in midnight blue and gold, then upscale it for print."
"Remove the background from this product photo and return a transparent PNG."
"Draft a KDP cover copy + 6-chapter book outline for a beginner watercolor journal."
"Write 3 Pinterest pin titles + descriptions for my new boho nursery printable set."

Tool catalog & credit costs

The live, machine-readable list is at GET https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server or via JSON-RPC tools/list. Costs match in-app pricing; failed calls are auto-refunded.

Tool	Credits	Arguments	What it does
generate_mockups ★	2 × scene_count	image_url \| image_base64, product_type? (wall_art	product), scene_count? (1–6, default 4), custom_scenes?[], aspect? (square
magic_lister_single	10 (–1 with source art, –2 per supplied mockup, up to 2)	product_description, platform?, platform_files?[] (≤2), brand_name?, keywords_to_include?[], aspect?, product_type? (auto\|printable	physical), source_image_url?, source_image_base64?, source_mockup_urls?[]
magic_lister_buyer_bundle	20 (less when source art is supplied)	product_description, platform?, brand_name?, keywords_to_include?[], aspect?, source_image_url? \| source_image_base64?	COMPLETE LAUNCH — full buyer files ZIP: 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. Pass source_image_url or source_image_base64 when prior artwork exists; otherwise the tool generates fresh poster art from the product description.
magic_lister_bundle	~14 (printables +1)	products[] (2-10), platform?, bundle_name?, target_audience?, brand_name?, aspect?	COMPLETE bundle pack — 2–10 products combined into ONE listing. ZIP with combined bundle copy, hero, 4 framed lifestyle mockups, printable.png + one print-ready JPG/PDF for printable bundles, marketing pack, branded Welcome.pdf, License.txt, and Info Card JPGs. Failed mockups auto-refund.
magic_lister_bulk	10 × N (max 25 per batch, 3 per invocation — re-call with { products: remaining } until empty)	products[] (1-25, each with product_description + optional client_ref + optional source_image_url\|source_image_base64 + optional source_mockup_urls[]), platform?, aspect?	Basic Listing pipeline per product (same deliverable as magic_lister_single). Continuation pattern: each call processes at most 3 products and returns { completed, remaining, batch_summary }; re-invoke with { products: remaining } until empty. Per-product supplied-component deductions apply (–1 hero, –2 each mockup, up to 2). Idempotent: each product may carry a client_ref (or the server derives a stable hash); already-delivered products return cached with charged: 0. Elite plan.
magic_lister_planner_pack	planner pages (max 22)	theme, page_count? (12-140), pack_level? (basic\|complete_launch), audience?, dated?, year?, hyperlinked_navigation?, include_listing_assets?, platform?, brand_name?, cover_style?, trim_size? (8.5x11/8x10/5.5x8.5/A4), planner_name?	★ FLAGSHIP PLANNER TOOL. Finished, buyer-ready DIGITAL PLANNER ZIP: AI cover, print-ready planner PDF, optional hyperlinked navigation, listing files, cover/marketing assets, Welcome.pdf, License.txt, outline JSON. Dynamic cost = 2 (cover) + 5 (outline) + ceil(page_count/10) + optional assets, capped at 22.
generate_book_pdf	1 + 5 + N (per chapter)	topic, book_type (workbook\|journal	non_fiction
ai_copywriter	1	brief, format (title\|tagline	social_caption
generate_image	1	prompt, aspect? (square\|portrait	landscape)
upscale_image	3	image_url \| image_base64, intent? (print	listing
remove_background	1	image_url \| image_base64	Remove the background from an image, returning a clean transparent PNG.
generate_greeting_card	5	occasion, tone?, recipient?	Inside/outside greeting-card copy + 3 design directions.
generate_kdp_cover_copy	5	topic, book_type (journal\|workbook	planner
generate_planner_outline	5	theme, page_count_target? (12-200, default 60), audience?	Structured digital-planner outline: page list, sections, daily/weekly/monthly spreads, intro pages. For a finished planner FILE, use magic_lister_planner_pack.
generate_printable_idea	3	niche, season_or_holiday?	Printable product concept: what it is, who it's for, design direction, file formats, listing angle.
generate_book_outline	5	topic, book_type (workbook\|journal	non_fiction
generate_mockup_concept	1	product_description, target_buyer?	3 lifestyle mockup scene briefs (props/lighting/angle/mood). For rendered mockups from an actual image, use generate_mockups.
generate_ad_copy	1	product_description, channel? (pinterest\|facebook	instagram

Raw API (JSON-RPC 2.0)

Anything an MCP client can do, you can do with curl. The transport is MCP Streamable HTTP — POST JSON-RPC requests with the Accept header below or the server will return 406.

List tools

curl -X POST "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server" \
  -H "Authorization: Bearer ea_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

curl -X POST "https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server" \
  -H "Authorization: Bearer ea_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0","id":2,"method":"tools/call",
    "params":{
      "name":"magic_lister_single",
      "arguments":{
        "product_description":"Watercolor moon-phase printable wall art set, 5 prints, boho nursery",
        "platform":"etsy",
        "brand_name":"EverAlice"
      }
    }
  }'

Supported JSON-RPC methods

initialize          → handshake + server capabilities
tools/list          → full tool catalog with JSON Schemas
tools/call          → execute a tool (params: { name, arguments })
ping                → liveness check

Error codes

401  Invalid / revoked API key
402  Insufficient EverAlice credits (auto-refund on tool failure)
403  Account suspended, missing paid-plan access, or missing Elite access for bulk tools
406  Missing  Accept: application/json, text/event-stream
429  Rate limited — retry with backoff
-32601  Unknown tool / method

Discovery & deeper docs

Discovery manifest: </.well-known/mcp.json>
Full setup playbook (printable): </resources/mcp-server-playbook.html>
Live tool catalog: GET https://kfdadgtwmcmgehstagbe.supabase.co/functions/v1/mcp-server
Launch announcement: Blog →

Security & billing

Keys are hashed at rest — we can't see them after creation.
Revoke a key any time from Settings. Active AI clients will lose access immediately.
Every call deducts EverAlice credits from your account, exactly like using Magic Lister inside the app.
Treat your API key like a password. Don't paste it into shared chats.

EverAlice AICreative Studio

The AI-powered SaaS platform and creative automation software for Etsy sellers — turn one upload into a complete, SEO-ready product bundle.

hello@everalice.studio

EverAlice AI is an independent software company and is not affiliated with any jewelry, fashion, or retail brand of a similar name.

Tools

Resources

Company

Legal