Shop Your Color Season MCP

This MCP server allows AI assistants to retrieve clothing and makeup recommendations tailored to a user's specific seasonal color analysis. It enables agents to search for garments in the user's color season, access filters, find cheaper look-alikes, and view second-hand options for Pro users, while strictly operating in a read-only mode without purchasing capabilities.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Shop Your Color Season

MCP endpoint (Streamable HTTP)

https://shopyourcolorseason.com/mcp

Vendor documentation

What you can do with it

Find clothes in your color season
Search with every filter on the site
Find cheaper look-alikes
View second-hand items in your season

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: com.shopyourcolorseason/mcp@1.0.0 Project website

Protocol and capabilities

Server: shopyourcolorseason 1.0.0
MCP protocol: 2025-06-18
Tools: 4 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": false
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Find clothes that suit a person's colour season. Ask for their season first, or use list_color_seasons.

Tools

4 advertised

list_color_seasons — List the colour seasons

Advertised by the server during the last successful anonymous check.

Advertised read-only

List the 4 main seasons and 12 sub-seasons of seasonal colour analysis, with a link to each season's page and to a free test for finding your own season. Use when someone doesn't know their season or asks what the seasons are.

list_color_seasons input schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_color_seasons annotations

{
  "title": "List the colour seasons",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

browse_season — Browse clothes for a main season

Advertised by the server during the last successful anonymous check.

Advertised read-only

A first look at in-stock clothes for one of the 4 main colour seasons (spring, summer, autumn, winter), with links to the shop. For a sub-season such as Soft Autumn, filters or search, use search_clothes.

browse_season input schema

{
  "type": "object",
  "required": [
    "season"
  ],
  "properties": {
    "season": {
      "enum": [
        "spring",
        "summer",
        "autumn",
        "winter"
      ],
      "type": "string"
    },
    "country": {
      "type": "string",
      "default": "se",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter shopping country, e.g. se, no, gb, us."
    }
  },
  "additionalProperties": false
}

browse_season annotations

{
  "title": "Browse clothes for a main season",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

search_clothes — Search clothes in my colours

Advertised by the server during the last successful anonymous check.

Advertised read-only

Search in-stock clothes, shoes, accessories and makeup for one of the 12 colour seasons with every filter the website has: category, colour, shop, brand, size, material, occasion, style, price and sale. Use for 'what should I wear', 'my colours', or any specific shopping request.

search_clothes input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Free-text search, e.g. 'linen blazer'."
    },
    "shops": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Shops to include (a person's own shops), e.g. arket, boozt, nakd."
    },
    "brands": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Brands, e.g. filippa-k."
    },
    "colors": {
      "type": "array",
      "items": {
        "enum": [
          "beige",
          "black",
          "blue",
          "brown",
          "gray",
          "green",
          "orange",
          "pink",
          "purple",
          "red",
          "white",
          "yellow",
          "silver",
          "bronze",
          "gold"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Colour families, e.g. beige, green."
    },
    "season": {
      "enum": [
        "bright-spring",
        "true-spring",
        "light-spring",
        "light-summer",
        "true-summer",
        "soft-summer",
        "soft-autumn",
        "true-autumn",
        "dark-autumn",
        "dark-winter",
        "true-winter",
        "bright-winter"
      ],
      "type": "string",
      "description": "One of the 12 colour seasons. Required unless signed in with a saved season."
    },
    "country": {
      "type": "string",
      "default": "se",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter shopping country, e.g. se, no, gb, us."
    },
    "on_sale": {
      "type": "boolean",
      "description": "Only items on sale."
    },
    "bra_sizes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Bra sizes, e.g. 75B."
    },
    "materials": {
      "type": "array",
      "items": {
        "enum": [
          "cotton",
          "linen",
          "hemp",
          "ramie",
          "wool",
          "cashmere",
          "alpaca",
          "mohair",
          "angora",
          "camel-hair",
          "silk",
          "down",
          "leather",
          "suede",
          "viscose",
          "lyocell",
          "modal",
          "cupro",
          "acetate",
          "bamboo",
          "polyester",
          "polyamide",
          "acrylic",
          "elastane",
          "polyurethane",
          "polypropylene"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Fabrics, e.g. wool, linen, silk."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest price in the country's currency."
    },
    "min_price": {
      "type": "number",
      "minimum": 0,
      "description": "Lowest price in the country's currency."
    },
    "occasions": {
      "type": "array",
      "items": {
        "enum": [
          "everyday",
          "work",
          "going-out",
          "party",
          "formal",
          "active",
          "lounge",
          "vacation"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "What it is for, e.g. work, party, vacation."
    },
    "aesthetics": {
      "type": "array",
      "items": {
        "enum": [
          "minimalist",
          "classic",
          "bohemian",
          "romantic",
          "streetwear",
          "sporty",
          "edgy",
          "preppy",
          "glamorous",
          "workwear"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Style, e.g. minimalist, romantic."
    },
    "body_types": {
      "type": "array",
      "items": {
        "enum": [
          "hourglass",
          "pear",
          "apple",
          "rectangle",
          "inverted-triangle"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Body shapes the piece flatters."
    },
    "categories": {
      "type": "array",
      "items": {
        "enum": [
          "tops",
          "t_shirts",
          "shirts_and_blouses",
          "sweaters_and_cardigans",
          "sweatshirts_and_hoodies",
          "knitwear",
          "trousers",
          "skirts",
          "shorts",
          "dresses",
          "jumpsuits",
          "blazers",
          "jackets",
          "outerwear",
          "activewear",
          "swimwear",
          "underwear",
          "shoes",
          "bags",
          "jewelry",
          "accessories",
          "scarves",
          "hats_and_caps",
          "belts",
          "sunglasses",
          "lipstick",
          "eyeshadow",
          "mascara",
          "eyeliner",
          "blush",
          "nail_polish"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Kinds of item, e.g. dresses, knitwear."
    },
    "shoe_sizes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Shoe sizes, e.g. 38."
    },
    "formalities": {
      "type": "array",
      "items": {
        "enum": [
          "lounge",
          "casual",
          "semi-formal",
          "formal"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "How dressy, e.g. casual, formal."
    },
    "waist_sizes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Waist sizes, e.g. 28."
    },
    "letter_sizes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Clothing sizes, e.g. S, M."
    },
    "inseam_lengths": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Inseam lengths, e.g. 32."
    }
  },
  "additionalProperties": false
}

search_clothes annotations

{
  "title": "Search clothes in my colours",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

second_hand_in_my_season — Second-hand in my season

Advertised by the server during the last successful anonymous check.

Advertised read-only

Search second-hand listings in a colour season, with the same filters as search_clothes.

second_hand_in_my_season input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "description": "Free-text search, e.g. 'linen blazer'."
    },
    "shops": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Shops to include (a person's own shops), e.g. arket, boozt, nakd."
    },
    "brands": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Brands, e.g. filippa-k."
    },
    "colors": {
      "type": "array",
      "items": {
        "enum": [
          "beige",
          "black",
          "blue",
          "brown",
          "gray",
          "green",
          "orange",
          "pink",
          "purple",
          "red",
          "white",
          "yellow",
          "silver",
          "bronze",
          "gold"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Colour families, e.g. beige, green."
    },
    "season": {
      "enum": [
        "bright-spring",
        "true-spring",
        "light-spring",
        "light-summer",
        "true-summer",
        "soft-summer",
        "soft-autumn",
        "true-autumn",
        "dark-autumn",
        "dark-winter",
        "true-winter",
        "bright-winter"
      ],
      "type": "string",
      "description": "One of the 12 colour seasons. Required unless signed in with a saved season."
    },
    "country": {
      "type": "string",
      "default": "se",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter shopping country, e.g. se, no, gb, us."
    },
    "on_sale": {
      "type": "boolean",
      "description": "Only items on sale."
    },
    "bra_sizes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Bra sizes, e.g. 75B."
    },
    "materials": {
      "type": "array",
      "items": {
        "enum": [
          "cotton",
          "linen",
          "hemp",
          "ramie",
          "wool",
          "cashmere",
          "alpaca",
          "mohair",
          "angora",
          "camel-hair",
          "silk",
          "down",
          "leather",
          "suede",
          "viscose",
          "lyocell",
          "modal",
          "cupro",
          "acetate",
          "bamboo",
          "polyester",
          "polyamide",
          "acrylic",
          "elastane",
          "polyurethane",
          "polypropylene"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Fabrics, e.g. wool, linen, silk."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest price in the country's currency."
    },
    "min_price": {
      "type": "number",
      "minimum": 0,
      "description": "Lowest price in the country's currency."
    },
    "occasions": {
      "type": "array",
      "items": {
        "enum": [
          "everyday",
          "work",
          "going-out",
          "party",
          "formal",
          "active",
          "lounge",
          "vacation"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "What it is for, e.g. work, party, vacation."
    },
    "aesthetics": {
      "type": "array",
      "items": {
        "enum": [
          "minimalist",
          "classic",
          "bohemian",
          "romantic",
          "streetwear",
          "sporty",
          "edgy",
          "preppy",
          "glamorous",
          "workwear"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Style, e.g. minimalist, romantic."
    },
    "body_types": {
      "type": "array",
      "items": {
        "enum": [
          "hourglass",
          "pear",
          "apple",
          "rectangle",
          "inverted-triangle"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Body shapes the piece flatters."
    },
    "categories": {
      "type": "array",
      "items": {
        "enum": [
          "tops",
          "t_shirts",
          "shirts_and_blouses",
          "sweaters_and_cardigans",
          "sweatshirts_and_hoodies",
          "knitwear",
          "trousers",
          "skirts",
          "shorts",
          "dresses",
          "jumpsuits",
          "blazers",
          "jackets",
          "outerwear",
          "activewear",
          "swimwear",
          "underwear",
          "shoes",
          "bags",
          "jewelry",
          "accessories",
          "scarves",
          "hats_and_caps",
          "belts",
          "sunglasses",
          "lipstick",
          "eyeshadow",
          "mascara",
          "eyeliner",
          "blush",
          "nail_polish"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "Kinds of item, e.g. dresses, knitwear."
    },
    "shoe_sizes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Shoe sizes, e.g. 38."
    },
    "formalities": {
      "type": "array",
      "items": {
        "enum": [
          "lounge",
          "casual",
          "semi-formal",
          "formal"
        ],
        "type": "string"
      },
      "maxItems": 20,
      "description": "How dressy, e.g. casual, formal."
    },
    "waist_sizes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Waist sizes, e.g. 28."
    },
    "letter_sizes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Clothing sizes, e.g. S, M."
    },
    "inseam_lengths": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      },
      "maxItems": 20,
      "description": "Inseam lengths, e.g. 32."
    }
  },
  "additionalProperties": false
}

second_hand_in_my_season annotations

{
  "title": "Second-hand in my season",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 940 ms
95th percentile latency: 940 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 8:48 AM UTC · probe · passed · 940 ms · metadata changed · 4 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http shop-your-color-season-mcp https://shopyourcolorseason.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add shop-your-color-season-mcp --url https://shopyourcolorseason.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable shop-your-color-season-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "shop-your-color-season-mcp": {
      "url": "https://shopyourcolorseason.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "shop-your-color-season-mcp": {
      "type": "streamableHttp",
      "url": "https://shopyourcolorseason.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start shop-your-color-season-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "shop-your-color-season-mcp": {
      "type": "http",
      "url": "https://shopyourcolorseason.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http shop-your-color-season-mcp https://shopyourcolorseason.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "shop-your-color-season-mcp": {
      "url": "https://shopyourcolorseason.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "shop-your-color-season-mcp": {
      "serverUrl": "https://shopyourcolorseason.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Shop Your Color Season MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 1,099

Do you run Shop Your Color Season MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

Shop Your Color Season MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other commerce servers

Do you run Shop Your Color Season MCP?