EverAlice AI MCP

Server MCP jarak jauh untuk salinan daftar Etsy, mockup, paket pengiriman, kampanye media sosial, dan perlengkapan merek dari EverAlice AI.

Lihat di everalice.studio

Dokumentasi

EverAlice AI

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 — In-app via Alice or Magic Lister: 10-credit Basic Listing ( in_app_full). Verified reuse savings are reported only after delivery. Direct MCP uses the separate lightweight mcp_light contract.
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\|portrait\|landscape)	★ FLAGSHIP MOCKUP TOOL. Send a product photo OR wall-art artwork and get back N framed lifestyle mockups composited from THAT exact image — pixel-faithful, no redrawing. product_type 'wall_art' (framed-on-wall) or 'product' (lifestyle scene). Optional custom_scenes[] override the default themes. 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	10	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?[]	BASIC Listing ZIP for ONE product at the canonical 10-credit price: platform-specific listing copy, hero image, small mockup set, Welcome.pdf, License.txt, Info Cards, and 2 social overlay images. When prior artwork exists, pass source_image_url / source_image_base64 (and prior mockup URLs as source_mockup_urls) so the ZIP uses the SAME image. Verified reuse savings are reported only after delivery.
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	products[] (each with product_description + optional client_ref + optional source_image_url\|source_image_base64 + optional source_mockup_urls[]), platform?, aspect?	Basic Listing pipeline for many products at 10 credits per listing. Continue with the returned remaining products until empty. Verified reuse savings appear only after delivery. Idempotent client_ref replays 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\|guide\|childrens\|poetry), 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 to the PDF and source outline JSON. Best for KDP non-fiction, guides, workbooks, journals, and children's books.
ai_copywriter	1	brief, format (title\|tagline\|social_caption\|email_subject\|short_description\|bullet_points), tone?, variants? (1-8)	Marketing copy: product titles, taglines, social captions, email subject lines, short product descriptions, or bullet points.
generate_image	1	prompt, aspect? (square\|portrait\|landscape)	Text-to-image through Lovable AI Gateway. Standard uses google/gemini-3.1-flash-image-preview; Pro uses google/gemini-3-pro-image-preview. Returns base64 PNG inline.
upscale_image	3	image_url \| image_base64, intent? (print\|listing\|social)	Upscale an existing image to a sharper, print-ready version through the Lovable AI Gateway image-edit path. Accepts URL or base64 data URI.
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\|notebook\|low_content\|non_fiction\|fiction\|childrens), audience?	Amazon KDP book cover copy: title, subtitle, back-cover blurb, comparable titles, BISAC category suggestions.
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\|guide\|childrens), chapter_count? (3-30, default 10)	Chapter-by-chapter outline plus a short hook for each chapter. For a finished KDP-ready PDF, use generate_book_pdf.
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\|google_ads), variants? (1-6)	Pinterest pin titles + descriptions, Facebook/Instagram ad variants, or Google Ads copy.

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 EverAlice AI home

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

Instagram X (Twitter) Pinterest LinkedIn YouTube Facebook

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