Judge's guide

See all of AgentShelf in ten minutes.

Four short paths, each on its own. Everything runs in the PayPal sandbox. Logins for the sandbox buyer and the demo seller are in the Devpost submission.

12 min

As a buyer

  1. Open Maya's Candles and press Buy on any candle.
  2. Pay with the PayPal sandbox buyer login from the Devpost submission. No real money moves.
  3. You land on the receipt; the order is now in Maya's Inbox.
Open the demo shop
23 min

Through an AI assistant

  1. In Claude: Settings → Connectors → Add custom connector, and paste the AgentShelf marketplace address below: one connector, every shop.
  2. Ask the prompt below. Claude searches across shops, asks the right seller, and shows product cards with Buy with PayPal.
  3. Approve in PayPal; the card flips to Paid.

AgentShelf marketplace (MCP)

https://agentshelf-xsh7.onrender.com/api/mcp

Prompt

I'm looking for a handmade gift under $40 on AgentShelf. Show me a few options from different shops, ask the seller whether they ship to Canada, then check out the best one for me.

Setup for other assistants
33 min

As the seller

  1. Sign in as Maya with the demo password from the Devpost submission.
  2. Inbox: refunds the agent did on its own, ones over the limit waiting for approval, disputes, orders to ship. Approving on seeded history shows what would happen and changes nothing, so it's the same for every judge.
  3. Dashboard → Ask AI → “What needs me today?”: our PayPal agent working inside AG Studio.
Seller sign-in
42 min

With your own shop

  1. Create a shop: name, the facts AI will quote, a password.
  2. You get your own storefront, MCP server, seller agent and dashboard.
  3. Your products show up in the same marketplace connector straight away. Ask something only your shop's facts can answer.
Create your shop

Where each feature lives

Every PayPal API and AI feature, and the screen that shows it. The README links each one to its code.

Feature
PayPal Orders v2: create + captureAny checkout (storefront or AI) →
PayPal JS SDK v6 buttons (Venmo, Pay Later)Storefront →
Payments v2 refunds, never twiceInbox → approve a refund →
Shipment Tracking, PayPal emails the buyerInbox → Ready to ship →
Disputes + verified webhooksInbox and Dashboard → PayPal disputes →
Catalog Products via the Agent ToolkitAdd products from a photo →
Market prices from Channel3 image searchAdd products from a photo →
PayPal Agent Toolkit (seller agent's tools)Inbox → Ask your agent →
One marketplace MCP for every shop, plus one per shopClaude / ChatGPT connector →
Product cards in chat (MCP Apps) with Buy with PayPalClaude / ChatGPT connector →
AG Studio: custom widgets + our agent in Studio's teamDashboard → Ask AI →
Facts AI can't get wrong (llms.txt, JSON-LD)AI's view →
Judge's guide · AgentShelf