klydo-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@klydo-mcp find stylish kurtas for women under โน1500"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Klydo MCP Server
Fashion discovery MCP server for Indian Gen Z.
Enables AI assistants like Claude to search and discover fashion products from Klydo โ India's Gen-Z quick tech fashion commerce platform based in Bangalore.
โจ Features
๐ Search Products โ Search fashion items with filters (category, gender, price range)
๐ฆ Product Details โ Get complete product info including images, sizes, colors, ratings
๐ฅ Trending Products โ Discover what's popular right now
๐ Structured Logging โ Debug-friendly logs with Loguru
โก Fast & Cached โ In-memory caching for quick responses
Related MCP server: Vistoya
๐ Quick Start
Installation
Option 1: Install from PyPI (Recommended)
# Using pip
pip install klydo-mcp
# Or using pipx (isolated environment)
pipx install klydo-mcp
# Or using uvx (no installation needed)
uvx --from klydo-mcp klydoOption 2: Install from Source
# Clone the repository
git clone https://github.com/myselfshravan/klydo-mcp.git
cd klydo-mcp
# Install dependencies with uv
uv syncUsage with Claude Desktop
If installed via PyPI (pip/pipx)
Add to your Claude Desktop configuration:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"klydo": {
"command": "klydo"
}
}
}If using uvx (recommended for easy updates)
{
"mcpServers": {
"klydo": {
"command": "uvx",
"args": ["--from", "klydo-mcp", "klydo"]
}
}
}If installed from source
{
"mcpServers": {
"klydo": {
"command": "uv",
"args": ["--directory", "/path/to/klydo-mcp", "run", "klydo"]
}
}
}Then restart Claude Desktop.
Run Standalone
uv run klydo๐ ๏ธ MCP Tools
search_products
Search for fashion products.
Parameter | Type | Description |
| string | required โ Search terms (e.g., "black dress", "nike shoes") |
| string | Filter by category (e.g., "dresses", "shoes") |
| string | Filter by gender ("men" or "women") |
| int | Minimum price in INR |
| int | Maximum price in INR |
| int | Max results (default 10, max 50) |
get_product_details
Get complete product information.
Parameter | Type | Description |
| string | required โ Product ID from search results |
Returns: Full details โ images, sizes, colors, ratings, and purchase link.
get_trending
Discover what's hot rn ๐ฅ
Parameter | Type | Description |
| string | Category filter |
| int | Max results (default 10, max 50) |
โ๏ธ Configuration
Copy .env.example to .env and customize:
# Request settings
KLYDO_REQUEST_TIMEOUT=30
KLYDO_CACHE_TTL=3600
# Debug mode (set to false in production)
KLYDO_DEBUG=false
# API token for klydo.in (required)
KLYDO_KLYDO_API_TOKEN=your-token๐ Project Structure
klydo-mcp/
โโโ src/klydo/
โ โโโ __init__.py
โ โโโ server.py # MCP server entry point
โ โโโ config.py # Configuration (Pydantic Settings)
โ โโโ logging.py # Loguru configuration
โ โโโ models/
โ โ โโโ product.py # Product, Price models
โ โโโ scrapers/
โ โโโ base.py # Scraper protocol (interface)
โ โโโ cache.py # In-memory cache with TTL
โ โโโ klydo_store.py # Klydo.in API client
โโโ tests/ # Test suite
โโโ .github/workflows/ # CI/CD pipelines
โโโ pyproject.toml
โโโ README.md๐งช Testing
# Run all tests
uv run pytest
# Run with verbose output
uv run pytest -v
# Run specific test file
uv run pytest tests/test_models.py๐ง Development
# Install dev dependencies
uv sync --dev
# Run linting
uv run ruff check src/
# Format code
uv run ruff format src/
# Run the server locally
uv run klydo๐ค Contributing
We welcome contributions! Please see our Contributing Guide for details.
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)Open a Pull Request
๐ Security
For security issues, please see our Security Policy.
๐ License
MIT License โ see LICENSE for details.
๐ข About Klydo
Klydo is a Bangalore-based startup building quick tech fashion commerce for Gen-Z (18-32 age group). We're making fashion discovery seamless, fast, and accessible. This MCP server extends our platform to AI assistants, enabling natural language fashion search.
Backed by innovation. Built for Gen-Z. Made in India. ๐ฎ๐ณ
Made with โค๏ธ in Bangalore, India
Available Tools
3 toolsget_product_detailsA
Get complete product information including all images, sizes, and specifications.
Args: product_id: The product ID from search results (the 'id' field)
Returns: Full product details with: - images: ALL product images from multiple angles (show all to users) - image_url: Primary product image - url: Buy link on klydo.in (may be null โ only show when present) - sizes, colors, description, specifications - Returns None if product not found.
Inputs: product_id (required). Returns: result
get_trendingB
Get currently trending/popular fashion products.
Args: category: Optional category filter (e.g., "dresses", "shoes", "tshirts") limit: Maximum number of results (default 10, max 50)
Returns: List of trending products sorted by popularity. Each product has: - image_url: Direct CDN image link (always show this) - url: Buy link on klydo.in (may be null โ only show when present) - price, brand, name, category
Inputs: category, limit. Returns: result
search_productsA
Search for fashion products on Klydo.
Args: query: Search terms (e.g., "black dress", "nike shoes", "cotton kurta") category: Filter by category (e.g., "dresses", "shoes", "tshirts", "kurtas") gender: Filter by gender ("men" or "women") min_price: Minimum price in INR (e.g., 500) max_price: Maximum price in INR (e.g., 2000) limit: Maximum number of results (default 10, max 50)
Returns: List of matching products. Each product has: - image_url: Direct CDN image link (always show this) - url: Buy link on klydo.in (may be null โ only show when present) - price, brand, name, category
Inputs: query (required), category, gender, min_price, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 3 tools
Each tool has a clear, distinct purpose: searching, getting trending products, and retrieving full product details. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (get_product_details, get_trending, search_products), making it easy to predict tool function.
Three tools is appropriate for a focused fashion product server: search, trending, and details. No unnecessary bloat or missing essentials.
The set covers core operations (search, browse trending, view details). Minor gap: no explicit way to list categories or brands, but search and trending cover most use cases.
Maintenance
Related MCP Connectors
Fashion & apparel MCP: visual outfit search, stock verification, and 1-click checkout.
Fashion & apparel MCP: visual outfit search, stock verification, and 1-click checkout.
Search and get fashion products recommendations across multiple e-ecom stores
Fashion product discovery and virtual try-on via the Glance catalog
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for TryOnfy - AI virtual try-on platform that lets you preview clothing, hairstyles, and accessories instantly.9 npm1MIT
- AlicenseNot gradedqualityDmaintenanceThe Vistoya MCP server gives AI agents direct access to a curated, multi-brand fashion catalog. Agents can search by structured filters, discover products through natural language, find similar items, and retrieve full product details โ all over a single Streamable HTTP connection.10 npmMIT
- FlicenseAqualityBmaintenanceA fashion vertical MCP server providing tools for product SEO audits and trend analysis to integrate with AI agents like Claude, Cursor, and Codex.2-
- AlicenseNot gradedqualityDmaintenanceMCP server that integrates multiple AI image generation providers (WaveSpeed, Nano Banana, OpenAI, Stability, fal.ai) to automate photoshoot tasks like product photography, fashion content, and batch editing.9MIT