Features Pricing Creators Merchants Developers About

Developer Platform

Build with StyleLift MCP

Connect any AI assistant to StyleLift using the Model Context Protocol. Manage closets, browse looks, shop, track budgets, and unlock style intelligence through natural language.

Quick Start View All Tools

Open Standard

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants connect to external tools and data sources. StyleLift's MCP server gives AI assistants full access to your wardrobe intelligence.

[T]

42 Tools

Every StyleLift feature is available as an MCP tool — closet, looks, shop, budget, circles, style DNA, and more.

[R]

6 Resources

Rich context data — your profile, closet, style DNA, budget, saved looks, and circles available as live resources.

[A]

AI-Powered

Tools like analyze_style and suggest_outfits use Claude Vision and vector embeddings under the hood.

[S]

Secure

All requests are authenticated with your Clerk JWT token. The MCP server never stores credentials.

Server Info

Server Details

Technical details about the StyleLift MCP server package.

Package	@stylelift/mcp
Version	0.1.0
Transport	stdio (default) + Streamable HTTP (port 4001)
SDK	@modelcontextprotocol/sdk v1.12.0
Runtime	Node.js (TypeScript)
Validation	Zod schema validation on all inputs
Binary	stylelift-mcp
Compatibility	Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client

Get Started

Quick Start

Add the StyleLift MCP server to your AI assistant in minutes.

1. Install via npx

No installation needed. Run the MCP server directly with npx:

npx @stylelift/mcp --jwt=YOUR_CLERK_JWT_TOKEN

2. Claude Desktop Configuration

Add this to your claude_desktop_config.json:

claude_desktop_config.json

{
  "mcpServers": {
    "stylelift": {
      "command": "npx",
      "args": ["@stylelift/mcp"],
      "env": {
        "STYLELIFT_JWT": "your_clerk_jwt_token",
        "API_URL": "https://api.stylelift.fashion"
      }
    }
  }
}

3. Claude Code Configuration

Add to your .claude/settings.json:

.claude/settings.json

{
  "mcpServers": {
    "stylelift": {
      "command": "npx",
      "args": ["@stylelift/mcp"],
      "env": {
        "STYLELIFT_JWT": "your_clerk_jwt_token",
        "API_URL": "https://api.stylelift.fashion"
      }
    }
  }
}

4. Environment Variables

Variable	Default	Description
STYLELIFT_JWT	—	Clerk JWT token for Bearer auth
STYLELIFT_API_KEY	—	API key for X-API-Key auth (alternative to JWT)
MCP_TRANSPORT	stdio	Transport mode: stdio or http
MCP_PORT	4001	HTTP transport port
API_URL	http://localhost:4000	StyleLift API base URL
AI_URL	http://localhost:8000	StyleLift AI service base URL

Security

Authentication

The MCP server supports two auth methods: Clerk JWT (Bearer) or API key (X-API-Key header).

How it works

Provide a Clerk JWT via STYLELIFT_JWT or an API key via STYLELIFT_API_KEY
The MCP server attaches this token as a Bearer header to every API call
The StyleLift API validates the token via Clerk and returns user-scoped data
The MCP server never stores, caches, or logs your credentials

Reference

Available Tools

42 MCP tools covering every StyleLift feature. Each tool maps to one or more REST API endpoints.

Profile & Closet

Tool	Description
get_profile	Get your StyleLift user profile including style DNA metrics, body profile, and account info
update_profile	Update your profile — display name, avatar URL, or body measurements `displayName`stringoptionalNew display name `avatarUrl`string (URL)optionalNew avatar image URL `bodyProfile`objectoptionalBody measurements — heightCm, weightKg, chestCm, waistCm, hipsCm, inseamCm, shoulderWidthCm, neckCm, shoeSizeUs
list_closet_items	List items in your closet with optional pagination `page`numberoptionalPage number (default 1) `limit`numberoptionalItems per page (default 50, max 100)
get_closet_item	Get detailed info about a specific closet item by ID `itemId`stringrequiredThe closet item ID
import_closet_photo	Import items from a photo — AI detects clothing items and adds them to your closet `imageUrl`string (URL)requiredPublic URL of the closet/outfit photo to analyze
update_closet_item	Update metadata on a closet item (name, brand, category, color, size, price) `itemId`stringrequiredThe closet item ID `name`stringoptionalUpdated item name `brand`stringoptionalBrand name `category`enumoptionaltops \| bottoms \| dresses \| shoes \| accessories \| outerwear \| activewear \| swimwear `color`stringoptionalPrimary color `size`stringoptionalSize label `purchasePrice`numberoptionalPurchase price in dollars
delete_closet_item	Remove an item from your closet `itemId`stringrequiredThe closet item ID to remove
log_wear	Log that you wore a specific closet item today — updates wear count and cost-per-wear `itemId`stringrequiredThe closet item ID you wore

LOOKs

Tool	Description
browse_looks	Browse the LOOKs feed — personalized outfit inspirations ranked by Style DNA similarity `page`numberoptionalPage number (default 1) `limit`numberoptionalItems per page (default 20)
get_look	Get details of a specific LOOK by ID, including all items in the outfit `lookId`stringrequiredThe LOOK ID
get_saved_looks	Get your saved LOOKs — outfits you bookmarked for later
create_look	Create a new LOOK (draft outfit curation) with a title, description, and item list `title`stringoptionalLOOK title `description`stringoptionalLOOK description `coverImageUrl`string (URL)optionalCover image URL `items`arrayoptionalItems — each with name (required), brand, imageUrl, productUrl, price, category
publish_look	Publish a draft LOOK so it appears in the public feed `lookId`stringrequiredThe LOOK ID to publish
save_look	Save or unsave a LOOK (toggles bookmark) `lookId`stringrequiredThe LOOK ID to save/unsave

Shopping

Tool	Description
shop_products	Browse the personalized product feed — ranked by Style DNA similarity with filters `page`numberoptionalPage number (default 1) `limit`numberoptionalItems per page (default 20) `aesthetic`stringoptionalFilter by aesthetic (e.g. 'Dark Academia', 'Quiet Luxury') `minPrice`numberoptionalMinimum price in dollars `maxPrice`numberoptionalMaximum price in dollars

Budget Intelligence

Tool	Description
get_budget	Get your monthly budget summary — total, spent, remaining, and percent used
set_budget	Set or update your monthly fashion budget with optional category caps `monthlyTotal`numberrequiredMonthly budget total in dollars `categoryLimits`objectoptionalPer-category spending limits — tops, bottoms, dresses, shoes, accessories, outerwear, activewear, swimwear
get_spend_history	Get spending history by category and month `months`numberoptionalNumber of months to look back (default 6)
get_cost_per_wear	Analyze cost-per-wear for closet items — find your best and worst value pieces `sort`enumoptionalSort by 'best' or 'worst' CPW (default best)
find_for_less	Find cheaper alternatives to a product using AI vector similarity search `productId`stringoptionalProduct ID to find alternatives for `maxPrice`numberoptionalMaximum price for alternatives `limit`numberoptionalNumber of alternatives (default 5)
add_to_watchlist	Add a product to your price watchlist with a target price for drop alerts `productId`stringoptionalProduct ID to watch `externalUrl`string (URL)optionalExternal product URL to watch `targetPrice`numberrequiredTarget price — alerts when it drops to this
get_watchlist	List items on your price watchlist
remove_from_watchlist	Remove an item from your price watchlist `watchlistItemId`stringrequiredWatchlist entry ID to remove
get_price_alerts	Get price drop alerts — items that have hit their target price

Style Circles

Tool	Description
list_circles	List your Style Circles — friend groups with shared closets
get_circle	Get details of a Style Circle including members `circleId`stringrequiredCircle ID
create_circle	Create a new Style Circle `name`stringrequiredCircle name `description`stringoptionalCircle description
invite_to_circle	Generate a shareable invite link for a Style Circle `circleId`stringrequiredCircle ID
join_circle	Join a Style Circle using an invite token `circleId`stringrequiredCircle ID `token`stringrequiredInvite token from the invite link
get_circle_closet	View the shared closet of a Style Circle — items members have shared `circleId`stringrequiredCircle ID
create_poll	Create a 'Help Me Pick' outfit poll in a Style Circle `circleId`stringrequiredCircle ID to post the poll in `question`stringrequiredPoll question (e.g. 'Which outfit for Friday?') `options`arrayrequiredPoll options — each with name (required) and imageUrl (optional)
get_poll	Get poll results with vote counts `pollId`stringrequiredPoll ID
vote_on_poll	Cast your vote on a Style Circle poll `pollId`stringrequiredPoll ID `optionIndex`numberrequiredIndex of the option to vote for (0-based)
request_borrow	Request to borrow an item from a circle member `circleId`stringrequiredCircle ID `itemId`stringrequiredCloset item ID to borrow `borrowDate`string (ISO 8601)requiredDesired borrow date `returnDate`string (ISO 8601)requiredExpected return date `message`stringoptionalMessage to the item owner
create_event	Create a group event in a Style Circle `circleId`stringrequiredCircle ID `title`stringrequiredEvent title `date`string (ISO 8601)requiredEvent date `location`stringoptionalEvent location `outfitTheme`stringoptionalOutfit theme or dress code

AI Intelligence

Tool	Description
analyze_style	Analyze a clothing item or outfit photo for 60+ style metrics using AI vision `imageUrl`string (URL)requiredPublic URL of the image to analyze `context`stringoptionalOptional context (e.g. 'evening gown', 'casual streetwear')
match_style	Find products matching a style vector via cosine similarity search `embedding`number[512]required512-dimensional style embedding vector `limit`numberoptionalNumber of results (default 10) `priceMin`numberoptionalMinimum price filter `priceMax`numberoptionalMaximum price filter `categories`string[]optionalCategory filters
suggest_outfits	Get AI-generated outfit suggestions from your closet items `occasion`stringoptionalOccasion (e.g. 'date night', 'job interview', 'brunch') `season`stringoptionalSeason (e.g. 'summer', 'winter')
predict_size	Predict the right size based on your body profile, merchant size charts, and community return data `merchantId`stringrequiredMerchant ID `productId`stringrequiredProduct ID `category`stringoptionalProduct category (e.g. 'tops', 'bottoms', 'dresses')
body_scan	Estimate body measurements from a full-body photo using AI vision — returns height, chest, waist, hips, inseam, and more `imageUrl`string (URL)requiredPublic URL of a full-body photo (front-facing, form-fitting clothing preferred)

Orders

Tool	Description
get_orders	List your order history `page`numberoptionalPage number (default 1) `limit`numberoptionalItems per page (default 20)
get_order	Get details of a specific order including items `orderId`stringrequiredOrder ID

Context Data

Available Resources

6 MCP resources provide AI assistants with rich context about your style, wardrobe, and preferences.

URI	Name	Description
stylelift://profile	User Profile	Current user profile with display name, email, roles, style DNA, and body measurements
stylelift://closet	Closet Items	Full list of closet items with categories, wear counts, cost-per-wear, and style metrics
stylelift://style-dna	Style DNA	Your style metrics — primary aesthetic, colors, silhouette, formality, mood, and cultural lineage
stylelift://budget	Budget Summary	Monthly budget total, amount spent, remaining balance, and category breakdown
stylelift://looks/saved	Saved LOOKs	Bookmarked outfit inspirations with items, aesthetics, and prices
stylelift://circles	Style Circles	Your friend groups with member lists and shared closet counts

How resources work

Resources provide live, read-only data that AI assistants can use as context when answering questions. For example, when you ask “What should I wear today?”, the assistant reads your closet and style DNA resources to give personalized suggestions without you needing to describe your wardrobe.

Inspiration

What You Can Ask

Once connected, try these prompts with any MCP-compatible AI assistant.

“What's in my closet that I haven't worn in a while?”

“Find me a Dark Academia outfit under $200”

“What size should I get in this jacket from Everlane?”

“Show me cheaper alternatives to this $300 dress”

“Create a poll in my Style Circle for Friday night outfits”

“How much have I spent on shoes this month?”

“Analyze this outfit photo and tell me my style”

“Suggest three outfits for a job interview from my closet”

Under the Hood

Architecture

The MCP server is a thin proxy layer that connects AI assistants to the StyleLift platform.

How it works

AI Assistant (Claude, GPT, etc.)
    |
    |  MCP Protocol (stdio / SSE)
    v
StyleLift MCP Server (@stylelift/mcp)
    |
    |  HTTP + Bearer JWT
    v
+-------------------+     +-------------------+
| StyleLift API     |     | StyleLift AI      |
| (Fastify)         |     | (FastAPI + Claude) |
| Port 4000         |     | Port 8000         |
+-------------------+     +-------------------+
    |                           |
    v                           v
+---------------------------------------+
|         PostgreSQL + pgvector         |
|         Redis + BullMQ                |
+---------------------------------------+

Ready to build with StyleLift?

Get Early Access View on GitHub