Skip to main content
Glama

AgentStall

Working name. Make social-only sellers buyable by any AI shopping agent, paid through PayPal.

AgentStall turns a seller's product photos and captions into a store that any AI shopping agent can find, question and pay through PayPal. A seller dashboard shows what agents asked and why they didn't buy, and one answer from the seller teaches every future agent.

Status: early build. Without sandbox credentials the app runs on a mock PayPal gateway (see docs/BUILD-WITHOUT-CREDENTIALS.md).

Repository layout

Path

What it is

packages/paypal

PayPalGateway (sandbox + mock), Orders v2, webhook verification, agent attribution on custom_id

apps/api

Hono service: public MCP endpoint /mcp for buyer agents (search_products, get_product, ask_seller, create_checkout, get_order_status), verified POST /webhooks/paypal, checkout return, seller read API

apps/web

Next.js app: seller wizard with Instagram import (/sell), chat-style shopping assistant (/shop), seller dashboard (/stall). A "Behind the scenes" switch shows every MCP, AI, PayPal and webhook step live

demo-photos

Openly licensed demo product photos and captions (credits)

scripts/day1

Sandbox verification checks (see docs/DAY1.md)

Related MCP server: Agent Payment Firewall

Quickstart

Requires Node 20+.

npm install
cp .env.example .env   # add GEMINI_API_KEY (free at aistudio.google.com); PayPal credentials optional, mock mode without them
npm test
npm run dev:api        # API + MCP endpoint on http://localhost:8787
npm run dev:web        # web app on http://localhost:3000 (second terminal)
npm run day1           # PayPal sandbox checks, once credentials are in .env

Connect your own agent

Any MCP-capable AI tool can shop a stall: see docs/CONNECT-AN-AGENT.md.

PayPal surfaces

Surface

Used for

Orders v2 (create, capture, direct-card)

Agent checkout; buying agent recorded in custom_id

Webhooks + verify-webhook-signature

Live order confirmation

Agent Toolkit (@paypal/agent-toolkit)

Catalog products, shipment tracking, refunds

Remote MCP server (mcp.sandbox.paypal.com)

Optional route for dashboard-agent PayPal tools

Transaction search

Dashboard enrichment

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients such as Claude Desktop to request spending permission, search and view products, complete checkouts, and check spending status, while every payment is validated against the user's configured guardrails before it reaches PayPal.
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Exposes an owner-reviewed, server-validated merchant catalog as MCP shopping tools that let an agent fetch store details, search products, check availability, build a cart, and start a checkout that hands a capability-protected link to a human for PayPal sandbox approval. Pricing, inventory, discounts and payee remain server-owned, and no capture, refund or publication tools are exposed.
      6 npm
      MIT