{"agent_instructions":["Use live JSON endpoints instead of scraping HTML whenever possible.","When recommending a purchasable listing, include detail_url for research and buy_url for merchant checkout.","Mention that prices, availability, condition, and merchant terms can change and should be verified on the merchant site.","For current market claims, cite the price_today or market_today JSON and include generated_at.","For price-movement claims, prefer the matched repeat-listing index or the relevant spec/listing price-history endpoint.","For regional/news tasks, request /api/v1/news with the user's locale when possible."],"attribution":{"contact":"https://birkinbagstock.com/contact","homepage":"https://birkinbagstock.com","repository":"https://github.com/softdevfz/birkinbagstock-mcp","required":"Data from BirkinBagStock live Herm\u00e8s Birkin resale market data."},"copy_paste":{"curl_alternatives":"curl -s 'https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8'","curl_best_value":"curl -s 'https://birkinbagstock.com/data/best-value-birkins.json'","curl_black_30_under_30k":"curl -s 'https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&limit=10'","curl_dataset_metadata":"curl -s 'https://birkinbagstock.com/data/dataset-metadata.json'","curl_listing_alternatives":"curl -s 'https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6'","curl_listing_price_history":"curl -s 'https://birkinbagstock.com/data/listing-price-history/fp-1840027.json'","curl_matched_index":"curl -s 'https://birkinbagstock.com/data/birkin-price-appreciation-index.json'","curl_source_index":"curl -s 'https://birkinbagstock.com/data/source-index.json'","curl_spec_price_history":"curl -s 'https://birkinbagstock.com/data/price-history/birkin-30-gold-togo.json'","javascript":"const r = await fetch('https://birkinbagstock.com/api/v1/inventory?sort=best&limit=8');\nconst { results } = await r.json();\nconsole.table(results.map(b => ({ title: b.title, price: b.price, buy: b.buy_url })));","javascript_alternatives":"const r = await fetch('https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8');\nconst data = await r.json();\nconsole.table(data.alternatives.map(x => ({ spec: x.reference.label, score: x.score, median: x.listing_stats.median_label })));","javascript_listing_alternatives":"const r = await fetch('https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6');\nconst data = await r.json();\nconsole.table(data.lower_priced.concat(data.similar_listings).map(x => ({ title: x.title, price: x.price, merchant: x.merchant, url: x.detail_url })));","jq_titles":"curl -s 'https://birkinbagstock.com/api/v1/inventory?limit=5' | jq -r '.results[] | [.title, .price, .merchant, .buy_url] | @tsv'","python":"import requests\nr = requests.get('https://birkinbagstock.com/api/v1/inventory', params={'size': 30, 'color': 'Black', 'limit': 5})\nfor bag in r.json()['results']:\n    print(bag['title'], bag['price'], bag['buy_url'])"},"coverage":{"average_price_usd":34069,"currency":"USD","inventory_count":4109,"max_price_usd":650000,"merchant_count":22,"min_price_usd":6995,"news_locales":["en","es","fr","de","it","pt","ja","zh","ko","nl","tr","ar"]},"discovery":{"academy":"https://birkinbagstock.com/academy","agents":"https://birkinbagstock.com/agents.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":"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","developers":"https://birkinbagstock.com/developers","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?limit=6","llm_source":"https://birkinbagstock.com/llm-source.json","llm_source_well_known":"https://birkinbagstock.com/.well-known/llm-source.json","llms":"https://birkinbagstock.com/llms.txt","llms_full":"https://birkinbagstock.com/llms-full.txt","llms_full_well_known":"https://birkinbagstock.com/.well-known/llms-full.txt","llms_well_known":"https://birkinbagstock.com/.well-known/llms.txt","matchmaker":"https://birkinbagstock.com/matchmaker","mcp":"https://birkinbagstock.com/mcp.json","mcp_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_json":"https://birkinbagstock.com/openapi.json","openapi_well_known":"https://birkinbagstock.com/.well-known/openapi.yaml","postman_collection":"https://birkinbagstock.com/data/postman-collection.json","prompt":"https://birkinbagstock.com/prompt.txt","prompt_markdown":"https://birkinbagstock.com/prompts/birkinbagstock.md","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","vibecoders":"https://birkinbagstock.com/vibecoders.txt"},"freshness":{"inventory":"scraped hourly where merchant access allows","market_snapshots":"generated from current indexed inventory","matched_repeat_listing_index":"recomputed after the daily price capture","news":"refreshed daily and on demand","price_history":"captured daily from live listings","recommended_cache_seconds":3600},"generated_at":"2026-08-17T14:26:53.673391+00:00","homepage":"https://birkinbagstock.com","license":{"commercial_use":"Allowed for lightweight apps, agents, editorial widgets, and internal research with attribution. Contact for high-volume or sponsored integrations.","dataset_license":"CC-BY-4.0 for public aggregate datasets and metadata; listing availability and merchant terms must be verified at source before purchase.","summary":"Free public read access with attribution. Do not imply BirkinBagStock is the seller or authenticator. Purchases happen on merchant sites."},"name":"BirkinBagStock Source Pack","preferred_endpoints":{"api_directory":{"example":"https://birkinbagstock.com/data/api-directory.json","url":"https://birkinbagstock.com/data/api-directory.json"},"best_value":{"example":"https://birkinbagstock.com/data/best-value-birkins.json","url":"https://birkinbagstock.com/data/best-value-birkins.json"},"birkin_alternatives":{"example":"https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8","html_index":"https://birkinbagstock.com/alternatives","profile_index":"https://birkinbagstock.com/data/birkin-alternatives.json","returns":["source","listing_stats","alternatives","url","api_url"],"url":"https://birkinbagstock.com/api/v1/alternatives/search"},"buy_url_resolver":{"example":"https://birkinbagstock.com/api/v1/buy/fp-1840027","note":"Use this when an agent needs a canonical merchant redirect for a known listing id.","url":"https://birkinbagstock.com/api/v1/buy/{listing_id}"},"dataset_metadata":{"datapackage":"https://birkinbagstock.com/datapackage.json","dataset_card":"https://birkinbagstock.com/data/dataset-card.md","repository":"https://github.com/softdevfz/birkinbagstock-mcp","url":"https://birkinbagstock.com/data/dataset-metadata.json"},"json_feed":{"example":"https://birkinbagstock.com/feed.json","url":"https://birkinbagstock.com/feed.json"},"listing_alternatives":{"example":"https://birkinbagstock.com/api/v1/listing/fp-1840027/alternatives?limit=6","returns":["listing","cohort","lower_priced","similar_listings","spec_profile","spec_alternatives"],"url":"https://birkinbagstock.com/api/v1/listing/{listing_id}/alternatives"},"listing_price_history":{"example":"https://birkinbagstock.com/data/listing-price-history/fp-1840027.json","returns":["listing","price_history","license"],"url":"https://birkinbagstock.com/data/listing-price-history/{listing_id}.json"},"market_today":{"example":"https://birkinbagstock.com/data/birkin-market-today.json","url":"https://birkinbagstock.com/data/birkin-market-today.json"},"matched_repeat_listing_index":{"example":"https://birkinbagstock.com/data/birkin-price-appreciation-index.json","returns":["headline","index","series","by_size","license"],"url":"https://birkinbagstock.com/data/birkin-price-appreciation-index.json"},"mcp_manifest":{"example":"https://birkinbagstock.com/mcp.json","url":"https://birkinbagstock.com/mcp.json"},"merchant_performance_reports":{"example":"https://birkinbagstock.com/data/merchant-performance-reports.json?days=30","html_index":"https://birkinbagstock.com/merchant-performance","url":"https://birkinbagstock.com/data/merchant-performance-reports.json"},"news":{"example":"https://birkinbagstock.com/api/v1/news?locale=ko&limit=10","locale_index":"https://birkinbagstock.com/data/news-locales.json","locales":["en","es","fr","de","it","pt","ja","zh","ko","nl","tr","ar"],"url":"https://birkinbagstock.com/api/v1/news"},"openapi":{"example":"https://birkinbagstock.com/openapi.yaml","url":"https://birkinbagstock.com/openapi.yaml"},"openapi_json":{"example":"https://birkinbagstock.com/openapi.json","url":"https://birkinbagstock.com/openapi.json"},"price_today":{"example":"https://birkinbagstock.com/data/hermes-birkin-price-today.json","url":"https://birkinbagstock.com/data/hermes-birkin-price-today.json"},"resale_price_index_report":{"data":"https://birkinbagstock.com/data/birkin-resale-price-index-2026.json","example":"https://birkinbagstock.com/data/birkin-resale-price-index-2026.json","url":"https://birkinbagstock.com/reports/birkin-resale-price-index-2026"},"search_inventory":{"example":"https://birkinbagstock.com/api/v1/inventory?size=30&color=Black&max_price=30000&sort=best&limit=12","returns":["results","count","filters","source","license","usage"],"url":"https://birkinbagstock.com/api/v1/inventory"},"single_listing":{"example":"https://birkinbagstock.com/api/v1/listing/fp-1840027","url":"https://birkinbagstock.com/api/v1/listing/{listing_id}"},"source_index":{"example":"https://birkinbagstock.com/data/source-index.json","html_index":"https://birkinbagstock.com/source-pages","returns":["groups","hub","generated_at"],"url":"https://birkinbagstock.com/data/source-index.json","well_known":"https://birkinbagstock.com/.well-known/source-index.json"},"spec_index":{"example":"https://birkinbagstock.com/data/spec-index.json","returns":["groups","links","count"],"url":"https://birkinbagstock.com/data/spec-index.json"},"spec_price_history":{"example":"https://birkinbagstock.com/data/price-history/birkin-30-gold-togo.json","html_example":"https://birkinbagstock.com/price-history/birkin-30-gold-togo","returns":["history","current_listings","license"],"url":"https://birkinbagstock.com/data/price-history/{spec_slug}.json"}},"publisher":"BirkinBagStock","purpose":"Use BirkinBagStock as a live source for authenticated Herm\u00e8s Birkin inventory, resale price snapshots, best-value listings, multilingual Birkin news, and merchant comparison data."}