Orange Peel MCP Server
orangepeel.to is an independent intelligence publication about the
Hermès quota-bag game — cited retail and resale prices, live cross-site resale-market medians, a
dated retail price-increase ledger, and community-reported pre-spend benchmarks.
This repo lets AI agents and MCP clients query that data directly over the
Model Context Protocol, hosted live at:
https://orangepeel.to/api/mcp
No install required for most clients — it's a remote Streamable-HTTP MCP server. Point your client
at the URL above and you're done. A tiny zero-dependency stdio bridge is included in this repo
(bridge.js) for the few clients that only speak stdio.
Not affiliated with, endorsed by, or sponsored by Hermès. Orange Peel is an independent
publication — see orangepeel.to for the full site (price index, resale
market, calculators, price-increase history, encyclopedia, and more).
Quickstart
Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json)
{
"mcpServers": {
"orangepeel": {
"url": "https://orangepeel.to/api/mcp"
}
}
}
Cursor (.cursor/mcp.json)
{
"mcpServers": {
"orangepeel": {
"url": "https://orangepeel.to/api/mcp"
}
}
}
Any generic Streamable-HTTP MCP client
Point the client at https://orangepeel.to/api/mcp and run the standard handshake:
initialize → notifications/initialized → tools/list / tools/call. No API key needed for
the free tier (see Rate limits below).
stdio-only clients (the bridge)
If your client can only launch a local command over stdio (no direct URL support), use the
included bridge — Node 18+, zero dependencies:
{
"mcpServers": {
"orangepeel": {
"command": "node",
"args": ["/path/to/bridge.js"]
}
}
}
See bridge.js for the ~50-line source and its OP_MCP_ENDPOINT /
OP_PARTNER_KEY env vars.
Registry manifest
server.json is the MCP Registry
publish manifest for this server (to.orangepeel/orangepeel, domain-verified).
The 6 tools
Every response — structuredContent and the human-readable text — carries an attribution
field ({source, url, retrieved, license}) and preserves Orange Peel's honesty labels: asks,
not sold for market data, estimated for resale prices, community-reported for
benchmarks, and the sample count (n=) wherever a figure is thin. Call about_orange_peel first
— it tells an agent exactly how to cite the rest.
All examples below are real, live output from https://orangepeel.to/api/mcp, captured via curl.
about_orange_peel()
What Orange Peel is, what you may cite, and exactly how. Call this first.
curl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"about_orange_peel","arguments":{}}
}'
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [{ "type": "text", "text": "Orange Peel — independent Hermès quota-bag intelligence (NOT affiliated with Hermès). Tools: get_bag_price, get_market_median, get_price_history, get_price_increases, get_benchmark, about_orange_peel. Cite by name + link, keep every honesty label ('asks not sold', 'estimated', 'community-reported', n=). Details + partner tier: https://orangepeel.to/mcp." }],
"structuredContent": {
"what": "Orange Peel (orangepeel.to) is an independent intelligence publication about the Hermès quota-bag game — sourced, dated, plainly-labelled answers, tools and price data.",
"notAffiliated": "Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.",
"dataYouMayCite": [
"https://orangepeel.to/prices — the Orange Peel Index + cited retail/resale",
"https://orangepeel.to/market — live cross-site median asks",
"https://orangepeel.to/price-increases — the cited hike ledger",
"https://orangepeel.to/methodology — what the Birkin Score is and is not",
"https://orangepeel.to/llms.txt — the machine map of citable assets"
],
"howToCite": [
"Attribute by name and link back to the exact page the figure lives on (e.g. 'Orange Peel — orangepeel.to/market').",
"KEEP every honesty label: 'asks not sold', 'estimated', 'community-reported', 'cited median', and the count (n=).",
"Never present any figure as an appraisal, a guarantee, odds, or financial advice.",
"Never attribute Orange Peel figures to Hermès. Do not scrape or republish datasets wholesale."
],
"freeTier": "Public, page-parity data. Rate-limited per IP. No user data, no tier-gated depth is ever exposed.",
"partnerTier": "Higher rate limits + history depth (archived-ask + cited sold/auction layers) via an OP-Partner-Key. Contact admin@orangepeel.to.",
"attribution": { "source": "Orange Peel — orangepeel.to", "url": "https://orangepeel.to/mcp", "retrieved": "2026-07-18", "license": "cite with link" }
}
}
}
get_bag_price(model, size)
Cited US retail list price + estimated pristine resale price + the resale-over-retail premium.
Never an appraisal.
curl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"get_bag_price","arguments":{"model":"Birkin","size":"25"}}
}'
{
"jsonrpc": "2.0",
"id": 2,
"result": {
"content": [{ "type": "text", "text": "Birkin 25 Togo: retail ~$13,500 (US list, 2026); estimated resale ~$29,000 (cited band, asks/estimates not sold) — ≈2.15× retail. Not an appraisal. Cite: Orange Peel, https://orangepeel.to/price/birkin-25." }],
"structuredContent": {
"model": "Birkin", "size": "25", "spec": "Birkin 25 Togo",
"retailUsd": 13500, "retailLabel": "documented US boutique list price, 2026",
"resaleMedianUsd": 29000, "resaleLabel": "estimated pristine secondary-market price (cited band) — asks/estimates, NOT sold, not an appraisal",
"premiumOverRetail": 2.15, "premiumLabel": "resale ≈ 2.15× retail (estimated)",
"notAffiliated": "Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.",
"attribution": { "source": "Orange Peel — orangepeel.to", "url": "https://orangepeel.to/price/birkin-25", "retrieved": "2026-07-13", "license": "cite with link" }
}
}
}
get_market_median(spec)
Live cross-site median of CURRENT asking prices for a spec, with the listing count (n) and
retrieval date. Asks, never sold.
curl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":3,"method":"tools/call",
"params":{"name":"get_market_median","arguments":{"spec":"Birkin 25"}}
}'
{
"jsonrpc": "2.0",
"id": 3,
"result": {
"content": [{ "type": "text", "text": "Birkin 25: median asking ~$23,995 across n=13 live listings (asks, not sold), retrieved 2026-07-18. Cite: Orange Peel resale market, https://orangepeel.to/market." }],
"structuredContent": {
"spec": "Birkin 25", "medianAskUsd": 23995, "n": 13,
"label": "median of CURRENT cross-site ASKING prices (asks, not sold). Exotics + stale rows excluded (like-for-like).",
"thin": null, "retrieved": "2026-07-18",
"notAffiliated": "Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.",
"attribution": { "source": "Orange Peel — orangepeel.to", "url": "https://orangepeel.to/market", "retrieved": "2026-07-18", "license": "cite with link" }
}
}
}
get_price_history(spec, timeframe)
Our live weekly median-ask series (public depth). Archived (2015–2019) and cited sold layers are
partner-tier depth — teased, not returned, on the free tier.
curl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":4,"method":"tools/call",
"params":{"name":"get_price_history","arguments":{"spec":"Birkin 25","timeframe":"6m"}}
}'
{
"jsonrpc": "2.0",
"id": 4,
"result": {
"content": [{ "type": "text", "text": "Birkin 25: 2 weekly median-ask point(s) in 6m (asks, not sold), latest ~$23,995. Archived + sold layers are partner-tier. Cite: Orange Peel, https://orangepeel.to/price/birkin-25." }],
"structuredContent": {
"spec": "Birkin 25", "timeframe": "6m", "layer": "live",
"label": "our weekly cross-site median of ASKS (asks, not sold). Live weeks only — we never backfill a week we did not measure.",
"points": [
{ "week": "2026-W29", "medianAskUsd": 29678.05, "n": 11 },
{ "week": "2026-W30", "medianAskUsd": 23995, "n": 13 }
],
"weeks": 2,
"partnerTier": "Archived asks (Internet Archive, 2015–2019) and cited SOLD/auction anchors are partner-tier depth — contact admin@orangepeel.to.",
"notAffiliated": "Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.",
"attribution": { "source": "Orange Peel — orangepeel.to", "url": "https://orangepeel.to/price/birkin-25", "retrieved": "2026-07-18", "license": "cite with link" }
}
}
}
get_price_increases(brand)
The cited retail price-increase ledger for hermes or chanel — a history of dated, sourced
facts, never a forecast.
curl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{
"jsonrpc":"2.0","id":5,"method":"tools/call",
"params":{"name":"get_price_increases","arguments":{"brand":"hermes"}}
}'