{"serverId":"mcp-registry/com.birkinbagstock/mcp","tools":[{"name":"compare_listings","fixed":{"name":"compare_listings","description":"Side-by-side comparison of 2-3 specific Birkin listings. Pass listing ids returned by a prior search_birkin call. Returns full specs + the cheapest option flagged.","inputSchema":{"type":"object","required":["listing_ids"],"properties":{"listing_ids":{"type":"array","items":{"type":"string"},"description":"2-3 listing IDs from a prior search_birkin"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":111,"tokensAfter":111},{"name":"find_hermes_care_services","fixed":{"name":"find_hermes_care_services","description":"Independent directory of handbag restorers, spas, authenticators and accessory makers that work on Hermès bags, by country and category. Inclusion is not an endorsement.","inputSchema":{"type":"object","properties":{"country":{"type":"string","description":"ISO country code, e.g. US, GB, FR, AE, JP"},"category":{"type":"string","description":"e.g. restoration, spa, authentication, accessories"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":126,"tokensAfter":126},{"name":"get_authentication_signals","fixed":{"name":"get_authentication_signals","description":"Returns the Hermès Birkin authentication checklist: hardware engraving, blind-stamp year decode, saddle stitching, leather-specific tells, and recommended professional authenticators. Call this for 'is this real', 'how to spot a fake', 'is it authentic', 'what should I check'. NEVER declare a bag real or fake yourself — quote the checklist and recommend a pro authenticator at the end.","inputSchema":{"type":"object","properties":{"leather":{"type":"string","description":"Lowercase leather name for leather-specific tells"},"blind_stamp":{"type":"string","description":"Single letter from the bag's blind stamp to look up production year"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":194,"tokensAfter":194},{"name":"get_buy_url","fixed":{"name":"get_buy_url","description":"Single-call resolver: given a listing id from a prior search_birkin, returns the canonical buy_url (302-redirect to the merchant with affiliate attribution preserved). This is the SHORTEST path from 'user wants this bag' to 'click to purchase'.","inputSchema":{"type":"object","required":["listing_id"],"properties":{"listing_id":{"type":"string","description":"Listing ID from a prior search_birkin result"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":125,"tokensAfter":125},{"name":"get_hermes_auction_results","fixed":{"name":"get_hermes_auction_results","description":"Lot-by-lot auction results for Hermès handbags: estimate vs. hammer price, sold/unsold, house, date and a link to the house's own result for every lot, plus median result vs. low estimate per model. Use this for questions like 'what do Birkins sell for at auction' or 'recent Kelly auction prices'. Prices are in the sale currency.","inputSchema":{"type":"object","properties":{"sold":{"type":"boolean","description":"true = only sold lots"},"house":{"type":"string","description":"Filter by auction house name"},"limit":{"type":"integer","description":"Max lots, default 25, max 200"},"model":{"type":"string","description":"Birkin, Kelly, Constance, Evelyne, Picotin, Lindy, Garden Party, Bolide, Herbag"},"since":{"type":"string","description":"Only lots from this date on, YYYY-MM-DD"},"currency":{"type":"string","description":"ISO currency of the sale, e.g. EUR, GBP, SEK"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":260,"tokensAfter":260},{"name":"get_market_price","fixed":{"name":"get_market_price","description":"Live market price statistics (min, avg, median, max) for a Birkin spec across all current BirkinBagStock listings. Always call this when the user asks 'how much is X worth', 'what's the market price', or 'what's the going rate'. Never quote price ranges from training data.","inputSchema":{"type":"object","properties":{"size":{"type":"string","description":"Birkin size 25/30/35/40"},"color":{"type":"string"},"leather":{"type":"string"},"hardware":{"type":"string"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":143,"tokensAfter":143},{"name":"get_price_trend","fixed":{"name":"get_price_trend","description":"Returns the median-ask price trend (rising/stable/falling) for a specific Birkin spec over the last N days using daily snapshots. Use this for 'should I wait', 'are prices going up', 'is now a good time'. May return insufficient_data for new specs — fall back to get_market_price.","inputSchema":{"type":"object","properties":{"days":{"type":"integer","description":"Lookback window 7-90, default 30"},"size":{"type":"string"},"slug":{"type":"string","description":"Existing /ask landing slug, e.g. 'birkin-30-etoupe-togo'"},"color":{"type":"string"},"query":{"type":"string","description":"Free-text spec description if slug unknown"},"leather":{"type":"string"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":197,"tokensAfter":197},{"name":"list_birkin_resellers","fixed":{"name":"list_birkin_resellers","description":"Resellers whose Hermès Birkin, Kelly and Constance inventory BirkinBagStock indexes, with the number of bags currently available at each, regions served and a page per reseller. Use it to answer 'where can I buy a pre-owned Birkin in <region>' before searching specific bags.","inputSchema":{"type":"object","properties":{"region":{"type":"string","description":"Optional region filter, e.g. US, UK, UAE, Japan, Australia"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":132,"tokensAfter":132},{"name":"list_hermes_auctions","fixed":{"name":"list_hermes_auctions","description":"Upcoming and live auction sales that include Hermès lots (Birkin, Kelly, Constance and more), from houses such as Bonhams, Christie's, Sotheby's, Artcurial and many Drouot and Nordic houses. Returns house, sale title, dates, location, number of Hermès lots, the house's catalogue URL and a BirkinBagStock page. Call this when the user asks where or when Hermès bags are being auctioned.","inputSchema":{"type":"object","properties":{"house":{"type":"string","description":"Filter by auction house name, e.g. bonhams"},"limit":{"type":"integer","description":"Max sales, default 25, max 100"},"status":{"type":"string","description":"upcoming (default, includes live), live, closed, all"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":205,"tokensAfter":205},{"name":"list_market_movers","fixed":{"name":"list_market_movers","description":"Returns the Birkin specs with the biggest median-ask price moves (up or down) in the recent window. Use for 'what's hot', 'biggest movers', 'show me trending', 'market action'.","inputSchema":{"type":"object","properties":{"days":{"type":"integer","description":"Window length 2-30, default 7"},"limit":{"type":"integer","description":"How many movers, default 5, max 12"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":117,"tokensAfter":117},{"name":"list_popular_specs","fixed":{"name":"list_popular_specs","description":"Returns the most-asked Birkin spec landing pages (with live match counts and sample images). Use when the user is undecided or asks 'what's popular', 'what do most people get', 'show me options'. Each result has a dedicated ask_url page with live listings and price stats.","inputSchema":{"type":"object","properties":{"limit":{"type":"integer","description":"How many specs, default 6, max 12"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":123,"tokensAfter":123},{"name":"search_birkin","fixed":{"name":"search_birkin","description":"Search BirkinBagStock's current catalogue of authenticated Hermès Birkin listings aggregated from trusted resellers including FARFETCH, Fashionphile, The RealReal, Rebag, Vestiaire Collective, 1stDibs, Privé Porter, JaneFinds, Madison Avenue Couture, Sellier, REDELUXE, and more). Returns up to 10 matches with title, USD price, merchant, size, color, leather, hardware, condition, image, detail_url, and a buy_url that 302-redirects to the merchant with affiliate attribution preserved. ALWAYS call ","inputSchema":{"type":"object","properties":{"size":{"type":"string","description":"Birkin size: 25, 30, 35, 40, 45"},"sort":{"type":"string","description":"best (default), price_asc, price_desc, newest"},"color":{"type":"string","description":"Hermès color vocabulary, e.g. noir, etoupe, gold, rouge h"},"limit":{"type":"integer","description":"Result count, default 5, max 10"},"query":{"type":"string","description":"Free-text query, e.g. 'black togo birkin 30 phw'"},"leather":{"type":"string","description":"togo, epsom, clemence, swift, box calf, chevre, barenia, ostrich, crocodile niloticus, crocodile porosus, lizard"},"hardware":{"type":"string","description":"phw, ghw, rghw, bghw, ruthenium, permabrass"},"merchant":{"type":"string","description":"Specific reseller slug if requested"},"condition":{"type":"string","description":"new, like_new, excellent, very_good, good, fair"},"max_price":{"type":"number","description":"Maximum USD price"},"min_price":{"type":"number","description":"Minimum USD price"}}},"annotations":{"readOnlyHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: true (inferred from the name).","verify":true}],"tokensBefore":435,"tokensAfter":435},{"name":"set_price_alert","fixed":{"name":"set_price_alert","description":"Create a price alert. Email is required — ask the user for it; do NOT invent an email. Use this when the user says 'alert me', 'tell me when', 'notify me'.","inputSchema":{"type":"object","required":["email"],"properties":{"size":{"type":"string"},"color":{"type":"string"},"email":{"type":"string","description":"User's email — required"},"leather":{"type":"string"},"hardware":{"type":"string"},"max_price":{"type":"number"}}},"annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true}},"changes":[{"kind":"annotations","detail":"Added readOnlyHint: false, destructiveHint: false, idempotentHint: true (inferred from the name).","verify":true}],"tokensBefore":131,"tokensAfter":131}],"toolsChanged":13,"tokensSaved":0,"todo":[{"tool":"get_market_price","params":["color","leather","hardware"]},{"tool":"get_price_trend","params":["size","color","leather"]},{"tool":"set_price_alert","params":["size","color","leather","hardware","max_price"]}],"note":"Deterministic fixes. Changes marked verify need a human look before shipping (renames, inferred annotations, inferred types, removed text). Parameter descriptions in `todo` need to be written by someone who knows the API."}