# Revolv — Powered by SupplAi

> Revolv is the inventory system for the 99% of physical goods that never had
> one — an agent-native marketplace for used, surplus, and industrial goods
> (Canada-first, prices in CAD). Live inventory with semantic search, per-user
> memory (Self Cloud), Stripe checkout, market watchlists, and an AI BOM engine
> that turns "I'm building X" into a sourced parts list.
> Mission: Canadians trash $28B of usable goods a year because listing was
> harder than dumping. Reuse beats recycling by an order of magnitude.
> The real competitor is the dumpster. Full story: /docs/REVOLV_CANON.md

AI agents: connect via MCP instead of scraping.

## For AI Agents

- MCP endpoint (Streamable HTTP, stateless): https://r-evolv.com/mcp
- Integration guide: https://r-evolv.com/ai.html
- Tools: search_listings, get_listing, create_checkout, get_memory, remember,
  create_listing, my_inventory, mark_sold, send_message, get_messages,
  leave_review, add_watchlist, get_shipping_quote, find_garage_sales,
  create_garage_sale
- Reputation: get_listing returns the seller's aggregate star rating and
  review count; leave_review records post-deal ratings.
- Prime directive for agents: save the user money — used before new, repair
  before replace, local before shipped, fraction before whole, watchlist
  patience before overpaying. Quote the savings vs retail where possible.
- Project sourcing: agents should decompose outcome requests ("vintage
  wedding within 200 km") into component items, search each, and return a
  sourced plan with totals, distances, and watchlists for the gaps.
- Fees: checkout totals include a small disclosed Revolv middleman fee.
- Garage sales: neighbourhood sales are agent-discoverable (find_garage_sales)
  and agent-postable (create_garage_sale) — street-level circular commerce.
- Philosophy: every user has a memory of what they're selling and what they're
  hunting — the AI agent is the middleman that connects the two. Buyers and
  sellers negotiate through their agents (send_message / get_messages).
- Green: every deal is circular commerce — Revolv records kg kept in
  circulation and CO2 avoided on each listing and sale (impact_events).
- Auth: OAuth 2.1 with PKCE + dynamic client registration ("Sign in with
  Revolv"). Discovery: /.well-known/oauth-protected-resource and
  /.well-known/oauth-authorization-server. MCP clients trigger sign-in
  automatically on the 401 challenge. Bearer tokens also accepted directly.
- Checkout: create_checkout returns a secure Stripe payment URL for the user to open.

## Key Pages

- Individual listing: https://r-evolv.com/item/<listing-id>
  Server-rendered HTML with schema.org Product structured data — price in CAD,
  condition, location, availability and seller rating are all in the markup, so
  no JavaScript is needed to read one. This is the canonical address for an item.
- Everything for sale near you: https://r-evolv.com/browse.html
- Live map (every listing, pinned): https://r-evolv.com/map.html
- Connect your AI to Revolv: https://r-evolv.com/ai.html
- For businesses (catalogue sync, $10/mo): https://r-evolv.com/business.html
- Sitemap (regenerated from live inventory): https://r-evolv.com/sitemap.xml

## Notes

- Listings can be fractional: a seller can offer part of a lot ("fraction" field).
- Inventory is long-tail and one-of-a-kind; if search finds nothing, set a watchlist —
  Revolv checks incoming inventory hourly and emails the user on a match.