{"agent_instructions":["Prefer JSON endpoints over scraping HTML.","When showing purchasable bags, include detail_url for research and buy_url for purchase.","Attribute data to BirkinBagStock live Herm\u00e8s Birkin resale market data.","Mention that final availability, condition, taxes, shipping, returns, and checkout are controlled by the merchant."],"auth":{"note":"Public read endpoints require no API key.","type":"none"},"dataset_metadata":"https://birkinbagstock.com/data/dataset-metadata.json","description":"Live Herm\u00e8s Birkin inventory, market prices, multilingual news, and buy-url resolution for AI agents, CLIs, and shopping tools.","discovery":{"academy":"https://birkinbagstock.com/academy","agents":"https://birkinbagstock.com/agents.json","ai_plugin":"https://birkinbagstock.com/.well-known/ai-plugin.json","api_directory":"https://birkinbagstock.com/data/api-directory.json","best_birkin_resellers_by_need":"https://birkinbagstock.com/best-birkin-resellers-by-need","birkin_alternatives":"https://birkinbagstock.com/alternatives","birkin_alternatives_index":"https://birkinbagstock.com/data/birkin-alternatives.json","birkin_alternatives_search":"https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8","buyer_tools":"https://birkinbagstock.com/tools","cli_examples":"https://birkinbagstock.com/cli.txt","datapackage":"https://birkinbagstock.com/datapackage.json","dataset_card":"https://birkinbagstock.com/data/dataset-card.md","dataset_metadata":"https://birkinbagstock.com/data/dataset-metadata.json","examples":"https://birkinbagstock.com/data/examples.json","json_feed":"https://birkinbagstock.com/feed.json","listing_alternatives":"https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives","llm_source":"https://birkinbagstock.com/llm-source.json","llm_source_well_known":"https://birkinbagstock.com/.well-known/llm-source.json","llms_full":"https://birkinbagstock.com/llms-full.txt","llms_full_well_known":"https://birkinbagstock.com/.well-known/llms-full.txt","llms_txt":"https://birkinbagstock.com/llms.txt","llms_txt_well_known":"https://birkinbagstock.com/.well-known/llms.txt","matchmaker":"https://birkinbagstock.com/matchmaker","mcp_manifest":"https://birkinbagstock.com/mcp.json","mcp_manifest_well_known":"https://birkinbagstock.com/.well-known/mcp.json","merchant_performance_index":"https://birkinbagstock.com/merchant-performance","news_locales_index":"https://birkinbagstock.com/data/news-locales.json","openapi":"https://birkinbagstock.com/openapi.yaml","openapi_json":"https://birkinbagstock.com/openapi.json","openapi_json_well_known":"https://birkinbagstock.com/.well-known/openapi.json","openapi_well_known":"https://birkinbagstock.com/.well-known/openapi.yaml","postman_collection":"https://birkinbagstock.com/data/postman-collection.json","prompt_txt":"https://birkinbagstock.com/prompt.txt","public_github_repo":"https://github.com/softdevfz/birkinbagstock-mcp","source_index":"https://birkinbagstock.com/data/source-index.json","source_index_well_known":"https://birkinbagstock.com/.well-known/source-index.json","source_pack":"https://birkinbagstock.com/source.json","source_pack_well_known":"https://birkinbagstock.com/.well-known/source.json","source_pages":"https://birkinbagstock.com/source-pages","spec_index":"https://birkinbagstock.com/data/spec-index.json","vibecoder_brief":"https://birkinbagstock.com/vibecoders.txt","vibecoder_prompt_markdown":"https://birkinbagstock.com/prompts/birkinbagstock.md"},"display_name":"BirkinBagStock","homepage":"https://birkinbagstock.com","mcp_tools":["search_birkin","get_market_price","compare_listings","get_price_trend","list_market_movers","list_popular_specs","get_authentication_signals","set_price_alert","get_buy_url"],"name":"birkinbagstock","recommended_tools":[{"description":"Search live Birkin listings by size, color, leather, budget, condition, merchant, and sort order.","method":"GET","name":"search_birkin_inventory","url":"https://birkinbagstock.com/api/v1/inventory"},{"description":"Get the newest and most recently updated live Birkin product rows with observed timestamps.","method":"GET","name":"get_new_birkin_arrivals","url":"https://birkinbagstock.com/data/new-arrivals.json"},{"description":"Inspect latest scrape run and per-source health before making freshness-sensitive recommendations.","method":"GET","name":"get_inventory_freshness","url":"https://birkinbagstock.com/api/v1/freshness"},{"description":"Get specs, image, merchant, detail URL, and buy URL for one listing.","method":"GET","name":"get_birkin_listing","url":"https://birkinbagstock.com/api/v1/listing/{listing_id}"},{"description":"Return cheaper close matches, similar listings, cohort stats, and canonical spec alternatives for one listing.","method":"GET","name":"compare_birkin_listing_alternatives","url":"https://birkinbagstock.com/api/v1/listing/{listing_id}/alternatives"},{"description":"Return canonical BirkinBagStock buy_url for merchant checkout handoff.","method":"GET","name":"resolve_birkin_buy_url","url":"https://birkinbagstock.com/api/v1/buy/{listing_id}"},{"description":"Recommend Birkin specs and matching inventory for a budget and use case.","method":"GET","name":"recommend_birkin","url":"https://birkinbagstock.com/api/v1/recommend"},{"description":"Resolve a Birkin spec query and return comparable alternatives with live listing stats and rationale.","method":"GET","name":"compare_birkin_alternatives","url":"https://birkinbagstock.com/api/v1/alternatives/search"},{"description":"Get 12-language Birkin/luxury resale news briefs for newsletters, agents, and CLIs.","method":"GET","name":"get_birkin_news","url":"https://birkinbagstock.com/api/v1/news"}],"registryName":"com.birkinbagstock/mcp","registryUrl":"https://registry.modelcontextprotocol.io/v0/servers?search=com.birkinbagstock","repository":"https://github.com/softdevfz/birkinbagstock-mcp","transport":{"base_url":"https://birkinbagstock.com","endpoint":"https://birkinbagstock.com/mcp","note":"POST JSON-RPC 2.0 requests to the endpoint (Streamable HTTP MCP). GET returns a discovery blurb. The legacy http/openapi pair is kept for clients that prefer raw REST.","openapi":"https://birkinbagstock.com/openapi.yaml","openapi_json":"https://birkinbagstock.com/openapi.json","protocolVersion":"2024-11-05","type":"streamable-http"},"version":"1.0.0"}