# LOAM

AI-native commerce platform. Merchants describe what they sell — LOAM generates the brand, the storefront, the product copy, and handles payments. Every store is provisioned with its own database, its own Stripe Connect account, and its own brand. Built on Medusa v2. The Shopify alternative built for AI-shoppable retail.

## What LOAM is for

- Founders launching a brand without a designer + developer + agency.
- Existing merchants who want a clean break from Shopify-app sprawl.
- AI-shoppable retail: every store on LOAM exposes machine-readable surfaces from day one, so agents (ChatGPT, Claude, Perplexity, store-built assistants) can discover, browse, and transact.

## How LOAM compares

- vs Shopify: AI-generated storefront and brand from a description, not a manual setup. Per-tenant database isolation by default. Native MCP + llms.txt on every store.
- vs Framer / Webflow: real commerce primitives (Medusa v2 cart, checkout, fulfilment, Stripe Connect) — not a visual website builder bolted to a third-party payment widget.
- vs marketplaces (Etsy, Amazon): merchants own their brand, their domain, their data, and their customer relationship. LOAM hosts; it does not aggregate.

## Platform endpoints (served at loam.st)

- Marketing site: https://loam.st/
- Themes gallery: https://loam.st/themes
- Feature page (Describe): https://loam.st/describe
- Blog: https://loam.st/blog
- API catalog: https://loam.st/.well-known/api-catalog
- Auth metadata: https://loam.st/.well-known/oauth-protected-resource
- Platform MCP card: https://loam.st/.well-known/mcp/server-card.json
- Platform MCP endpoint: https://loam.st/api/mcp (cross-tenant: find_stores, get_store, browse_themes)
- Health: https://loam.st/api/health
- Sitemap: https://loam.st/sitemap.xml

## Per-tenant endpoints (served at each store's host, e.g. https://yuzu.loam.st)

These exist on individual storefront subdomains (or merchant custom domains), NOT on loam.st itself. Resolve the host for a given store via the platform MCP `find_stores` / `get_store` tools, or `GET https://loam.st/api/tenants/by-host?host=<hostname>`.

- `https://{store-host}/.well-known/api-catalog` — RFC 9727 linkset
- `https://{store-host}/.well-known/openapi.json` — OpenAPI 3.1 for the storefront API
- `https://{store-host}/.well-known/mcp/server-card.json` — SEP-1649 MCP server card (per-store)
- `https://{store-host}/.well-known/agent-skills/index.json` — Cloudflare RFC v0.2 skills index
- `https://{store-host}/.well-known/oauth-protected-resource` — RFC 9728 auth metadata
- `https://{store-host}/api/mcp` — JSON-RPC 2.0 MCP endpoint scoped to that store
- `https://{store-host}/llms.txt` — plain-text manifest authored against the merchant's brand

## Policy

- Operated by Fernway Group Ltd.
- Agent-driven traffic is welcome at the rate limits declared on each storefront.
- Contact: hello@loam.st