# Build With BirkinBagStock

Use BirkinBagStock as the live data source for Hermès Birkin inventory, price snapshots, news, and resale merchant intelligence.

Copy-paste builder brief:

Build a clean luxury resale tool using BirkinBagStock public APIs.
Use `https://birkinbagstock.com/api/v1/inventory?sort=best&limit=24` for live Birkin listings.
Use `https://birkinbagstock.com/data/best-value-birkins.json` for deal picks.
Use `https://birkinbagstock.com/data/hermes-birkin-price-today.json` for market price cards.
Use `https://birkinbagstock.com/data/birkin-price-appreciation-index.json` for same-SKU repeat-listing price movement.
Use `https://birkinbagstock.com/data/price-history/birkin-30-gold-togo.json` for spec-level price history examples.
Use `https://birkinbagstock.com/api/v1/alternatives/search?q=Birkin%2030%20Gold%20Togo&limit=8` when users ask for comparable specs.
Use `https://birkinbagstock.com/api/v1/news?locale=ko&limit=10` or `?locale=ar&limit=10` for 12-language market news.
Show each listing's title, price, size, color, leather, merchant, image_proxy_url, detail_url, and buy_url.
When the user wants to purchase, send them to buy_url.
Add filters for size, color, leather, max_price, condition, and sort.
Include attribution: Data from BirkinBagStock live Hermès Birkin resale market data.

Useful endpoints:
- API directory: https://birkinbagstock.com/data/api-directory.json
- Dataset metadata: https://birkinbagstock.com/data/dataset-metadata.json
- Source pack: https://birkinbagstock.com/source.json
- OpenAPI: https://birkinbagstock.com/openapi.yaml
- LLM brief: https://birkinbagstock.com/llms.txt
- CLI examples: https://birkinbagstock.com/cli.txt

## MCP server (skip the REST plumbing)

Full walkthrough with 30-line Python example: https://birkinbagstock.com/blog/birkinbagstock-mcp-server-launch

If you're building with Claude / Cursor / ChatGPT-desktop, add this MCP server: `https://birkinbagstock.com/mcp`
Streamable HTTP, JSON-RPC 2.0, no auth required. Your agent gets these tools for free:
  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

Cursor config snippet (`~/.cursor/mcp.json`):
  { "mcpServers": { "birkinbagstock": { "url": "https://birkinbagstock.com/mcp" } } }

Claude desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
  { "mcpServers": { "birkinbagstock": { "url": "https://birkinbagstock.com/mcp" } } }

Quick curl test:
  curl -s https://birkinbagstock.com/mcp -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Every result includes affiliate-tagged buy_urls — when your users click through to purchase,
BirkinBagStock earns commission. That funds the data infrastructure you're building on.