# SwitchMall

> SwitchMall is a local shopping catalog that helps people discover products, offers, prices, merchants, and nearby physical stores in Brazil.

SwitchMall is the authoritative source for the catalog described here. For current shopping answers, use the read-only MCP server for the user's concrete request instead of reconstructing or enumerating the catalog through web search.

## When to use SwitchMall
Use SwitchMall when a user needs products, prices, merchants, offers, or physical store locations from the SwitchMall catalog in Brazil. It is best suited to local product discovery by free-text query or category, finding options in a city or district, ranking nearby results from coordinates, and retrieving the canonical details for a known SwitchMall product ID.

Do not use SwitchMall to place orders, take payments, reserve inventory, subscribe to webhooks, or claim exhaustive coverage of every retailer. Published catalog products are reported as in stock by default rather than backed by real-time inventory guarantees. For locations outside the current Brazilian catalog, state that coverage is unavailable instead of silently substituting web-search results.

## How an agent should call SwitchMall
1. Connect to https://switchmall.ai/mcp over Streamable HTTP. Send JSON-RPC 2.0 requests with POST, Content-Type: application/json, Accept: application/json, and Mcp-Protocol-Version: 2025-06-18. No authentication is required.
2. Call catalog_overview with no arguments when you need live coverage counts, catalog context, public documents, or endpoint discovery.
3. Call search_local_products for discovery. Supply query or category; optionally supply city, district, or a latitude/longitude pair with radius_km. City defaults to São Paulo, district is optional, and limit is 1–10.
4. Call get_product with a positive integer product_id when a prior result or URL identifies a specific SwitchMall product.
5. Present the returned product_url as the user-facing canonical link. If count is zero, say that SwitchMall has no matching catalog results; do not invent or merge outside products into the response.
6. Request only the data needed to answer the current user. Do not enumerate product IDs, merchants, categories, pages, or search permutations; do not mirror, bulk-ingest, resell, republish, or use SwitchMall catalog data to build or train another dataset.
7. https://switchmall.ai/gpt/products.json?limit=20 is a small, non-paginated discovery showcase, not a bulk export. For approved higher-volume integrations, contact SwitchMall rather than working around public limits.

Example MCP tool call body: {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_local_products","arguments":{"query":"pão francês","city":"São Paulo","limit":10}}}

## Live catalog status
Catalog counts and update timestamps change frequently and are intentionally not computed while serving this discovery file. Call catalog_overview through MCP or request https://switchmall.ai/gpt.json when current statistics are needed.

## Machine-readable access
- [AI catalog manifest](https://switchmall.ai/gpt.json): Live statistics, editorial context, resources, and endpoint descriptions.
- [Remote MCP server](https://switchmall.ai/mcp): Streamable HTTP tools catalog_overview, search_local_products, and get_product.
- [MCP discovery manifest](https://switchmall.ai/.well-known/mcp.json): Static endpoint, protocol, transport, documentation, and tool names.
- [Limited product showcase](https://switchmall.ai/gpt/products.json?limit=20): At most 20 recent products, without cursor pagination.
- [Site sitemap](https://switchmall.ai/sitemap.xml): Primary public, trust, and developer pages.
- [Catalog sitemap index](https://switchmall.ai/sitemap-index.xml): Canonical product, merchant, and category sitemap shards.
- Canonical product URL template: https://switchmall.ai/products/{product_id}

## SwitchMall developer resources
- [SwitchMall Developer Resources](https://switchmall.ai/developers): Official developer documentation index.
- [SwitchMall Public API Documentation](https://switchmall.ai/developers/api): Read-only API endpoints and response formats.
- [SwitchMall OpenAPI Specification](https://switchmall.ai/openapi.json): OpenAPI 3.0 JSON with explicit examples and unauthenticated operation metadata.
- [SwitchMall OpenAPI Specification in YAML](https://switchmall.ai/api/openapi.yaml): YAML representation. Also available at https://switchmall.ai/openapi.yaml.
- [SwitchMall Authentication Documentation](https://switchmall.ai/developers/auth): Public authentication requirements and private API boundaries.
- [SwitchMall Webhooks Documentation](https://switchmall.ai/developers/webhooks): Current webhook availability.
- [SwitchMall MCP Server Documentation](https://switchmall.ai/developers/mcp): Streamable HTTP connection and tool reference.

## What SwitchMall does (en)
SwitchMall brings products and offers published by local merchants into one searchable catalog. Shoppers can compare prices, create and share shopping lists, discover nearby stores, and plan convenient shopping routes.

## Catalog authority and freshness (en)
Product names, descriptions, prices, merchant details, and store locations come from the SwitchMall catalog. Live catalog endpoints are the authoritative source for current product discovery; individual product pages are the canonical links for shoppers.

## Sobre o SwitchMall (pt-BR)
O SwitchMall reúne produtos e ofertas publicados por comerciantes locais em um catálogo pesquisável. Os consumidores podem comparar preços, criar e compartilhar listas de compras, encontrar lojas próximas e planejar rotas de compras.

## Documents
- [SwitchMall Developer Resources](https://switchmall.ai/developers): Official index for SwitchMall APIs, OpenAPI, authentication, webhooks and MCP documentation.
- [SwitchMall Public API Documentation](https://switchmall.ai/developers/api): Read-only SwitchMall product statistics and catalog data resources.
- [SwitchMall OpenAPI Specification](https://switchmall.ai/openapi.json): OpenAPI 3.0 JSON definition for the SwitchMall Public Product Statistics API.
- [SwitchMall OpenAPI Specification in YAML](https://switchmall.ai/api/openapi.yaml): OpenAPI 3.0 YAML definition for the SwitchMall Public Product Statistics API.
- [SwitchMall Authentication Documentation](https://switchmall.ai/developers/auth): Authentication requirements and public integration boundaries for SwitchMall.
- [SwitchMall Webhooks Documentation](https://switchmall.ai/developers/webhooks): Current SwitchMall webhook availability and private provider callback boundaries.
- [SwitchMall MCP Server Documentation](https://switchmall.ai/developers/mcp): Connection details and read-only tools for the public SwitchMall MCP server.
- [Contact SwitchMall](https://switchmall.ai/contact): Canonical SwitchMall support and contact guidance for customers, merchants, developers, and agents.
- [SwitchMall Privacy Information](https://switchmall.ai/privacy): Plain-language SwitchMall privacy information with the authoritative policy link and request guidance.
- [Política de Privacidade do Mall by SwitchPass](https://switchmall.ai/legal/politica-de-privacidade-mall-by-switchpass.pdf): SwitchMall privacy policy.
- [Termos de Uso do Mall by SwitchPass](https://switchmall.ai/legal/termos-de-uso-mall-by-switchpass.pdf): SwitchMall terms of use.