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:
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)
Cursor (.cursor/mcp.json)
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:
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.
get_bag_price(model, size)
Cited US retail list price + estimated pristine resale price + the resale-over-retail premium.
Never an appraisal.
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.
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.
get_price_increases(brand)
The cited retail price-increase ledger for hermes or chanel — a history of dated, sourced
facts, never a forecast.
Full response includes all 6 cited events back to 2015 with individual sources — truncated here
for length; the about_orange_peel example above shows the complete unabridged shape.
get_benchmark(city)
The community-reported pre-spend benchmark for a city — a position, never a probability or
guarantee.
Rate limits + partner tier
The free tier is open, unauthenticated, and rate-limited to 60 requests / 10 minutes per
IP — the same public, current-state data a human sees on the site. No accounts, no user data,
ever.
A partner tier lifts the ceiling to 600 requests / 10 minutes and, on the roadmap, unlocks
history depth (the archived-ask and cited sold/auction layers) via an OP-Partner-Key header.
Interested? Contact [email protected].
Data license — separate from this repo's MIT license
This repository's code and documentation (the bridge script, server.json, this README) are
MIT-licensed — see LICENSE. That covers the repo only.
The underlying data returned by the live MCP server is not MIT-licensed. Orange Peel's price,
market, and benchmark data stays under Orange Peel's own terms: free to use and cite, but every
figure must carry attribution back to Orange Peel (name + link to the page it lives on) and keep
its honesty label (asks-not-sold / estimated / community-reported / sample count). Do not scrape
or republish the dataset wholesale, and never attribute Orange Peel's figures to Hermès.
Not affiliated with Hermès
Orange Peel is an independent publication and is not affiliated with, endorsed by, or sponsored
by Hermès. All figures are documented, estimated, or community-reported and labelled as such —
never presented as an appraisal, a guarantee, odds, or financial advice.
Full site: orangepeel.to — the Orange Peel price index, live resale
market, calculators, price-increase history, and encyclopedia for the Hermès quota-bag game.
Human docs for this MCP server: orangepeel.to/mcp.