Khanoumi

What Khanoumi MCP server does

Khanoumi MCP server gives an AI agent read-only access to product and store information from Khanoumi, an Iranian beauty retailer. Queries can be made in Persian or English, and prices are returned in Toman. The catalog tools cover cosmetics, skin care, hair care, perfume, categories, brands, promotions, and product guidance from the Khanoumi magazine.

Use kh_search to find products with price, discount, availability, matching categories, and brands. kh_find_cheapest narrows a keyword search to in-stock results and returns one list ordered by payable price. For more controlled discovery, kh_browse supports category, brand, or campaign listings with sorting, price ranges, and filters. Supporting tools expose category IDs, category paths, product counts, brand slugs, and available filter values.

Product-level tools provide details that matter when variants differ. kh_product reports prices and stock for individual shades, sizes, and sellers, along with ratings, attributes, and descriptions. kh_reviews returns customer comments, newest first, including verified-buyer indicators and photos. kh_similar finds alternatives or products Khanoumi pairs with the selected item.

How it works

The Khanoumi MCP server runs on the user's machine and communicates with an AI client through MCP over stdio. It then makes HTTPS requests to public Khanoumi website endpoints, the site's FAQ content, and its blog. There is no hosted intermediary described in the README, and the server does not require an API key or account.

A typical workflow starts with kh_find_cheapest or kh_search, passes a returned product ID or slug to kh_product, and then checks kh_reviews or kh_similar. Category IDs from kh_categories or kh_filters can be used with kh_browse. kh_deals reports the daily pink box, featured deals, countdown information, and the public discount code. kh_store_info covers packaging, shipping, returns, payment, and guarantee rules from the store FAQ, while kh_blog_search finds buying guides, routines, and ingredient explanations.

Setup and configuration

Install uv, then add the server to a compatible MCP client with uvx khanoumi-mcp. Claude Code can use claude mcp add khanoumi -- uvx khanoumi-mcp. Claude Desktop, Cursor, and VS Code can be configured with a stdio server whose command is uvx and whose argument is khanoumi-mcp. Alternatively, install the package with pip and run khanoumi-mcp.

Python 3.10 or newer is required. No API key or account is needed. Set KHANOUMI_MCP_PROXY if requests to khanoumi.com must use an HTTP proxy.

Tools and capabilities

The 12 tools are grouped around discovery, product research, and store information:

• Search keywords, find the cheapest in-stock matches, and browse listings.
• Inspect categories, brands, filter values, price ranges, and stock counts.
• Check current deals, discount codes, and promotion countdowns.
• Compare variant- and seller-specific prices and availability.
• Read ratings, descriptions, attributes, reviews, and similar products.
• Look up shipping, packaging, returns, payment, guarantee, and editorial guidance.

The tool output is compact JSON. final_price represents the payable amount, while price is the pre-discount value; discount percentages are whole numbers, and ratings may be unavailable.

Limitations and notes

The Khanoumi MCP server is unofficial and read-only. It cannot log in, add items to a cart, place orders, access account data, or post reviews. It also cannot provide an exact address-based shipping quote when the website requires login. Prices, stock, discounts, delivery fees, and promotional codes can change, so results should be treated as current catalog information rather than a purchase guarantee. Sponsored search items are removed according to the README, and product images may be returned by search and product detail tools.