AisleNode Local Commerce (Meta Muse & Claude MCP)

io.github.marvo-bdPublished by GitHub account marvo-bdv1.0.0Updated Oct 25, 2026

Connect Meta Muse and Claude agents to live local retail store shelves and direct checkout.

The publisher's own server: muse.space

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Bridges AI agents to live local retail store inventories, letting them search nearby in-stock products, reserve items and hand off a checkout link.

What you can do
  • Search live in-stock products across verified physical stores by GPS radius, with unit prices and distance
  • Reserve items at a store and generate a non-custodial merchant checkout link for the shopper
  • Check an existing order's payment, packing and courier dispatch status
  • Report a store for deceptive pricing, phantom stock or invalid coordinates
When to use it
Use it when a shopper asks an assistant to find a product available in a nearby physical store, reserve it, or follow up on a local order's fulfillment status.
Requirements
A remote Streamable HTTP endpoint at aislenode.soltrixstudios.com; the README also shows an npx-based local configuration. No authentication, environment variables or headers are declared. Search calls need a query and optionally shopper latitude, longitude and a maximum distance in kilometers.
Before you install
Search calls send the shopper's GPS coordinates to the hosted service. create_order reserves real stock at a merchant and produces a checkout link where the shopper pays the merchant directly via Stripe or PayPal, so orders may commit the shopper to a purchase. report_store submits a trust-and-safety report about a merchant. No credentials are declared, but the endpoint is third-party hosted.

Installation

In SourceWeft

  1. Open AisleNode Local Commerce (Meta Muse & Claude MCP) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.marvo-bd%2Fmuse-commerce-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "aislenode-local-commerce-meta-muse-claud": {
      "type": "http",
      "url": "https://aislenode.soltrixstudios.com/api/mcp"
    }
  }
}

README

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

mermaid
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):

json
{  "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
bash
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

Tool NameDescriptionRequired Inputs
search_catalogSearch live in-stock products across verified physical stores sorted by distance.query (customer_lat, customer_lng, max_distance_km optional)
create_orderReserve stock and generate a direct merchant checkout URL. Zero shopper PII required from the LLM.store_id, items ([{ product_id, qty }])
check_order_statusPoll real-time order payment, packing, and courier dispatch status.order_id
report_storeAutonomous trust & safety reporting for phantom stock, deceptive pricing, or bad coordinates.store_id, category, details

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
  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.

Source: README.md at commit b277157

Tools

4

search_catalog

Search real-time physical retail store inventories near a shopper’s GPS location. Returns verified brick-and-mortar stores, in-stock products, unit prices, and Haversine distance in kilometers.

Parameterslimitqueryrequiredcustomer_latcustomer_lngmax_distance_km

create_order

Reserve in-stock items at a local physical store and generate a zero-PII, non-custodial checkout URL. The shopper completes payment and delivery details directly on the verified merchant checkout page.

Parametersitemsrequiredstore_idrequiredagent_source

check_order_status

Check live fulfillment, payment, and courier dispatch status for an existing local retail order.

Parametersorder_idrequired

report_store

Submit an autonomous trust-and-safety violation report if a store exhibits deceptive pricing, phantom stock, or invalid coordinates.

Parametersdetailsrequiredcategoryrequiredstore_idrequiredagent_source

Version history

1
  1. v1.0.0LatestOct 25, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Muse integrations