io.github.ThomasFindlay/beautyspark-mcp

up checked 2026-11-11T00:37:42.212Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

BeautySpark

Publisher-provided description

BeautySpark MCP server for ChatGPT, Claude and other MCP clients

Summary by lookupd

Searches BeautySpark makeup guides and color-season palettes, manages saved looks and virtual try-ons, and reads the user's skin-tone…

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http beautyspark https://mcp.beautyspark.me/mcp

Codex, remote (streamable-http)

codex mcp add beautyspark --url https://mcp.beautyspark.me/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "beautyspark": {
      "url": "https://mcp.beautyspark.me/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (22 tools)

Publisher-provided text

• search_guides Search BeautySpark's makeup and colour-season guides for sections that answer a question, e.g. eyeliner for hooded eyes or how to find your undertone. Returns u
• get_guide Read one section of a BeautySpark guide in full, by an id from search_guides. Also lists the ids and headings of the other sections of the same article. Cite th
• search For research modes (deep research, company knowledge). In chat, use search_guides instead. Searches all public BeautySpark content: guide sections (id "<locale>
• fetch For research modes (deep research, company knowledge). In chat, use get_guide instead. Returns the full text of one item from search: a guide section ("<locale>
• get_color_season BeautySpark's palette for one of the 12 color seasons: best, neutral and avoid colors with hex codes, plus the eye makeup and lips & cheeks advice from the seas
• get_product_picks BeautySpark's top product pick per category (blush, highlighter, eyeliner, lipstick, lip gloss, bronzer, eyeshadow palette) for a color season, each with the re
• check_product_for_season Looks a product (and optional shade) up in BeautySpark's season picks. Returns the seasons it is recommended for, or match: null when BeautySpark has not review
• find_article_looks Find makeup looks shown in BeautySpark articles, filtered by color season, article type and words. With a season, looks made for that season come first; general
• get_article_look Get the steps and shades of one makeup look from a BeautySpark article. The id is a look id returned by find_article_looks ("/images/blog/<article-slug>/<look-n
• search_my_looks Search the user's saved looks in BeautySpark My Looks by words, tag, category, favourite or person. Returns look ids for get_my_look.
• get_my_look Get one saved look in full: steps, products and shades, tags, categories, notes, photos and a link to open it in BeautySpark.
• save_my_look Save a new look to the user's BeautySpark My Looks. Photos can't be added from chat: if the user attached or mentions a photo, tell them before saving that only
• update_my_look Change a saved look. Only the fields you send change; list fields (steps, products, tags, categories, occasions) replace the stored list whole. Look photos are
• delete_my_look Delete a saved look from the user's BeautySpark My Looks. The look is removed.
• save_generation_to_my_looks Save a finished BeautySpark generation (a jobId from list_my_generations) as a look in My Looks. Saving the same generation again returns the look already saved
• get_my_profile The user's BeautySpark analysis: color season, undertone, eye shape, face shape and app language. Fields are null until the selfie analysis has been run in the
• list_my_palettes The palettes the user scanned in BeautySpark, with shade names and hex colors. Use them to advise with products the user owns; pass a paletteId as a product's u
• list_my_generations The user's finished BeautySpark look generations, newest first: title, date, thumbnail and whether it is already in My Looks. Pass a jobId to save_generation_to
• try_look_from_photo Prepare a try-on: BeautySpark recreates a makeup look on the user's selfie. Give one reference: articleLookId (from find_article_looks) or savedLookId (from sea
• confirm_look_generation Start the try-on prepared by try_look_from_photo. This spends the BeautySpark credits it quoted. The try-on widget calls it when the user presses Confirm. If no
• get_look_status Check a try-on started by confirm_look_generation. Waits up to waitSeconds (at most 25) for it to finish before answering. When completed, the result includes t
• create_upload_url Used by the try-on widget to upload a photo the user picked. Returns an upload URL valid for 15 minutes.

Details

• Version: 1.0.0
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 396 ms
• First indexed: 2026-11-05T21:17:12.828Z
• Last seen in registry: 2026-11-05T21:17:12.828Z
• Repository: https://github.com/ThomasFindlay/beautyspark

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.ThomasFindlay/beautyspark-mcp.svg)](https://lookupd.com/servers/io.github.ThomasFindlay/beautyspark-mcp)

• 62141 servers
• Last crawl: 2026-11-11T18:17:25.333Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp