fendi-mcp 1.0.0 → 1.0.2

package/README.md

@@ -1,14 +1,39 @@
 # fendi-mcp
 
-Fendi resale listings aggregated from Fashionphile and Rebag public catalogs (prices in USD). No API key required. Not affiliated with or endorsed by Fendi; prices are asking prices, not appraisals.
+Fendi resale listings aggregated from Fashionphile and Rebag public catalogs (prices in USD). No API key required. Condition/color/material attributes are parsed from Rebag catalog data (Fashionphile does not publish them); condition filters apply to Rebag data only. Not affiliated with or endorsed by Fendi; prices are asking prices, not appraisals.
 
 ## Tools
 
-- `search_listings` — Search resale listings by keyword across Fashionphile and Rebag.
-- `list_newest` — Newest catalog listings from both resale sources.
-- `get_listing` — Full listing details by handle.
-- `price_overview` — Ask-price distribution (min/p25/median/p75/max). Asks, not appraisals.
+- `search_listings` — Keyword search across Fashionphile and Rebag. Condition filter is Rebag-data only.
+- `list_newest` — Newest catalog listings, sorted by publish date.
+- `get_listing` — Full details: variants, images, parsed condition/color/material, description.
+- `price_overview` — Ask-price stats overall + by condition.
+- `compare_prices` — Group same-model listings across sources with min/max/spread.
+- `find_deals` — Available listings priced below the brand median.
+- `brand_overview` — Catalog sample counts by source, type and condition.
+- `list_collections` — Curated store collections with handles for browse_collection, e.g. sale or category collections.
+- `browse_collection` — Listings inside one collection handle from list_collections, e.g. a sale or category collection.
+- `find_by_attribute` — Listings filtered by color, exterior material or condition, plus the common values in the sample.
 
 ## Source
 
 [fendi-mcp](https://github.com/mrfentmen/awesome-mcps/tree/main/servers/fendi-mcp)
+
+<!-- paywall -->
+## Premium tools
+
+These tools need a license key:
+
+* `cross_market_match`
+* `price_ladder`
+
+Buy a key at https://mcp-marketplace.io/server/io-github-mrfentmen-fendi-mcp and set it in your MCP client config:
+
+```json
+"env": { "MCP_LICENSE_KEY": "mcp_live_..." }
+```
+
+The key is checked against MCP Marketplace, cached for 24 hours, and keeps
+working offline once one check has succeeded. Every other tool on this server
+stays free.
+<!-- /paywall -->

package/dist/api.d.ts

@@ -2,7 +2,58 @@ export declare class FendiError extends Error {
     constructor(message: string);
 }
 export declare function errorMessage(e: unknown): string;
-export declare function searchListings(query: string, limit?: string): Promise<string>;
-export declare function listNewest(limit?: string, page?: string): Promise<string>;
+export declare function searchListings(query: string, limit?: string, maxPrice?: string, condition?: string): Promise<string>;
+export declare function listNewest(limit?: string, page?: string, productType?: string, maxPrice?: string, condition?: string): Promise<string>;
 export declare function getListing(handle: string, source?: string): Promise<string>;
 export declare function priceOverview(limit?: string): Promise<string>;
+export declare function comparePrices(query: string, limit?: string): Promise<string>;
+export declare function findDeals(limit?: string, sample?: string): Promise<string>;
+export declare function brandOverview(): Promise<string>;
+export declare function listCollections(query?: string): Promise<string>;
+export declare function browseCollection(handle: string, source?: string, limit?: string, maxPrice?: string, condition?: string): Promise<string>;
+export declare function find_by_attribute(color?: string, material?: string, condition?: string, maxPrice?: string, limit?: string, sample?: string): Promise<string>;
+export interface MatchedListing {
+    source: string;
+    title: string;
+    handle: string;
+    price: number | null;
+    available: boolean;
+    condition: string | null;
+    url: string;
+    size: string | null;
+}
+export interface CrossMarketMatchArgs {
+    model?: string;
+    query?: string;
+    pages?: number;
+    limit?: number;
+}
+/**
+ * The same model priced on both sites. The join is on the model name inside the
+ * title, which is a real limitation: it cannot see that a "Baguette" and a
+ * "Baguette II" are different bags, and it will happily treat two colourways of
+ * one bag as one comparison.
+ */
+export declare function crossMarketMatch(args: CrossMarketMatchArgs): Promise<string>;
+export interface PriceLadderArgs {
+    model?: string;
+    query?: string;
+    pages?: number;
+}
+/**
+ * The real floor: the cheapest listing that can actually be bought, as opposed to
+ * the cheapest listing, which on these sites is often sold out and is therefore
+ * not a price at all.
+ */
+export declare function priceLadder(args: PriceLadderArgs): Promise<string>;
+export interface SourceTaxonomyArgs {
+    source?: string;
+    top?: number;
+}
+/**
+ * The two sites' product types side by side. They are not reconcilable: the
+ * catalogs use disjoint vocabularies, so a category filter on one site means
+ * nothing on the other and a cross-site count by category is not a like-for-like
+ * comparison.
+ */
+export declare function sourceTaxonomy(args: SourceTaxonomyArgs): Promise<string>;