muse-commerce-mcp
Open-source Model Context Protocol (MCP) bridge connecting Meta Muse, Llama, and Anthropic Claude agents to live neighborhood retail store shelves.
[Protocol: AisleNode]
[Official MCP Registry]
[Glama MCP Score]
[M8ven Verified]
[License: MIT]
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
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):
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
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?
- Visit aislenode.soltrixstudios.com
- Sign in with Google, pin your physical storefront GPS coordinates, and upload your CSV catalog.
- Once verified, your shelves are immediately discoverable by every agent running
muse-commerce-mcp.
License
MIT License. Built and maintained by Soltrix Studios.