EverAlice AI MCP Server

EverAlice AI

Sign InStart Free

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)

1. Generate an API key in Settings → MCP / API Access.
2. Paste the snippet for your client (Claude / Cursor / Codex / ChatGPT / n8n) below.
3. 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 + listing.txt — structured + copy-paste-ready listing copy
• seller/hero.png + seller/mockups/ — primary hero + 4 framed lifestyle scenes built from your exact artwork
• marketing/ — free marketing pack (Pinterest titles + pin descriptions, Instagram captions, TikTok hooks, ad copy, launch email) — no extra credits
• printable.png — printables only: clean full-bleed master, upscaled to ~3000 px on the long edge so standard frame sizes print sharply
• customer/ — printables only: the entire Customer Pack in one folder — 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. Zip the folder, deliver it as-is.
• README.txt — what's inside + cost breakdown

~14 credits for physical/POD products. Printables auto-upgrade to the Customer Pack (~20 credits) — adds printable.png, 5 ratio JPGs at 300 DPI, and a Brand-Kit Welcome.pdf. JPGs only — no more buyer PDFs (Etsy buyers print the JPG that matches their frame; print shops read the embedded 300-DPI tag). magic_lister_bulk runs the same per product (up to 5) into one master ZIP. Pass product_type: "printable" or "physical" to force the lane when the description is short or ambiguous.

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: magic_lister_single / _bundle / _bulk and generate_book_pdf require Elite (admins 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. 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_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 / 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_single	~14 (printables ~20)	product_description, platform?, brand_name?, keywords_to_include?, aspect?, product_type? (auto|printable	physical)
magic_lister_bundle	~14 (printables ~20)	products[] (2-10), platform?, bundle_name?, brand_name?, aspect?, product_type? (auto|printable	physical)
magic_lister_bulk	~14 / product (≤5)	products[] (1-5), platform?, aspect?, product_type? (auto|printable	physical)
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 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]

© 2026 EverAlice AI — AI SaaS platform & automation software for digital product sellers. All rights reserved.

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

Tools

• Magic Lister
• Book Builder
• AI Copywriter
• Image Generator
• Mockup Studio

Resources

• Blog
• See a Live Sample (No Signup)
• Compare
• Affiliate Program
• Become an Affiliate
• Etsy Listing Generator
• Etsy SEO Tool
• Developers / MCP API

Company

• About
• Press
• Contact Support
• Email Us
• Email Preferences
• Install as App

Legal

• Terms of Service
• Privacy Policy
• Billing & Refunds