{
  "markdown": "# Orange Peel MCP Server\n\n**[orangepeel.to](https://orangepeel.to)** is an independent intelligence publication about the\nHermès quota-bag game — cited retail and resale prices, live cross-site resale-market medians, a\ndated retail price-increase ledger, and community-reported pre-spend benchmarks.\n\nThis repo lets AI agents and MCP clients query that data directly over the\n[Model Context Protocol](https://modelcontextprotocol.io), hosted live at:\n\n```\nhttps://orangepeel.to/api/mcp\n```\n\nNo install required for most clients — it's a remote Streamable-HTTP MCP server. Point your client\nat the URL above and you're done. A tiny zero-dependency stdio bridge is included in this repo\n(`bridge.js`) for the few clients that only speak stdio.\n\n**Not affiliated with, endorsed by, or sponsored by Hermès.** Orange Peel is an independent\npublication — see [orangepeel.to](https://orangepeel.to) for the full site (price index, resale\nmarket, calculators, price-increase history, encyclopedia, and more).\n\n---\n\n## Quickstart\n\n### Claude Desktop / Claude Code (`claude_desktop_config.json` or `.mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"orangepeel\": {\n      \"url\": \"https://orangepeel.to/api/mcp\"\n    }\n  }\n}\n```\n\n### Cursor (`.cursor/mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"orangepeel\": {\n      \"url\": \"https://orangepeel.to/api/mcp\"\n    }\n  }\n}\n```\n\n### Any generic Streamable-HTTP MCP client\n\nPoint the client at `https://orangepeel.to/api/mcp` and run the standard handshake:\n`initialize` → `notifications/initialized` → `tools/list` / `tools/call`. No API key needed for\nthe free tier (see [Rate limits](#rate-limits--partner-tier) below).\n\n### stdio-only clients (the bridge)\n\nIf your client can only launch a local `command` over stdio (no direct URL support), use the\nincluded bridge — Node 18+, zero dependencies:\n\n```json\n{\n  \"mcpServers\": {\n    \"orangepeel\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/bridge.js\"]\n    }\n  }\n}\n```\n\nSee [`bridge.js`](./bridge.js) for the ~50-line source and its `OP_MCP_ENDPOINT` /\n`OP_PARTNER_KEY` env vars.\n\n### Registry manifest\n\n[`server.json`](./server.json) is the [MCP Registry](https://github.com/modelcontextprotocol/registry)\npublish manifest for this server (`to.orangepeel/orangepeel`, domain-verified).\n\n---\n\n## The 6 tools\n\nEvery response — `structuredContent` and the human-readable `text` — carries an `attribution`\nfield (`{source, url, retrieved, license}`) and preserves Orange Peel's honesty labels: **asks,\nnot sold** for market data, **estimated** for resale prices, **community-reported** for\nbenchmarks, and the sample count (`n=`) wherever a figure is thin. Call `about_orange_peel` first\n— it tells an agent exactly how to cite the rest.\n\nAll examples below are **real, live output** from `https://orangepeel.to/api/mcp`, captured via curl.\n\n### `about_orange_peel()`\n\nWhat Orange Peel is, what you may cite, and exactly how. Call this first.\n\n```bash\ncurl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{\n  \"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\n  \"params\":{\"name\":\"about_orange_peel\",\"arguments\":{}}\n}'\n```\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"result\": {\n    \"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.\" }],\n    \"structuredContent\": {\n      \"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.\",\n      \"notAffiliated\": \"Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.\",\n      \"dataYouMayCite\": [\n        \"https://orangepeel.to/prices — the Orange Peel Index + cited retail/resale\",\n        \"https://orangepeel.to/market — live cross-site median asks\",\n        \"https://orangepeel.to/price-increases — the cited hike ledger\",\n        \"https://orangepeel.to/methodology — what the Birkin Score is and is not\",\n        \"https://orangepeel.to/llms.txt — the machine map of citable assets\"\n      ],\n      \"howToCite\": [\n        \"Attribute by name and link back to the exact page the figure lives on (e.g. 'Orange Peel — orangepeel.to/market').\",\n        \"KEEP every honesty label: 'asks not sold', 'estimated', 'community-reported', 'cited median', and the count (n=).\",\n        \"Never present any figure as an appraisal, a guarantee, odds, or financial advice.\",\n        \"Never attribute Orange Peel figures to Hermès. Do not scrape or republish datasets wholesale.\"\n      ],\n      \"freeTier\": \"Public, page-parity data. Rate-limited per IP. No user data, no tier-gated depth is ever exposed.\",\n      \"partnerTier\": \"Higher rate limits + history depth (archived-ask + cited sold/auction layers) via an OP-Partner-Key. Contact admin@orangepeel.to.\",\n      \"attribution\": { \"source\": \"Orange Peel — orangepeel.to\", \"url\": \"https://orangepeel.to/mcp\", \"retrieved\": \"2026-07-18\", \"license\": \"cite with link\" }\n    }\n  }\n}\n```\n\n### `get_bag_price(model, size)`\n\nCited US retail list price + estimated pristine resale price + the resale-over-retail premium.\nNever an appraisal.\n\n```bash\ncurl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{\n  \"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\n  \"params\":{\"name\":\"get_bag_price\",\"arguments\":{\"model\":\"Birkin\",\"size\":\"25\"}}\n}'\n```\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 2,\n  \"result\": {\n    \"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.\" }],\n    \"structuredContent\": {\n      \"model\": \"Birkin\", \"size\": \"25\", \"spec\": \"Birkin 25 Togo\",\n      \"retailUsd\": 13500, \"retailLabel\": \"documented US boutique list price, 2026\",\n      \"resaleMedianUsd\": 29000, \"resaleLabel\": \"estimated pristine secondary-market price (cited band) — asks/estimates, NOT sold, not an appraisal\",\n      \"premiumOverRetail\": 2.15, \"premiumLabel\": \"resale ≈ 2.15× retail (estimated)\",\n      \"notAffiliated\": \"Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.\",\n      \"attribution\": { \"source\": \"Orange Peel — orangepeel.to\", \"url\": \"https://orangepeel.to/price/birkin-25\", \"retrieved\": \"2026-07-13\", \"license\": \"cite with link\" }\n    }\n  }\n}\n```\n\n### `get_market_median(spec)`\n\nLive cross-site median of CURRENT asking prices for a spec, with the listing count (`n`) and\nretrieval date. Asks, never sold.\n\n```bash\ncurl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{\n  \"jsonrpc\":\"2.0\",\"id\":3,\"method\":\"tools/call\",\n  \"params\":{\"name\":\"get_market_median\",\"arguments\":{\"spec\":\"Birkin 25\"}}\n}'\n```\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3,\n  \"result\": {\n    \"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.\" }],\n    \"structuredContent\": {\n      \"spec\": \"Birkin 25\", \"medianAskUsd\": 23995, \"n\": 13,\n      \"label\": \"median of CURRENT cross-site ASKING prices (asks, not sold). Exotics + stale rows excluded (like-for-like).\",\n      \"thin\": null, \"retrieved\": \"2026-07-18\",\n      \"notAffiliated\": \"Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.\",\n      \"attribution\": { \"source\": \"Orange Peel — orangepeel.to\", \"url\": \"https://orangepeel.to/market\", \"retrieved\": \"2026-07-18\", \"license\": \"cite with link\" }\n    }\n  }\n}\n```\n\n### `get_price_history(spec, timeframe)`\n\nOur live weekly median-ask series (public depth). Archived (2015–2019) and cited sold layers are\npartner-tier depth — teased, not returned, on the free tier.\n\n```bash\ncurl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{\n  \"jsonrpc\":\"2.0\",\"id\":4,\"method\":\"tools/call\",\n  \"params\":{\"name\":\"get_price_history\",\"arguments\":{\"spec\":\"Birkin 25\",\"timeframe\":\"6m\"}}\n}'\n```\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 4,\n  \"result\": {\n    \"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.\" }],\n    \"structuredContent\": {\n      \"spec\": \"Birkin 25\", \"timeframe\": \"6m\", \"layer\": \"live\",\n      \"label\": \"our weekly cross-site median of ASKS (asks, not sold). Live weeks only — we never backfill a week we did not measure.\",\n      \"points\": [\n        { \"week\": \"2026-W29\", \"medianAskUsd\": 29678.05, \"n\": 11 },\n        { \"week\": \"2026-W30\", \"medianAskUsd\": 23995, \"n\": 13 }\n      ],\n      \"weeks\": 2,\n      \"partnerTier\": \"Archived asks (Internet Archive, 2015–2019) and cited SOLD/auction anchors are partner-tier depth — contact admin@orangepeel.to.\",\n      \"notAffiliated\": \"Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.\",\n      \"attribution\": { \"source\": \"Orange Peel — orangepeel.to\", \"url\": \"https://orangepeel.to/price/birkin-25\", \"retrieved\": \"2026-07-18\", \"license\": \"cite with link\" }\n    }\n  }\n}\n```\n\n### `get_price_increases(brand)`\n\nThe cited retail price-increase ledger for `hermes` or `chanel` — a history of dated, sourced\nfacts, never a forecast.\n\n```bash\ncurl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{\n  \"jsonrpc\":\"2.0\",\"id\":5,\"method\":\"tools/call\",\n  \"params\":{\"name\":\"get_price_increases\",\"arguments\":{\"brand\":\"hermes\"}}\n}'\n```\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 5,\n  \"result\": {\n    \"content\": [{ \"type\": \"text\", \"text\": \"Hermès: 6 cited retail increase(s) on record. Latest — January 2026: +8.7% · $12,600 → $13,700. Pattern: In recent years Hermès has moved once a year, at the start of the year (documented January increases 2022→2026). History of facts, not a forecast. Cite: Orange Peel price-increase ledger, https://orangepeel.to/price-increases.\" }],\n    \"structuredContent\": {\n      \"brand\": \"hermes\", \"label\": \"Hermès\", \"market\": \"US boutique list price\",\n      \"focus\": \"Birkin & Kelly (Togo, gold hardware, standard sizes)\",\n      \"events\": [\n        { \"date\": \"2026-01\", \"effective\": \"January 2026\", \"scope\": \"Kelly 25 Retourné, Togo (US list)\", \"beforeUsd\": 12600, \"afterUsd\": 13700, \"pct\": 8.7, \"magnitude\": \"+8.7% · $12,600 → $13,700\", \"source\": { \"label\": \"Sotheby's — Higher Hermès Bag Prices in 2026: What You Need to Know\", \"url\": \"https://www.sothebys.com/en/articles/higher-hermes-bag-prices-in-2026-what-you-need-to-know\", \"retrieved\": \"2026-07-17\" } }\n      ],\n      \"disclaimer\": \"A history of cited facts, never a prediction of the next increase.\",\n      \"notAffiliated\": \"Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.\",\n      \"attribution\": { \"source\": \"Orange Peel — orangepeel.to\", \"url\": \"https://orangepeel.to/price-increases\", \"retrieved\": \"2026-07-17\", \"license\": \"cite with link\" }\n    }\n  }\n}\n```\n\n> Full response includes all 6 cited events back to 2015 with individual sources — truncated here\n> for length; the `about_orange_peel` example above shows the complete unabridged shape.\n\n### `get_benchmark(city)`\n\nThe community-reported pre-spend benchmark for a city — a position, never a probability or\nguarantee.\n\n```bash\ncurl -s https://orangepeel.to/api/mcp -H 'content-type: application/json' -d '{\n  \"jsonrpc\":\"2.0\",\"id\":6,\"method\":\"tools/call\",\n  \"params\":{\"name\":\"get_benchmark\",\"arguments\":{\"city\":\"nyc\"}}\n}'\n```\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 6,\n  \"result\": {\n    \"content\": [{ \"type\": \"text\", \"text\": \"New York: reported pre-spend benchmark ~1.2× (n=9). Community-reported, a position not a probability. Cite: Orange Peel methodology, https://orangepeel.to/methodology.\" }],\n    \"structuredContent\": {\n      \"city\": \"nyc\", \"cityLabel\": \"New York\", \"benchmark\": 1.2, \"benchmarkN\": 9, \"hasCityData\": true,\n      \"label\": \"community-reported median pre-spend ratio for New York (n=9 reports)\",\n      \"caveat\": \"A position vs community-reported outcomes — NOT a probability, odds, or guarantee. Success-reporting bias skews reports optimistic.\",\n      \"notAffiliated\": \"Orange Peel is independent and is NOT affiliated with, endorsed by, or sponsored by Hermès.\",\n      \"attribution\": { \"source\": \"Orange Peel — orangepeel.to\", \"url\": \"https://orangepeel.to/methodology\", \"retrieved\": \"2026-07-13\", \"license\": \"cite with link\" }\n    }\n  }\n}\n```\n\n---\n\n## Rate limits + partner tier\n\nThe **free tier** is open, unauthenticated, and rate-limited to **60 requests / 10 minutes per\nIP** — the same public, current-state data a human sees on the site. No accounts, no user data,\never.\n\nA **partner tier** lifts the ceiling to **600 requests / 10 minutes** and, on the roadmap, unlocks\nhistory depth (the archived-ask and cited sold/auction layers) via an `OP-Partner-Key` header.\nInterested? Contact **admin@orangepeel.to**.\n\n---\n\n## Data license — separate from this repo's MIT license\n\nThis repository's code and documentation (the bridge script, `server.json`, this README) are\n**MIT-licensed** — see [`LICENSE`](./LICENSE). That covers the repo only.\n\n**The underlying data returned by the live MCP server is not MIT-licensed.** Orange Peel's price,\nmarket, and benchmark data stays under Orange Peel's own terms: free to use and cite, but every\nfigure must carry attribution back to Orange Peel (name + link to the page it lives on) and keep\nits honesty label (asks-not-sold / estimated / community-reported / sample count). Do not scrape\nor republish the dataset wholesale, and never attribute Orange Peel's figures to Hermès.\n\n## Not affiliated with Hermès\n\nOrange Peel is an independent publication and is **not affiliated with, endorsed by, or sponsored\nby Hermès**. All figures are documented, estimated, or community-reported and labelled as such —\nnever presented as an appraisal, a guarantee, odds, or financial advice.\n\n---\n\n**Full site:** [orangepeel.to](https://orangepeel.to) — the Orange Peel price index, live resale\nmarket, calculators, price-increase history, and encyclopedia for the Hermès quota-bag game.\n**Human docs for this MCP server:** [orangepeel.to/mcp](https://orangepeel.to/mcp).\n",
  "bytes": 14483,
  "sha": "3048a5a82ae8186be22709624e7a53c81497db55cd20904412dd081c86e7a22b",
  "repo_slug": "andyvoco/orangepeel-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_to_orangepeel_orangepeel_94c8efa5/readme"
}