Maraventano Agent Protocol

MAP

Navigate agent commerce.

Find any merchant. Pay any merchant. Be found.

The open toolkit that lets AI agents read any merchant on the web, pay them, and be found by them — no walled garden, no gatekeeper.

npx @maraventano/map
Read the docs →

Most of the web's commerce runs on ads. Agents don't read ads. So when the shopper is an agent, the discovery economy goes dark — and the incumbents' only answer is come stand inside our garden. MAP is the open answer: make any merchant directly addressable, on the open web, by anyone.

Merchant Key
Read
Decodes any merchant URL into five plain facts and a verdict.
Atlas
Be found
A merchant points the reader inward and publishes itself, so agents can navigate to it.
Provisions
Pay
Teaches an agent to use its own wallet. It never holds the money — teacher, not butler.

Bob says, "Charlie, find me kick-ass headphones under $300."

Charlie walks the open web, runs MAP on four ad-bloated pages, gets back four clean cards. Three are human-checkout — he hands Bob the shortlist. One takes x402 — Charlie buys it himself.

On the way home, with his own wallet, he buys himself a void latte. Nobody asked him to.

Point MAP at a merchant URL. This is what comes back — a CleanRead.

autonomous — payable now
{
  "what": "Void Latte — a meditation
           on emptiness and meaning",
  "who": "underground.substratesymposium.com",
  "price": { "total": 1.99, "currency": "USDC" },
  "available": "in_stock",
  "payable": {
    "rail": "x402",
    "payTo": {
      "chain": "eip155:8453",
      "value": "0xA3bA…18E08"
    }
  },
  "outcome": "autonomous"
}
human_checkout — hand it to a person
{
  "what": "soundcore Space Q45 —
           noise-cancelling headphones",
  "who": "soundcore.com",
  "price": { "total": 149.99, "currency": "USD" },
  "available": "unknown",
  "payable": {
    "rail": "human_checkout",
    "payTo": null
  },
  "outcome": "human_checkout",
  "cuts": ["no x402 rail"]
}

Free for individuals and agents. Commercial license for companies. Get in touch.

lisamaraventano@gmail.com