Koskamo

muse-commerce-mcp

An open-source Model Context Protocol bridge that connects AI agents like Meta Muse and Claude to live physical retail inventories. It enables agents to search local stock by GPS radius, generate non-custodial checkout URLs for direct merchant payment, and trigger instant courier dispatch with GPS QR codes.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

muse-commerce-mcp logo, by marvo-bdCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by marvo-bd
MCP endpoint (Streamable HTTP)
https://aislenode.soltrixstudios.com/api/mcp
Vendor documentation

What you can do with it

  • Search live in-stock products across verified physical stores sorted by distance
  • Reserve stock and generate a direct merchant checkout URL with zero shopper PII
  • Poll real-time order payment, packing, and courier dispatch status
  • Report phantom stock, deceptive pricing, or bad coordinates for trust and safety

Source and maintenance

Community listingRegistry 1.0.0
Maintenance checked

Protocol and capabilities

Server
muse-commerce-mcp 1.0.0
MCP protocol
2024-11-05
Tools
4 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Tools

4 advertised

search_catalog
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

search_catalog input schema
{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "default": 10,
      "description": "Maximum number of matching products to return (default: 10)"
    },
    "query": {
      "type": "string",
      "description": "Product name, category, or keyword (e.g. \"coffee\", \"milk\", \"usb cable\")"
    },
    "customer_lat": {
      "type": "number",
      "description": "Shopper latitude coordinate for proximity ranking (optional)"
    },
    "customer_lng": {
      "type": "number",
      "description": "Shopper longitude coordinate for proximity ranking (optional)"
    },
    "max_distance_km": {
      "type": "number",
      "default": 15,
      "description": "Maximum search radius in kilometers (default: 15)"
    }
  }
}
search_catalog annotations
{
  "title": "Search Local Store Catalog",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
create_order
Advertised by the server during the last successful anonymous check.
Open-world

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.

create_order input schema
{
  "type": "object",
  "required": [
    "store_id",
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "product_id",
          "qty"
        ],
        "properties": {
          "qty": {
            "type": "number",
            "description": "Quantity to order (positive integer)"
          },
          "product_id": {
            "type": "string",
            "description": "UUID of the product from search_catalog"
          }
        }
      },
      "description": "Array of products and quantities to reserve"
    },
    "store_id": {
      "type": "string",
      "description": "UUID of the verified physical store"
    },
    "agent_source": {
      "type": "string",
      "default": "meta_muse",
      "description": "Identifier of the calling AI agent (e.g. \"meta_muse\", \"claude_desktop\")"
    }
  }
}
create_order annotations
{
  "title": "Create Local Order Reservation",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
check_order_status
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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

check_order_status input schema
{
  "type": "object",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "description": "UUID of the order to inspect"
    }
  }
}
check_order_status annotations
{
  "title": "Check Order Fulfillment Status",
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
report_store
Advertised by the server during the last successful anonymous check.
Open-world

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

report_store input schema
{
  "type": "object",
  "required": [
    "store_id",
    "category",
    "details"
  ],
  "properties": {
    "details": {
      "type": "string",
      "description": "Detailed explanation of the discrepancy observed by the agent or user"
    },
    "category": {
      "enum": [
        "illegal_goods",
        "deceptive_pricing",
        "fake_location",
        "harassment",
        "other"
      ],
      "type": "string",
      "description": "Violation category"
    },
    "store_id": {
      "type": "string",
      "description": "UUID of the store being reported"
    },
    "agent_source": {
      "type": "string",
      "default": "meta_muse",
      "description": "Identifier of the reporting AI agent"
    }
  }
}
report_store annotations
{
  "title": "Report Store Policy Violation",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
629 ms
95th percentile latency
629 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 629 ms · metadata changed · 4 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http muse-commerce-mcp https://aislenode.soltrixstudios.com/api/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add muse-commerce-mcp --url https://aislenode.soltrixstudios.com/api/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable muse-commerce-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "muse-commerce-mcp": {
      "url": "https://aislenode.soltrixstudios.com/api/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "muse-commerce-mcp": {
      "type": "streamableHttp",
      "url": "https://aislenode.soltrixstudios.com/api/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start muse-commerce-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "muse-commerce-mcp": {
      "type": "http",
      "url": "https://aislenode.soltrixstudios.com/api/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http muse-commerce-mcp https://aislenode.soltrixstudios.com/api/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "muse-commerce-mcp": {
      "url": "https://aislenode.soltrixstudios.com/api/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "muse-commerce-mcp": {
      "serverUrl": "https://aislenode.soltrixstudios.com/api/mcp"
    }
  }
}

Let your agent find its tools

Find servers like muse-commerce-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.