mcp
Read-only Hermes resale research: listings, asking prices, reports, auctions and directories.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp": {
"url": "https://birkinbagstock.com/mcp"
}
}
}Remote endpoints
https://birkinbagstock.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
π’get_hermes_resale_report(slug)
Read a fixed monthly research report from BirkinBagStock, including source URL, cutoff, cohort size, method and caveats. Reseller asking prices are not completed sales or a guaranteed valuation.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"enum": [
"hermes-resale-october-2026"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"citation": {
"type": "string"
},
"data_cutoff": {
"type": "string"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"findings": {
"items": {
"type": "object"
},
"type": "array"
},
"message": {
"type": "string"
},
"metadata": {
"type": [
"object",
"null"
]
},
"status": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"version": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’list_hermes_auctions(house, limit, status)
Read indexed auction sales containing Hermès lots, with dates, catalogue source links and recorded lot counts. Coverage is a sample; sale details can change at the auction house.
Input Schema
{
"type": "object",
"properties": {
"house": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"status": {
"enum": [
"upcoming",
"live",
"closed",
"all"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"sales": {
"items": {
"type": "object"
},
"maxItems": 100,
"type": "array"
},
"status": {
"type": "string"
},
"total_matching": {
"maximum": 1000000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’get_hermes_auction_results(currency, house, limit, model, since, ...)
Read recorded Hermès auction results with original-currency prices, price basis, check dates and auction-house source links. Hammer and premium-inclusive results differ; coverage is a sample.
Input Schema
{
"type": "object",
"properties": {
"currency": {
"maxLength": 80,
"minLength": 1,
"pattern": "^[A-Z]{3}$",
"type": "string"
},
"house": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"limit": {
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"model": {
"enum": [
"Birkin",
"Kelly",
"Constance",
"Evelyne",
"Picotin",
"Lindy",
"Garden Party",
"Bolide",
"Herbag"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"since": {
"format": "date",
"maxLength": 80,
"minLength": 1,
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"sold": {
"type": "boolean"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"maximum": 200,
"minimum": 0,
"type": "integer"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"lots": {
"items": {
"properties": {
"currency": {
"type": [
"string",
"null"
]
},
"lot_url": {
"type": [
"string",
"null"
]
},
"price_basis": {
"type": "string"
},
"result": {
"type": [
"number",
"null"
]
},
"sold": {
"type": "boolean"
},
"source_checked_at": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"maxItems": 200,
"type": "array"
},
"message": {
"type": "string"
},
"stats_all_lots": {
"type": "object"
},
"stats_matching": {
"type": "object"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’list_birkin_resellers(region)
Read reseller names, regions and indexed available-listing counts from BirkinBagStock. Counts reflect scheduled source checks; inclusion is not an endorsement.
Input Schema
{
"type": "object",
"properties": {
"region": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"merchants": {
"items": {
"type": "object"
},
"type": "array"
},
"message": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’find_hermes_care_services(category, country)
Read the independent directory of handbag care and accessory providers by country and category. Directory inclusion does not certify quality or authenticity; this tool does not book or pay for services.
Input Schema
{
"type": "object",
"properties": {
"category": {
"enum": [
"restoration",
"authentication",
"organizers",
"hardware",
"artisan",
"logistics"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"country": {
"maxLength": 80,
"minLength": 1,
"pattern": "^[A-Z]{2}$",
"type": "string"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"categories": {
"items": {
"type": "string"
},
"type": "array"
},
"count": {
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"services": {
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’search_birkin(color, condition, hardware, leather, limit, ...)
Search the indexed Birkin catalogue by specifications and USD asking-price budget. Returns at most 10 listing pages with seller names. Data reflects scheduled source checks, not guaranteed availability; BirkinBagStock does not authenticate bags.
Input Schema
{
"type": "object",
"properties": {
"color": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"condition": {
"enum": [
"new",
"like_new",
"excellent",
"very_good",
"good",
"fair"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"hardware": {
"enum": [
"phw",
"ghw",
"rghw",
"bghw",
"ruthenium",
"permabrass"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"leather": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"limit": {
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"max_price": {
"minimum": 1,
"type": "number"
},
"merchant": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"min_price": {
"minimum": 0,
"type": "number"
},
"query": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"size": {
"enum": [
"20",
"25",
"30",
"35",
"40",
"45",
"50",
"55"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"sort": {
"enum": [
"best",
"price_asc",
"price_desc",
"newest"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"maximum": 10,
"minimum": 0,
"type": "integer"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"results": {
"items": {
"properties": {
"id": {
"type": "string"
},
"listing_url": {
"pattern": "^https://birkinbagstock\\.com/listing/[^/?]+\\?source=mcp$",
"type": "string"
},
"merchant": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
]
},
"price_currency": {
"type": "string"
}
},
"required": [
"id",
"listing_url",
"merchant"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’get_market_price(color, hardware, leather, size)
Calculate USD asking-price statistics for matching indexed Birkin listings. Includes sample and priced-listing counts when available. These are seller offers, not completed sales, authentication or a guaranteed appraisal.
Input Schema
{
"type": "object",
"properties": {
"color": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"hardware": {
"enum": [
"phw",
"ghw",
"rghw",
"bghw",
"ruthenium",
"permabrass"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"leather": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"size": {
"enum": [
"20",
"25",
"30",
"35",
"40",
"45",
"50",
"55"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"avg": {
"minimum": 0,
"type": "number"
},
"count": {
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"max": {
"minimum": 0,
"type": "number"
},
"median": {
"minimum": 0,
"type": "number"
},
"message": {
"type": "string"
},
"min": {
"minimum": 0,
"type": "number"
},
"p25": {
"minimum": 0,
"type": "number"
},
"p75": {
"minimum": 0,
"type": "number"
},
"priced_count": {
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’compare_listings(listing_ids)
Compare the recorded specifications and USD asking prices of two or three distinct listing IDs. Price-on-request listings may have no numeric price; the lowest recorded ask is not a quality or authenticity recommendation.
Input Schema
{
"type": "object",
"properties": {
"listing_ids": {
"items": {
"maxLength": 80,
"minLength": 1,
"pattern": "^[A-Za-z0-9_-]+$",
"type": "string"
},
"maxItems": 3,
"minItems": 2,
"type": "array",
"uniqueItems": true
}
},
"required": [
"listing_ids"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"cheapest_id": {
"type": [
"string",
"null"
]
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"rows": {
"items": {
"properties": {
"id": {
"type": "string"
},
"listing_url": {
"pattern": "^https://birkinbagstock\\.com/listing/[^/?]+\\?source=mcp$",
"type": "string"
},
"merchant": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
]
},
"price_currency": {
"type": "string"
}
},
"required": [
"id",
"listing_url",
"merchant"
],
"type": "object"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
},
"spread": {
"type": [
"number",
"null"
]
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’get_price_trend(color, days, leather, query, size, ...)
Read daily indexed median-ask snapshots for an existing Birkin specification over 7β90 days. May return insufficient_data or no_landing. Changing samples affect trends; historical asks do not predict returns or future prices.
Input Schema
{
"type": "object",
"properties": {
"color": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"days": {
"maximum": 90,
"minimum": 7,
"type": "integer"
},
"leather": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"query": {
"maxLength": 200,
"minLength": 1,
"type": "string"
},
"size": {
"enum": [
"20",
"25",
"30",
"35",
"40",
"45",
"50",
"55"
],
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"slug": {
"maxLength": 80,
"minLength": 1,
"pattern": "^[a-z0-9-]+$",
"type": "string"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"direction": {
"enum": [
"rising",
"stable",
"falling"
],
"type": "string"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"first_median": {
"type": "number"
},
"last_median": {
"type": "number"
},
"message": {
"type": "string"
},
"pct_change": {
"type": "number"
},
"samples": {
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"slug": {
"type": "string"
},
"status": {
"type": "string"
},
"volume_delta": {
"type": "number"
},
"volume_first": {
"type": "number"
},
"volume_last": {
"type": "number"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’list_market_movers(days, limit)
Read specifications with the largest recorded median-ask percentage changes over 2β30 days in the indexed snapshot history. Limited or changing samples may yield insufficient_data; changes are not investment forecasts.
Input Schema
{
"type": "object",
"properties": {
"days": {
"maximum": 30,
"minimum": 2,
"type": "integer"
},
"limit": {
"maximum": 12,
"minimum": 1,
"type": "integer"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"maximum": 12,
"minimum": 0,
"type": "integer"
},
"days": {
"maximum": 30,
"minimum": 2,
"type": "integer"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"results": {
"items": {
"type": "object"
},
"maxItems": 12,
"type": "array"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’list_popular_specs(limit)
Read frequently requested specification pages with recorded match counts. Popularity reflects BirkinBagStock page requests, not market-wide sales or demand. Returns at most 12 specification pages.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"maximum": 12,
"minimum": 1,
"type": "integer"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"maximum": 12,
"minimum": 0,
"type": "integer"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"results": {
"items": {
"type": "object"
},
"maxItems": 12,
"type": "array"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}π’get_authentication_signals(blind_stamp, leather)
Read a curated inspection checklist, recorded blind-stamp year references and leather notes. Educational reference only: no photographs are analyzed and no individual bag is certified authentic or counterfeit.
Input Schema
{
"type": "object",
"properties": {
"blind_stamp": {
"maxLength": 80,
"minLength": 1,
"pattern": "^[A-Za-z]$",
"type": "string"
},
"leather": {
"maxLength": 80,
"minLength": 1,
"type": "string"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"blind_stamp_table": {
"items": {
"type": "object"
},
"type": "array"
},
"checklist": {
"items": {
"type": "string"
},
"type": "array"
},
"disclosure": {
"type": "string"
},
"error": {
"type": "string"
},
"leather_note": {
"type": "string"
},
"matched_blind_stamp_year": {
"type": "string"
},
"message": {
"type": "string"
},
"recommended_authenticators": {
"items": {
"type": "object"
},
"type": "array"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"disclosure"
],
"additionalProperties": true
}Community
Evidence