EverAlice AI MCP Server

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

Documentation

Elite feature

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]."

Want the full ZIP? The pack tools deliver a fixed Seller Asset Pack — same files every time, no toggles:

listing.json — structured copy (title, tags, description, bullets, audience, category)
listing.txt — copy-paste-ready listing for Etsy/Shopify
hero.png — primary listing image (for printables, this is the clean artwork itself — same file as printable.png)
printable.png — printables only: the actual sellable artwork, no frame, no wall, edge-to-edge — ready to print or convert into ratio variants
mockups/ — 4 framed lifestyle scenes built from that exact artwork
README.txt — what's inside + cost breakdown

12 credits flat for magic_lister_pack and magic_lister_bundle_pack. magic_lister_bulk_pack runs the same per product, with a configurable mockup count to keep batch costs in check.

Need the full Etsy buyer delivery? Use magic_lister_buyer_bundle (22 credits, Elite-only) — adds multi-ratio buyer JPGs (2:3, 3:4, 4:5, 11:14, ISO A), 13 print-ready PDFs (4×6 → 24×36, A4, A3), and a branded Welcome.pdf with thank-you / printing instructions / license on top of the Seller Asset Pack.

Need a finished book? generate_book_pdf returns a print-ready PDF with an AI cover on page 1, title page, ToC, and a fully written chapter per outline entry. Dynamic cost — about 16 credits for a 10-chapter book. Great for KDP non-fiction, journals, and children's books.

Plan gating: the three *_pack tools, magic_lister_buyer_bundle, and magic_lister_bulk require Elite (admins bypass automatically). Copy-only and single-image tools work on every paid plan. The listing-copy model is instructed not to promise file formats or sizes outside the ZIP — always sanity-check listing.txt before publishing.

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_pack to make a full Etsy Seller Asset Pack for my watercolor moon-phase printable wall art set — return the ZIP link."
"Use EverAlice magic_lister_buyer_bundle to deliver the FULL Etsy buyer bundle (seller assets + multi-ratio JPGs + print-ready PDFs + Welcome.pdf) for my boho moon-phase printable."
"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_pack to bundle these 4 planner products into one Etsy bundle listing with a hero image and 4 mockups, all zipped."
"Use EverAlice magic_lister_bulk_pack to spin up full listing packs (copy + hero + 2 mockups) 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."
"Bundle these 4 planner products into one Etsy bundle listing with value framing (copy only)."
"I have 8 sticker designs — generate Magic Lister listing copy for each (text only)."
"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 / mockup	image_url \| image_base64, product_type? (wall_art	product, default wall_art), scene_count? (1–6, default 4), custom_scenes?[], aspect? (square
magic_lister_pack	12 flat	product_description, platform?, brand_name?, keywords_to_include?, aspect?	FULL pipeline (fixed Seller Asset Pack): listing.json + listing.txt + hero.png + 4 framed lifestyle mockups + (for printables) printable.png clean sellable artwork. 7-day signed ZIP URL. mockup_count is ignored — always delivers 4.
magic_lister_bundle_pack	12 flat	products[] (2-10), platform?, bundle_name?, aspect?	Bundle Seller Asset Pack (fixed): combined bundle copy + bundle hero + 4 mockups + listing.txt (+ printable.png for printable bundles). One 7-day signed ZIP.
magic_lister_bulk_pack	(3 + 1 + 2/mockup) × N	products[] (1-5), platform?, mockup_count? (0-4, default 2), aspect?	BULK Seller Asset Pack: up to 5 products, each gets listing.json + listing.txt + hero.png + mockups (+ printable.png for printables) in its own subfolder. Master ZIP, 7-day signed URL. mockup_count per product (0-4, default 2).
magic_lister_buyer_bundle	22 flat (Elite)	product_description, platform?, brand_name?, keywords_to_include?, aspect? (portrait recommended)	PREMIUM full Etsy delivery bundle for printable wall art. Includes everything in the Seller Asset Pack PLUS multi-ratio buyer JPGs (2:3, 3:4, 4:5, 11:14, ISO A) + 13 print-ready PDFs (4×6 through 24×36, A4, A3) + a branded Welcome.pdf with thank-you, printing instructions and license. One 7-day signed ZIP. Elite plan only.
magic_lister_single	3	product_description, platform?, brand_name?	Listing COPY only (title/tags/description/bullets). Chain with generate_image for mockups.
magic_lister_bundle	3	products[], platform?, bundle_name?	Bundle listing COPY (value framing, what's-included). Text only.
magic_lister_bulk	3 / listing (≤5)	products[] (1-5), platform?	Up to 5 listing COPY sets in one call. Text only.
ai_copywriter	1	brief, format?, tone?	Titles, taglines, captions, subject lines.
generate_image	1	prompt, aspect_ratio?	Text-to-image (Gemini Flash Image).
upscale_image	3	image_url \| image_base64, intent?	Print-ready 4x upscale.
remove_background	1	image_url \| image_base64	Transparent PNG cutout.
generate_greeting_card	5	occasion, tone?, recipient?	Inside/outside copy + 3 design directions.
generate_kdp_cover_copy	5	topic, audience?, genre?	KDP title, subtitle, blurb, BISAC.
generate_planner_outline	5	planner_type, audience?	Planner page list & sections.
generate_printable_idea	3	niche, audience?	Printable concept + variants.
generate_book_outline	5	topic, audience?, length?	Chapter outline + hooks.
generate_book_pdf	~16 (dynamic: 1 cover + 5 outline + 1/chapter)	topic, book_type, chapter_count? (3-30, default 8), audience?, tone?, cover_style?, trim_size? (6x9/5x8/8.5x11/8x10), author_name?	FINISHED, print-ready book PDF: AI cover on page 1 matched to the storyline, title page, table of contents, and a fully written chapter for every outline entry. Returns 7-day signed URLs for the PDF and source outline JSON. Best for KDP non-fiction, guides, workbooks, journals with prompts, and children's books (one spread per chapter).
generate_mockup_concept	1	product_description	3 lifestyle mockup scene briefs.
generate_ad_copy	1	product, channel?, angle?	Pin/ad/social caption variants.

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 or not on Elite plan
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 Studio AICreative Studio

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

[email protected]

EverAlice Studio 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