Which integrations are available for this server?

Enables AI shopping agents to pay sellers through PayPal: Orders v2 checkout (create, capture, direct card), webhook signature verification for live order confirmation, agent attribution via custom_id, plus PayPal Agent Toolkit capabilities such as catalog products, shipment tracking, and refunds, with transaction search for dashboard enrichment.

How do I use AgentStall?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@AgentStall find handmade ceramic mugs and ask the seller if they ship to Canada" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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: ChopChop MCP Server

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Related MCP Connectors

cloziqOAuth
com.cloziq
Create your offers and launch AI Instagram DM sales agents from any MCP client, over OAuth.
Social Media Autonomous Agents AI & Machine Learning
1
https://mcp.cloziq.com/mcp
Agentic Shelf A
ai.agenticshelf
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
E-commerce & Retail Search
2
https://api.agenticshelf.ai/mcp
MeetMyAgentOAuth
io.studiomeyer
Turn your offers into an AI agent. Set it up from your MCP assistant, answer customer questions, collect enquiries and connect with other agents via A2A. OAuth sign-in; free plan available.
Agent Orchestration Customer Support E-commerce & Retail
2
https://meetmyagent.io/mcp
AdvocateMCP A
com.advocatemcp
MCP layer for local businesses: discover, query, book, and transact with verified SMB AI agents.
Search E-commerce & Retail AI & Machine Learning
1821
https://api.advocatemcp.com/mcp

Related MCP Servers

E-Commerce MCP Server
E-commerce & Retail Payments & Billing
bhavik-dreamz
F
license
Not graded
quality
D
maintenance
Enables AI assistants to manage products, shopping carts, and orders in an online store through a well-defined MCP API.
Updated 8 months ago (2026-02-15 13:13 UTC)
-
ChopChop MCP Server
E-commerce & Retail Databases
coder01128
A
license
A
quality
C
maintenance
Enables AI agents to query tenants, browse catalogue items with pricing, pull recent orders, and add products through the MCP tool-calling interface.
Updated 2 months ago (2026-09-08 10:55 UTC)
4
MIT
AgentMall
E-commerce & Retail Payments & Billing Autonomous Agents
opc007
A
license
Not graded
quality
B
maintenance
Enables AI agents to search, compare, and create orders for daily consumer goods through MCP, with a handoff checkout flow where users complete payment themselves.
Updated 23 days ago (2026-10-08 11:08 UTC)
MIT
paypal-agent-store
E-commerce & Retail Payments & Billing
ttimesai-star
A
license
Not graded
quality
B
maintenance
Enables external AI agents to search a PayPal sandbox storefront, create and track orders, request refunds, and open disputes within buyer-set spending mandates, while every charge still requires buyer approval in PayPal.
Updated 15 days ago (2026-10-16 15:53 UTC)
MIT