MCP Server
mcp
com.birkinbagstock/mcp
What this MCP does
Searches aggregated Hermès Birkin and Kelly listings, compares prices, provides market trends, and creates price alerts.
Capabilities
Tools
13
tools
compare_listings
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.
Input schema
{'type': 'object', 'required': ['listing_ids'], 'properties': {'listing_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': '2-3 listing IDs from a prior search_birkin'}}}
find_hermes_care_services
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.
Input schema
{'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'}}}
get_authentication_signals
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.
Input schema
{'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"}}}
get_buy_url
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'.
Input schema
{'type': 'object', 'required': ['listing_id'], 'properties': {'listing_id': {'type': 'string', 'description': 'Listing ID from a prior search_birkin result'}}}
get_hermes_auction_results
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.
Input schema
{'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'}}}
get_market_price
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.
Input schema
{'type': 'object', 'properties': {'size': {'type': 'string', 'description': 'Birkin size 25/30/35/40'}, 'color': {'type': 'string'}, 'leather': {'type': 'string'}, 'hardware': {'type': 'string'}}}
get_price_trend
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.
Input schema
{'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'}}}
list_birkin_resellers
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.
Input schema
{'type': 'object', 'properties': {'region': {'type': 'string', 'description': 'Optional region filter, e.g. US, UK, UAE, Japan, Australia'}}}
list_hermes_auctions
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.
Input schema
{'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'}}}
list_market_movers
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'.
Input schema
{'type': 'object', 'properties': {'days': {'type': 'integer', 'description': 'Window length 2-30, default 7'}, 'limit': {'type': 'integer', 'description': 'How many movers, default 5, max 12'}}}
list_popular_specs
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.
Input schema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'description': 'How many specs, default 6, max 12'}}}
search_birkin
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 this for any user question about specific Birkin bags, current prices, or availability — never answer from training data.
Input schema
{'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'}}}
set_price_alert
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'.
Input schema
{'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'}}}
History
Recent tool changes
Added
find_hermes_care_services
Oct. 1, 2026, 2:52 a.m.
Added
list_birkin_resellers
Oct. 1, 2026, 2:52 a.m.
Added
get_hermes_auction_results
Oct. 1, 2026, 2:52 a.m.
Added
list_hermes_auctions
Oct. 1, 2026, 2:52 a.m.
Added
get_buy_url
Sept. 17, 2026, 12:33 p.m.
Added
set_price_alert
Sept. 17, 2026, 12:33 p.m.
Added
get_authentication_signals
Sept. 17, 2026, 12:33 p.m.
Added
list_popular_specs
Sept. 17, 2026, 12:33 p.m.
Added
list_market_movers
Sept. 17, 2026, 12:33 p.m.
Added
get_price_trend
Sept. 17, 2026, 12:33 p.m.
Added
compare_listings
Sept. 17, 2026, 12:33 p.m.
Added
get_market_price
Sept. 17, 2026, 12:33 p.m.
Added
search_birkin
Sept. 17, 2026, 12:33 p.m.
Discover
Similar MCP servers
API Direct
io.apidirect/api-direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
Bonanza
io.github.pipeworx-io/bonanza
Searches active Bonanza marketplace listings and retrieves individual item details.
cyclesite-mcp-server
io.github.Tomalarrrr/cyclesite-mcp-server
Supports searching, comparing, valuing, buying, selling, reserving, and messaging about used bicycles on a UK marketplace.
MONO Social
io.github.junoventures/mono-juno-ventures
Provides directory search for local places, events, listings, services, offers, bookings, reservations, tickets, and products.
Campo Belo
io.github.junoventures/campobelo-sampa-br
Provides Campo Belo local discovery for places, events, menus, offers, services, bookings, reservations, tickets, and purchases.
Bom Retiro
io.github.junoventures/bomretiro-sampa-br
Provides Bom Retiro local place, event, menu, offer, service, booking, reservation, ticketing, and checkout capabilities.
Bogeyland
io.github.junoventures/bogeyland-golf
Provides directory search for places, events, services, offers, bookings, reservations, tickets, menus, and purchases.
Genesis Social
io.github.junoventures/genesis-social
Provides directory search and transactions for local places, events, restaurants, services, offers, bookings, and tickets.