# Limowo
Marketplace project for buying, selling, gifting, and reuse across Switzerland.

Public zero-fee marketplace resources: [Marketplace in Switzerland](/en/swiss-marketplace), [online marketplace Switzerland](/en/online-marketplace-switzerland), [Swiss marketplace](/en/local-marketplace-switzerland), [free classifieds Switzerland](/en/free-classifieds-switzerland), [buy and sell in Switzerland](/en/buy-sell-switzerland), [second-hand marketplace](/en/second-hand), [sell online in Switzerland](/en/sell-online-switzerland), [free listings](/en/free-listings), [zero-fee listings](/en/zero-fees), and [fees](/en/fees) explain ordinary Limowo marketplace listings, CHF pricing boundaries, and project/payment details.

Active public listing pages, business shops, and curated category collections are crawlable. For exact, current marketplace discovery, use the public category lookup, listing-search, and business-shop search tools instead of inferring inventory from HTML or search-engine results.

## Agent entrypoints

- [Agent documentation](/en/agents) - human-readable integration documentation
- [MCP connection guide](/en/agents/connect) - official client connection, Keycloak OAuth, and safety guide
- [Agent terminal](/en/agents/terminal) - restricted browser command terminal
- [Agent manifest](/.well-known/limowo-agent.json) - machine manifest
- [MCP readiness status](/.well-known/limowo-mcp.json) - machine-readable availability and safety boundaries for hosted MCP
- [MCP registry manifest](/mcp-server.json) - official remote-server metadata prepared for MCP Registry publication
- [Hosted MCP endpoint](/mcp) - Streamable HTTP endpoint
- [MCP OAuth protected-resource metadata](/.well-known/oauth-protected-resource/mcp) - OAuth discovery for authenticated MCP tools
- [Agent OpenAPI contract](/api/agent/v1/openapi.json) - live OpenAPI contract
- [Agent command catalog](/api/agent/v1/commands) - live command catalog

## Connect an AI tool

- Codex: `codex mcp add limowo --url https://mcp.limowo.ch/mcp`
- Claude Code: `claude mcp add --transport http limowo https://mcp.limowo.ch/mcp`
- ChatGPT: create a custom app, add `https://mcp.limowo.ch/mcp`, choose OAuth with Dynamic Client Registration, then use the `limowo-mcp` scope and the same URL as the resource.
- Other MCP clients: add `https://mcp.limowo.ch/mcp` as a Streamable HTTP server.

Public discovery tools work without credentials. Authenticated commerce tools require a Keycloak OAuth token with Limowo's dedicated MCP audience and scope, plus enabled server-side domain flags.

## Command workflow

1. Discover commands.
2. Prepare a typed command and inspect normalized input, risk, effects, warnings, and approval.
3. Execute only the unchanged prepared command.
4. Follow returned nextActions only when the requiredActor matches the current actor.

## Sell item from chat

Use this V1 flow when helping an owner sell an item:

1. Search comparable active Limowo listings with marketplace.articles.search.
2. Ask the owner for missing facts. Do not invent brand, model, condition, defects, price, location, or included accessories.
3. Prepare listing.draft.create only after delegated authorization with the required draft scope.
4. Route the owner to the returned HUMAN_OWNER review action. The owner must review and publish.

Public marketplace search is live. Delegated MCP is enabled for: listing drafts. Available write tools prepare exact commands before execution; publication, messages, and offer transitions require human approval. Agents cannot approve their own actions. Orders, checkout, payments, autonomous publication, autonomous messaging, autonomous negotiation, and account administration are unavailable. No shell, SQL, GraphQL, filesystem, or arbitrary network execution is exposed.

## Business shops

Public business shops use `/{locale}/shop/{shopSlug}`. Agents can use `business.shops.search`, `business.shops.get`, and `business.shops.listings.search` without credentials. When storefront MCP is enabled, an authenticated owner can list owned shops and prepare free shop creation or public-profile updates; human approval remains required because the chosen public name, URL, and description become visible immediately. A listing draft can target an owned business shop only with its validated `storeId`. A shop is not business-identity verified unless Limowo later marks it verified. Legacy `marketplace.shops.*` and `store.*` command names remain REST-compatible but are deprecated and are not advertised through MCP.