AisleNode Local Commerce (Meta Muse & Claude MCP)

muse-commerce-mcp

Open-source Model Context Protocol (MCP) bridge connecting Meta Muse, Llama, and Anthropic Claude agents to live neighborhood retail store shelves.

---

Why This Exists

Autonomous AI shopping agents (Meta Muse, Claude, Llama) can search global e-commerce giants, but neighborhood brick-and-mortar shops remain invisible to them. Traditional local stores cannot afford expensive POS integrations or give up 30% commissions to delivery marketplaces.

`muse-commerce-mcp` bridges conversational AI agents directly to verified local retail inventories via the AisleNode Protocol:

• Real-Time Geofenced Discovery: Query in-stock products across physically audited neighborhood stores using Haversine GPS radius filtering.
• Zero-PII Agent Reservation: Agents reserve items and generate a secure checkout handoff link without handling sensitive shopper credit cards or home addresses inside the LLM context.
• 100% Non-Custodial Direct Settlement: Shoppers pay the merchant directly via Stripe or PayPal. The protocol never touches or pools merchant revenue.
• Instant Counter & Courier Dispatch: Orders chime live on the merchant's counter web terminal and generate a thermal dispatch slip with an embedded Google Maps GPS QR code for local bike couriers.

---

Architecture

sequenceDiagram

participant Shopper participant Agent as Meta Muse / Claude Agent participant MCP as muse-commerce-mcp participant Hub as AisleNode Protocol participant Store as Local Merchant Counter

Shopper->>Agent: "Find fresh Arabica coffee beans near me under $20" Agent->>MCP: search_catalog(query="coffee", lat=40.756, lng=-73.988) MCP->>Hub: POST /api/mcp (Haversine Radius Search) Hub-->>Agent: Returns verified in-stock items + distance (0.8 km) Shopper->>Agent: "Order 1 bag from Soltrix Store" Agent->>MCP: create_order(store_id, items=[{product_id, qty: 1}]) Hub-->>Agent: Returns Zero-PII Checkout URL Shopper->>Store: Completes direct Stripe/PayPal payment & road-distance fee Store-->>Shopper: Prints GPS QR Courier Slip & dispatches local rider

---

Quick Start

1. Configure for Meta Muse / Claude Desktop

Add muse-commerce-mcp to your agent configuration file (claude_desktop_config.json or Meta Muse MCP config):

{

"mcpServers": { "muse-commerce": { "command": "npx", "args": ["-y", "muse-commerce-mcp"] } } }

2. Streamable HTTP Endpoint (Official MCP Registry & Remote Agents)

Connect directly to the hosted Streamable HTTP MCP server (io.github.marvo-bd/muse-commerce-mcp):

• Streamable HTTP / JSON-RPC Endpoint: https://aislenode.soltrixstudios.com/api/mcp
• Method: POST

Example: Search Local Inventory by GPS Radius

curl -X POST https://aislenode.soltrixstudios.com/api/mcp \

-H "Content-Type: application/json" \ -d '{ "action": "search_catalog", "params": { "query": "coffee", "customer_lat": 40.756076, "customer_lng": -73.988407, "max_distance_km": 15 } }'

---

Available MCP Tools

---

Example Agent Prompts

Once connected, test your agent with natural language queries:

• *"Search local stores within 10km of latitude 40.756, longitude -73.988 for Arabica coffee beans."*
• *"Create an order for 1 bag of Arabica Coffee Beans from that store and give me the checkout link."*
• *"Check the fulfillment status of order [order_id]."*

---

Onboard a Physical Retail Store

Are you a merchant or testing a full end-to-end physical counter workflow?

1. Visit [aislenode.soltrixstudios.com](https://aislenode.soltrixstudios.com)
2. Sign in with Google, pin your physical storefront GPS coordinates, and upload your CSV catalog.
3. Once verified, your shelves are immediately discoverable by every agent running muse-commerce-mcp.

---

License

MIT License. Built and maintained by Soltrix Studios.