fendi-mcp 1.0.0

package/README.md

@@ -0,0 +1,14 @@
+# 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.
+
+## 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.
+
+## Source
+
+[fendi-mcp](https://github.com/mrfentmen/awesome-mcps/tree/main/servers/fendi-mcp)

package/dist/api.d.ts

@@ -0,0 +1,8 @@
+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 getListing(handle: string, source?: string): Promise<string>;
+export declare function priceOverview(limit?: string): Promise<string>;

package/dist/api.js

@@ -0,0 +1,145 @@
+export class FendiError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FendiError";
+    }
+}
+export function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+const UA = { "User-Agent": "awesome-mcps/1.0" };
+const VENDORS = ["fendi"];
+const SOURCES = [
+    {
+        name: "fashionphile",
+        catalog: "https://www.fashionphile.com/products.json",
+        suggest: "https://www.fashionphile.com/search/suggest.json",
+        product: (handle) => `https://www.fashionphile.com/products/${encodeURIComponent(handle)}.js`,
+    },
+    {
+        name: "rebag",
+        catalog: "https://shop.rebag.com/products.json",
+        suggest: "https://shop.rebag.com/search/suggest.json",
+        product: (handle) => `https://shop.rebag.com/products/${encodeURIComponent(handle)}.js`,
+    },
+];
+function matchesBrand(vendor) {
+    const v = String(vendor ?? "").toLowerCase();
+    return VENDORS.some((s) => v.includes(s));
+}
+function slim(source, base, p) {
+    const variants = Array.isArray(p.variants) ? p.variants : [];
+    const prices = variants.map((v) => Number(v.price)).filter((n) => Number.isFinite(n));
+    const comps = variants.map((v) => Number(v.compare_at_price)).filter((n) => Number.isFinite(n));
+    const images = Array.isArray(p.images) ? p.images : [];
+    return {
+        source,
+        id: p.id,
+        title: p.title,
+        handle: p.handle,
+        vendor: p.vendor,
+        product_type: p.product_type,
+        price_usd: prices.length ? Math.min(...prices) : null,
+        compare_at_usd: comps.length ? Math.min(...comps) : null,
+        available: variants.some((v) => v.available),
+        url: `${base}/${p.handle}`,
+        image: images.length ? images[0].src ?? null : null,
+    };
+}
+function pretty(data) {
+    const t = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+    return t.length > 12000 ? t.slice(0, 12000) + "\n…(truncated)" : t;
+}
+async function getJson(url) {
+    let res;
+    try {
+        res = await fetch(url, { headers: { ...UA } });
+    }
+    catch (e) {
+        throw new FendiError(`Network error: ${e.message}`);
+    }
+    if (!res.ok)
+        throw new FendiError(`HTTP ${res.status} for ${new URL(url).hostname}`);
+    return res.json();
+}
+async function catalog(source, page) {
+    const data = await getJson(`${source.catalog}?limit=250&page=${page}`);
+    const products = Array.isArray(data.products) ? data.products : [];
+    return products.filter((p) => matchesBrand(p.vendor));
+}
+export async function searchListings(query, limit) {
+    const n = Math.min(Number(limit ?? 10) || 10, 25);
+    const out = [];
+    for (const s of SOURCES) {
+        try {
+            const data = await getJson(`${s.suggest}?q=${encodeURIComponent(query)}&resources[type]=product&resources[limit]=${n}`);
+            const products = data?.resources?.results?.products ?? [];
+            const base = s.catalog.replace("/products.json", "");
+            for (const p of products) {
+                if (matchesBrand(p.vendor))
+                    out.push(slim(s.name, base, p));
+                if (out.length >= n)
+                    break;
+            }
+        }
+        catch { /* source down — keep the other */ }
+        if (out.length >= n)
+            break;
+    }
+    return pretty({ brand: "Fendi", query, count: out.length, listings: out.slice(0, n) });
+}
+export async function listNewest(limit, page) {
+    const n = Math.min(Number(limit ?? 20) || 20, 50);
+    const pg = Math.max(Number(page ?? 1) || 1, 1);
+    const out = [];
+    for (const s of SOURCES) {
+        try {
+            const base = s.catalog.replace("/products.json", "");
+            for (const p of await catalog(s, pg))
+                out.push(slim(s.name, base, p));
+        }
+        catch { /* source down — keep the other */ }
+    }
+    return pretty({ brand: "Fendi", page: pg, count: out.length, listings: out.slice(0, n) });
+}
+export async function getListing(handle, source) {
+    const sources = source ? SOURCES.filter((s) => s.name === source) : SOURCES;
+    if (!sources.length)
+        throw new FendiError(`Unknown source '${source}'. Use fashionphile or rebag.`);
+    for (const s of sources) {
+        try {
+            return pretty({ brand: "Fendi", source: s.name, product: await getJson(s.product(handle)) });
+        }
+        catch { /* try next source */ }
+    }
+    throw new FendiError(`Listing '${handle}' not found on ${sources.map((s) => s.name).join(", ")}.`);
+}
+export async function priceOverview(limit) {
+    const n = Math.min(Number(limit ?? 200) || 200, 500);
+    const prices = [];
+    for (const s of SOURCES) {
+        try {
+            const base = s.catalog.replace("/products.json", "");
+            for (const p of await catalog(s, 1)) {
+                const sl = slim(s.name, base, p);
+                if (sl.price_usd !== null)
+                    prices.push(sl.price_usd);
+                if (prices.length >= n)
+                    break;
+            }
+        }
+        catch { /* source down — keep the other */ }
+        if (prices.length >= n)
+            break;
+    }
+    if (!prices.length)
+        throw new FendiError("No priced listings found.");
+    prices.sort((a, b) => a - b);
+    const mid = (arr) => arr.length % 2 ? arr[(arr.length - 1) / 2] : (arr[arr.length / 2 - 1] + arr[arr.length / 2]) / 2;
+    return pretty({
+        brand: "Fendi", currency: "USD", sample: prices.length,
+        min: prices[0], p25: prices[Math.floor(prices.length * 0.25)],
+        median: mid(prices), p75: prices[Math.floor(prices.length * 0.75)], max: prices[prices.length - 1],
+        note: "Asking prices on resale sources, not appraisals. Not affiliated with Fendi.",
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,76 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { errorMessage, searchListings, listNewest, getListing, priceOverview, } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+export function createServer() {
+    const server = new McpServer({
+        name: "fendi-mcp",
+        version: "1.0.0",
+    });
+    server.registerTool("search_listings", {
+        title: "Search listings",
+        description: "Search resale listings by keyword across Fashionphile and Rebag.",
+        inputSchema: z.object({
+            query: z.string().describe("Keyword, e.g. speedy, birkin, submariner."),
+            limit: z.string().describe("Max results (default 10, max 25).").optional()
+        }),
+        annotations: READ_ONLY,
+    }, async ({ query, limit }) => {
+        try {
+            return text(await searchListings(query, limit));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("list_newest", {
+        title: "Newest listings",
+        description: "Newest catalog listings from both resale sources.",
+        inputSchema: z.object({
+            limit: z.string().describe("Max results (default 20, max 50).").optional(),
+            page: z.string().describe("Catalog page (default 1).").optional()
+        }),
+        annotations: READ_ONLY,
+    }, async ({ limit, page }) => {
+        try {
+            return text(await listNewest(limit, page));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("get_listing", {
+        title: "Get listing",
+        description: "Full listing details by handle.",
+        inputSchema: z.object({
+            handle: z.string().describe("Product handle/slug."),
+            source: z.string().describe("fashionphile or rebag (tries both).").optional()
+        }),
+        annotations: READ_ONLY,
+    }, async ({ handle, source }) => {
+        try {
+            return text(await getListing(handle, source));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("price_overview", {
+        title: "Price overview",
+        description: "Ask-price distribution (min/p25/median/p75/max). Asks, not appraisals.",
+        inputSchema: z.object({
+            limit: z.string().describe("Sample size (default 200, max 500).").optional()
+        }),
+        annotations: READ_ONLY,
+    }, async ({ limit }) => {
+        try {
+            return text(await priceOverview(limit));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "fendi-mcp",
+  "version": "1.0.0",
+  "description": "Fendi resale listings from Fashionphile and Rebag. Keyless.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/fendi-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/awesome-mcps.git"
+  },
+  "bin": {
+    "fendi-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "rm -rf dist && tsc -p tsconfig.json && node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "fendi",
+    "luxury",
+    "resale",
+    "fashion"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}