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

... View full README on GitHub